@itwin/core-common 3.4.4 → 3.4.6

package/lib/cjs/ContextRealityModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContextRealityModel.js","sourceRoot":"","sources":["../../src/ContextRealityModel.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module DisplayStyles\n */\n\nimport { assert, BeEvent } from \"@itwin/core-bentley\";\nimport { FeatureAppearance, FeatureAppearanceProps } from \"./FeatureSymbology\";\nimport { PlanarClipMaskMode, PlanarClipMaskProps, PlanarClipMaskSettings } from \"./PlanarClipMask\";\nimport { SpatialClassifierProps, SpatialClassifiers } from \"./SpatialClassification\";\n\n/** JSON representation of the blob properties for an OrbitGt property cloud.\n * @alpha\n */\nexport interface OrbitGtBlobProps {\n  rdsUrl?: string;\n  containerName: string;\n  blobFileName: string;\n  sasToken: string;\n  accountName: string;\n}\n\n/** Identify the Reality Data service provider\n * @beta\n */\nexport enum RealityDataProvider {\n  /**\n   * This is the legacy mode where the access to the 3d tiles is harcoded in ContextRealityModelProps.tilesetUrl property.\n   * It was use to support RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles\n   * You should use other mode when possible\n   * @see [[RealityDataSource.createKeyFromUrl]] that will try to detect provider from an URL\n   */\n  TilesetUrl = \"TilesetUrl\",\n  /**\n   * This is the legacy mode where the access to the 3d tiles is harcoded in ContextRealityModelProps.OrbitGtBlob property.\n   * It was use to support OrbitPointCloud (OPC) from other server than ContextShare\n   * You should use other mode when possible\n   * @see [[RealityDataSource.createKeyFromOrbitGtBlobProps]] that will try to detect provider from an URL\n   */\n  OrbitGtBlob = \"OrbitGtBlob\",\n  /**\n   * Will provide access url from realityDataId and iTwinId on contextShare for 3dTile storage format or  OPC storage format\n   * This provider support all type of 3dTile storage fomat and OrbitPointCloud: RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles, OPC\n   * @see [[RealityDataFormat]].\n   */\n  ContextShare = \"ContextShare\",\n  /**\n   * Will provide Open Street Map Building (OSM) from Cesium Ion (in 3dTile format)\n   */\n  CesiumIonAsset = \"CesiumIonAsset\",\n}\n\n/** Identify the Reality Data storage format\n * @beta\n */\nexport enum RealityDataFormat {\n  /**\n   * 3dTile supported formats; RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles\n   * */\n  ThreeDTile = \"ThreeDTile\",\n  /**\n   * Orbit Point Cloud (OPC) storage format (RealityDataType.OPC)\n  */\n  OPC = \"OPC\",\n}\n\n/** Utility function for RealityDataFormat\n * @beta\n */\nexport namespace RealityDataFormat {\n  /**\n   * Try to extract the RealityDataFormat from the url\n   * @param tilesetUrl the reality data attachment url\n   * @returns the extracted RealityDataFormat or ThreeDTile by default if not found\n   */\n  export function fromUrl(tilesetUrl: string): RealityDataFormat {\n    let format = RealityDataFormat.ThreeDTile;\n    if (tilesetUrl.includes(\".opc\"))\n      format = RealityDataFormat.OPC;\n    return format;\n  }\n}\n\n/**\n * Key used by RealityDataSource to identify provider and reality data format\n * This key identify one and only one reality data source on the provider\n * @beta\n */\nexport interface RealityDataSourceKey {\n  /**\n   * The provider that supplies the access to reality data source for displaying the reality model\n   * @see [[RealityDataProvider]] for default supported value;\n  */\n  provider: string;\n  /**\n   * The format used by the provider to store the reality data\n   * @see [[RealityDataFormat]] for default supported value;\n  */\n  format: string;\n  /** The reality data id that identify a reality data for the provider */\n  id: string;\n  /** The context id that was used when reality data was attached - if none provided, current session iTwinId will be used */\n  iTwinId?: string;\n}\n/**\n * RealityDataSourceKey utility functions\n * @beta */\nexport namespace RealityDataSourceKey {\n  /** Utility function to convert a RealityDataSourceKey into its string representation */\n  export function convertToString(rdSourceKey: RealityDataSourceKey): string {\n    return `${rdSourceKey.provider}:${rdSourceKey.format}:${rdSourceKey.id}:${rdSourceKey?.iTwinId}`;\n  }\n  /** Utility function to compare two RealityDataSourceKey, we consider it equal even if itwinId is different */\n  export function isEqual(key1: RealityDataSourceKey, key2: RealityDataSourceKey): boolean {\n    if ((key1.provider === RealityDataProvider.CesiumIonAsset) && key2.provider === RealityDataProvider.CesiumIonAsset)\n      return true; // ignore other properties for CesiumIonAsset, id is hidden\n    if ((key1.provider === key2.provider) && (key1.format === key2.format) && (key1.id === key2.id)) {\n      // && (key1?.iTwinId === key2?.iTwinId)) -> ignore iTwinId, consider it is the same reality data\n      return true;\n    }\n    return false;\n  }\n}\n\n/** JSON representation of the reality data reference attachment properties.\n * @beta\n*/\nexport interface RealityDataSourceProps {\n  /** The source key that identify a reality data for the provider. */\n  sourceKey: RealityDataSourceKey;\n}\n\n/** JSON representation of a [[ContextRealityModel]].\n * @public\n * @extensions\n */\nexport interface ContextRealityModelProps {\n  /** See [[ContextRealityModel.rdSourceKey]].\n   * @beta\n   */\n  rdSourceKey?: RealityDataSourceKey;\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\n  tilesetUrl: string;\n  /** See [[ContextRealityModel.orbitGtBlob]].\n   * @alpha\n   */\n  orbitGtBlob?: OrbitGtBlobProps;\n  /** See [[ContextRealityModel.realityDataId]]. */\n  realityDataId?: string;\n  /** An optional, user-friendly name for the reality model suitable for display in a user interface. */\n  name?: string;\n  /** An optional, user-friendly description of the reality model suitable for display in a user interface. */\n  description?: string;\n  /** See [[ContextRealityModel.classifiers]]. */\n  classifiers?: SpatialClassifierProps[];\n  /** See [[ContextRealityModel.planarClipMask]]. */\n  planarClipMask?: PlanarClipMaskProps;\n  /** See [[ContextRealityModel.appearanceOverrides]]. */\n  appearanceOverrides?: FeatureAppearanceProps;\n}\n\n/** @public */\nexport namespace ContextRealityModelProps {\n  /** Produce a deep copy of `input`. */\n  export function clone(input: ContextRealityModelProps) {\n    // Spread operator is shallow, and includes `undefined` properties and empty strings.\n    // We want to make deep copies, omit undefined properties and empty strings, and require tilesetUrl to be defined.\n    const output: ContextRealityModelProps = { tilesetUrl: input.tilesetUrl ?? \"\" };\n\n    if (input.rdSourceKey)\n      output.rdSourceKey = { ...input.rdSourceKey };\n\n    if (input.name)\n      output.name = input.name;\n\n    if (input.realityDataId)\n      output.realityDataId = input.realityDataId;\n\n    if (input.description)\n      output.description = input.description;\n\n    if (input.orbitGtBlob)\n      output.orbitGtBlob = { ...input.orbitGtBlob };\n\n    if (input.appearanceOverrides) {\n      output.appearanceOverrides = { ...input.appearanceOverrides };\n      if (input.appearanceOverrides.rgb)\n        output.appearanceOverrides.rgb = { ...input.appearanceOverrides.rgb };\n    }\n\n    if (input.planarClipMask)\n      output.planarClipMask = { ...input.planarClipMask };\n\n    if (input.classifiers)\n      output.classifiers = input.classifiers.map((x) => { return { ...x, flags: { ...x.flags } }; });\n\n    return output;\n  }\n}\n\n/** A reality model not associated with a [GeometricModel]($backend) but instead defined in a [DisplayStyle]($backend) or [DisplayStyleState]($frontend).\n * Such reality models are displayed to provide context to the view and can be freely attached and detached at display time.\n * @see [this interactive example](https://www.itwinjs.org/sample-showcase/?group=Viewer&sample=reality-data-sample)\n * @see [[DisplayStyleSettings.contextRealityModels]] to define context reality models for a display style.\n * @public\n */\nexport class ContextRealityModel {\n  /** @internal */\n  protected readonly _props: ContextRealityModelProps;\n  /**\n   * The reality data source key identify the reality data provider and storage format.\n   * It takes precedence over tilesetUrl and orbitGtBlob when present and can be use to actually replace these properties.\n   * @beta\n   */\n  public readonly rdSourceKey?: RealityDataSourceKey;\n  /** A name suitable for display in a user interface. By default, an empty string. */\n  public readonly name: string;\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\n  public readonly url: string;\n  /** A description of the model suitable for display in a user interface. By default, an empty string. */\n  public readonly description: string;\n  /** An optional identifier that, if present, can be used to elide a request to the reality data service. */\n  public readonly realityDataId?: string;\n  /** A set of [[SpatialClassifier]]s, of which one at any given time can be used to classify the reality model. */\n  public readonly classifiers?: SpatialClassifiers;\n  /** @alpha */\n  public readonly orbitGtBlob?: Readonly<OrbitGtBlobProps>;\n  protected _appearanceOverrides?: FeatureAppearance;\n  protected _planarClipMask?: PlanarClipMaskSettings;\n  /** Event dispatched just before assignment to [[planarClipMaskSettings]]. */\n  public readonly onPlanarClipMaskChanged = new BeEvent<(newSettings: PlanarClipMaskSettings | undefined, model: ContextRealityModel) => void>();\n  /** Event dispatched just before assignment to [[appearanceOverrides]]. */\n  public readonly onAppearanceOverridesChanged = new BeEvent<(newOverrides: FeatureAppearance | undefined, model: ContextRealityModel) => void>();\n\n  /** Construct a new context reality model.\n   * @param props JSON representation of the reality model, which will be kept in sync with changes made via the ContextRealityModel's methods.\n   */\n  public constructor(props: ContextRealityModelProps) {\n    this._props = props;\n    this.rdSourceKey = props.rdSourceKey;\n    this.name = props.name ?? \"\";\n    this.url = props.tilesetUrl ?? \"\";\n    this.orbitGtBlob = props.orbitGtBlob;\n    this.realityDataId = props.realityDataId;\n    this.description = props.description ?? \"\";\n    this._appearanceOverrides = props.appearanceOverrides ? FeatureAppearance.fromJSON(props.appearanceOverrides) : undefined;\n    if (props.planarClipMask && props.planarClipMask.mode !== PlanarClipMaskMode.None)\n      this._planarClipMask = PlanarClipMaskSettings.fromJSON(props.planarClipMask);\n\n    if (props.classifiers)\n      this.classifiers = new SpatialClassifiers(props);\n  }\n\n  /** Optionally describes how the geometry of the reality model can be masked by other models. */\n  public get planarClipMaskSettings(): PlanarClipMaskSettings | undefined {\n    return this._planarClipMask;\n  }\n  public set planarClipMaskSettings(settings: PlanarClipMaskSettings | undefined) {\n    this.onPlanarClipMaskChanged.raiseEvent(settings, this);\n    if (!settings)\n      delete this._props.planarClipMask;\n    else\n      this._props.planarClipMask = settings.toJSON();\n\n    this._planarClipMask = settings;\n  }\n\n  /** Overrides applied to the appearance of the reality model. Only the rgb, transparency, nonLocatable, and emphasized properties are applicable - the rest are ignored. */\n  public get appearanceOverrides(): FeatureAppearance | undefined {\n    return this._appearanceOverrides;\n  }\n  public set appearanceOverrides(overrides: FeatureAppearance | undefined) {\n    this.onAppearanceOverridesChanged.raiseEvent(overrides, this);\n    if (!overrides)\n      delete this._props.appearanceOverrides;\n    else\n      this._props.appearanceOverrides = overrides.toJSON();\n\n    this._appearanceOverrides = overrides;\n  }\n\n  /** Convert this model to its JSON representation. */\n  public toJSON(): ContextRealityModelProps {\n    return ContextRealityModelProps.clone(this._props);\n  }\n\n  /** Returns true if [[name]] and [[url]] match the specified name and url. */\n  public matchesNameAndUrl(name: string, url: string): boolean {\n    return this.name === name && this.url === url;\n  }\n}\n\n/** An object that can store the JSON representation of a list of [[ContextRealityModel]]s.\n * @see [[ContextRealityModels]].\n * @see [[DisplayStyleSettingsProps.contextRealityModels]].\n * @public\n * @extensions\n */\nexport interface ContextRealityModelsContainer {\n  /** The list of reality models. */\n  contextRealityModels?: ContextRealityModelProps[];\n}\n\n/** A list of [[ContextRealityModel]]s attached to a [[DisplayStyleSettings]]. The list may be presented to the user with the name and description of each model.\n * The list is automatically synchronized with the underlying JSON representation provided by the input [[ContextRealityModelsContainer]].\n * @see [this interactive example](https://www.itwinjs.org/sample-showcase/?group=Viewer&sample=reality-data-sample)\n * @see [[DisplayStyleSettings.contextRealityModels]].\n * @public\n */\nexport class ContextRealityModels {\n  private readonly _container: ContextRealityModelsContainer;\n  private readonly _createModel: (props: ContextRealityModelProps) => ContextRealityModel;\n  private readonly _models: ContextRealityModel[] = [];\n  /** Event dispatched just before [[ContextRealityModel.planarClipMaskSettings]] is modified for one of the reality models. */\n  public readonly onPlanarClipMaskChanged = new BeEvent<(model: ContextRealityModel, newSettings: PlanarClipMaskSettings | undefined) => void>();\n  /** Event dispatched just before [[ContextRealityModel.appearanceOverrides]] is modified for one of the reality models. */\n  public readonly onAppearanceOverridesChanged = new BeEvent<(model: ContextRealityModel, newOverrides: FeatureAppearance | undefined) => void>();\n  /** Event dispatched when a model is [[add]]ed, [[delete]]d, [[replace]]d, or [[update]]d. */\n  public readonly onChanged = new BeEvent<(previousModel: ContextRealityModel | undefined, newModel: ContextRealityModel | undefined) => void>();\n\n  /** Construct a new list of reality models from its JSON representation. THe list will be initialized from `container.classifiers` and that JSON representation\n   * will be kept in sync with changes made to the list. The caller should not directly modify `container.classifiers` or its contents as that will cause the list\n   * to become out of sync with the JSON representation.\n   * @param container The object that holds the JSON representation of the list.\n   * @param createContextRealityModel Optional function used to instantiate ContextRealityModels added to the list.\n   */\n  public constructor(container: ContextRealityModelsContainer, createContextRealityModel?: (props: ContextRealityModelProps) => ContextRealityModel) {\n    this._container = container;\n    this._createModel = createContextRealityModel ?? ((props) => new ContextRealityModel(props));\n\n    const models = container.contextRealityModels;\n    if (models)\n      for (const model of models)\n        this._models.push(this.createModel(model));\n  }\n\n  /** The read-only list of reality models. */\n  public get models(): ReadonlyArray<ContextRealityModel> {\n    return this._models;\n  }\n\n  /** Append a new reality model to the list.\n   * @param The JSON representation of the reality model.\n   * @returns the newly-added reality model.\n   */\n  public add(props: ContextRealityModelProps): ContextRealityModel {\n    if (!this._container.contextRealityModels)\n      this._container.contextRealityModels = [];\n\n    props = ContextRealityModelProps.clone(props);\n    const model = this.createModel(props);\n\n    this.onChanged.raiseEvent(undefined, model);\n\n    this._models.push(model);\n    this._container.contextRealityModels.push(props);\n\n    return model;\n  }\n\n  /** Remove the specified reality model from the list.\n   * @param model The reality model to remove.\n   * @returns true if the model was removed, or false if the model was not present in the list.\n   */\n  public delete(model: ContextRealityModel): boolean {\n    const index = this._models.indexOf(model);\n    if (-1 === index)\n      return false;\n\n    assert(undefined !== this._container.contextRealityModels);\n    assert(index < this._container.contextRealityModels.length);\n\n    this.dropEventListeners(model);\n    this.onChanged.raiseEvent(model, undefined);\n\n    this._models.splice(index, 1);\n    if (this.models.length === 0)\n      this._container.contextRealityModels = undefined;\n    else\n      this._container.contextRealityModels.splice(index, 1);\n\n    return true;\n  }\n\n  /** Remove all reality models from the list. */\n  public clear(): void {\n    for (const model of this.models) {\n      this.dropEventListeners(model);\n      this.onChanged.raiseEvent(model, undefined);\n    }\n\n    this._container.contextRealityModels = undefined;\n    this._models.length = 0;\n  }\n\n  /** Replace a reality model in the list.\n   * @param toReplace The reality model to be replaced.\n   * @param replaceWith The JSON representation of the replacement reality model.\n   * @returns the newly-created reality model that replaced `toReplace`.\n   * @throws Error if `toReplace` is not present in the list\n   * @note The replacement occupies the same index in the list as `toReplace` did.\n   */\n  public replace(toReplace: ContextRealityModel, replaceWith: ContextRealityModelProps): ContextRealityModel {\n    const index = this._models.indexOf(toReplace);\n    if (-1 === index)\n      throw new Error(\"ContextRealityModel not present in list.\");\n\n    assert(undefined !== this._container.contextRealityModels);\n    assert(index < this._container.contextRealityModels.length);\n\n    replaceWith = ContextRealityModelProps.clone(replaceWith);\n    const model = this.createModel(replaceWith);\n\n    this.onChanged.raiseEvent(toReplace, model);\n    this.dropEventListeners(toReplace);\n\n    this._models[index] = model;\n    this._container.contextRealityModels[index] = replaceWith;\n\n    return model;\n  }\n\n  /** Change selected properties of a reality model.\n   * @param toUpdate The reality model whose properties are to be modified.\n   * @param updateProps The properties to change.\n   * @returns The updated reality model, identical to `toUpdate` except for properties explicitly supplied by `updateProps`.\n   * @throws Error if `toUpdate` is not present in the list.\n   */\n  public update(toUpdate: ContextRealityModel, updateProps: Partial<ContextRealityModelProps>): ContextRealityModel {\n    const props = {\n      ...toUpdate.toJSON(),\n      ...updateProps,\n    };\n\n    // Partial<> makes it possible to pass `undefined` for tilesetUrl...preserve previous URL in that case.\n    if (undefined === props.tilesetUrl)\n      props.tilesetUrl = toUpdate.url;\n\n    return this.replace(toUpdate, props);\n  }\n\n  private createModel(props: ContextRealityModelProps): ContextRealityModel {\n    const model = this._createModel(props);\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    model.onPlanarClipMaskChanged.addListener(this.handlePlanarClipMaskChanged, this);\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    model.onAppearanceOverridesChanged.addListener(this.handleAppearanceOverridesChanged, this);\n    return model;\n  }\n\n  private dropEventListeners(model: ContextRealityModel): void {\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    model.onPlanarClipMaskChanged.removeListener(this.handlePlanarClipMaskChanged, this);\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    model.onAppearanceOverridesChanged.removeListener(this.handleAppearanceOverridesChanged, this);\n  }\n\n  private handlePlanarClipMaskChanged(mask: PlanarClipMaskSettings | undefined, model: ContextRealityModel): void {\n    this.onPlanarClipMaskChanged.raiseEvent(model, mask);\n  }\n\n  private handleAppearanceOverridesChanged(app: FeatureAppearance | undefined, model: ContextRealityModel): void {\n    this.onAppearanceOverridesChanged.raiseEvent(model, app);\n  }\n}\n"]}
+{"version":3,"file":"ContextRealityModel.js","sourceRoot":"","sources":["../../src/ContextRealityModel.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { assert, BeEvent } from \"@itwin/core-bentley\";\r\nimport { FeatureAppearance, FeatureAppearanceProps } from \"./FeatureSymbology\";\r\nimport { PlanarClipMaskMode, PlanarClipMaskProps, PlanarClipMaskSettings } from \"./PlanarClipMask\";\r\nimport { SpatialClassifierProps, SpatialClassifiers } from \"./SpatialClassification\";\r\n\r\n/** JSON representation of the blob properties for an OrbitGt property cloud.\r\n * @alpha\r\n */\r\nexport interface OrbitGtBlobProps {\r\n  rdsUrl?: string;\r\n  containerName: string;\r\n  blobFileName: string;\r\n  sasToken: string;\r\n  accountName: string;\r\n}\r\n\r\n/** Identify the Reality Data service provider\r\n * @beta\r\n */\r\nexport enum RealityDataProvider {\r\n  /**\r\n   * This is the legacy mode where the access to the 3d tiles is harcoded in ContextRealityModelProps.tilesetUrl property.\r\n   * It was use to support RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles\r\n   * You should use other mode when possible\r\n   * @see [[RealityDataSource.createKeyFromUrl]] that will try to detect provider from an URL\r\n   */\r\n  TilesetUrl = \"TilesetUrl\",\r\n  /**\r\n   * This is the legacy mode where the access to the 3d tiles is harcoded in ContextRealityModelProps.OrbitGtBlob property.\r\n   * It was use to support OrbitPointCloud (OPC) from other server than ContextShare\r\n   * You should use other mode when possible\r\n   * @see [[RealityDataSource.createKeyFromOrbitGtBlobProps]] that will try to detect provider from an URL\r\n   */\r\n  OrbitGtBlob = \"OrbitGtBlob\",\r\n  /**\r\n   * Will provide access url from realityDataId and iTwinId on contextShare for 3dTile storage format or  OPC storage format\r\n   * This provider support all type of 3dTile storage fomat and OrbitPointCloud: RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles, OPC\r\n   * @see [[RealityDataFormat]].\r\n   */\r\n  ContextShare = \"ContextShare\",\r\n  /**\r\n   * Will provide Open Street Map Building (OSM) from Cesium Ion (in 3dTile format)\r\n   */\r\n  CesiumIonAsset = \"CesiumIonAsset\",\r\n}\r\n\r\n/** Identify the Reality Data storage format\r\n * @beta\r\n */\r\nexport enum RealityDataFormat {\r\n  /**\r\n   * 3dTile supported formats; RealityMesh3DTiles, Terrain3DTiles, Cesium3DTiles\r\n   * */\r\n  ThreeDTile = \"ThreeDTile\",\r\n  /**\r\n   * Orbit Point Cloud (OPC) storage format (RealityDataType.OPC)\r\n  */\r\n  OPC = \"OPC\",\r\n}\r\n\r\n/** Utility function for RealityDataFormat\r\n * @beta\r\n */\r\nexport namespace RealityDataFormat {\r\n  /**\r\n   * Try to extract the RealityDataFormat from the url\r\n   * @param tilesetUrl the reality data attachment url\r\n   * @returns the extracted RealityDataFormat or ThreeDTile by default if not found\r\n   */\r\n  export function fromUrl(tilesetUrl: string): RealityDataFormat {\r\n    let format = RealityDataFormat.ThreeDTile;\r\n    if (tilesetUrl.includes(\".opc\"))\r\n      format = RealityDataFormat.OPC;\r\n    return format;\r\n  }\r\n}\r\n\r\n/**\r\n * Key used by RealityDataSource to identify provider and reality data format\r\n * This key identify one and only one reality data source on the provider\r\n * @beta\r\n */\r\nexport interface RealityDataSourceKey {\r\n  /**\r\n   * The provider that supplies the access to reality data source for displaying the reality model\r\n   * @see [[RealityDataProvider]] for default supported value;\r\n  */\r\n  provider: string;\r\n  /**\r\n   * The format used by the provider to store the reality data\r\n   * @see [[RealityDataFormat]] for default supported value;\r\n  */\r\n  format: string;\r\n  /** The reality data id that identify a reality data for the provider */\r\n  id: string;\r\n  /** The context id that was used when reality data was attached - if none provided, current session iTwinId will be used */\r\n  iTwinId?: string;\r\n}\r\n/**\r\n * RealityDataSourceKey utility functions\r\n * @beta */\r\nexport namespace RealityDataSourceKey {\r\n  /** Utility function to convert a RealityDataSourceKey into its string representation */\r\n  export function convertToString(rdSourceKey: RealityDataSourceKey): string {\r\n    return `${rdSourceKey.provider}:${rdSourceKey.format}:${rdSourceKey.id}:${rdSourceKey?.iTwinId}`;\r\n  }\r\n  /** Utility function to compare two RealityDataSourceKey, we consider it equal even if itwinId is different */\r\n  export function isEqual(key1: RealityDataSourceKey, key2: RealityDataSourceKey): boolean {\r\n    if ((key1.provider === RealityDataProvider.CesiumIonAsset) && key2.provider === RealityDataProvider.CesiumIonAsset)\r\n      return true; // ignore other properties for CesiumIonAsset, id is hidden\r\n    if ((key1.provider === key2.provider) && (key1.format === key2.format) && (key1.id === key2.id)) {\r\n      // && (key1?.iTwinId === key2?.iTwinId)) -> ignore iTwinId, consider it is the same reality data\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n}\r\n\r\n/** JSON representation of the reality data reference attachment properties.\r\n * @beta\r\n*/\r\nexport interface RealityDataSourceProps {\r\n  /** The source key that identify a reality data for the provider. */\r\n  sourceKey: RealityDataSourceKey;\r\n}\r\n\r\n/** JSON representation of a [[ContextRealityModel]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ContextRealityModelProps {\r\n  /** See [[ContextRealityModel.rdSourceKey]].\r\n   * @beta\r\n   */\r\n  rdSourceKey?: RealityDataSourceKey;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  tilesetUrl: string;\r\n  /** See [[ContextRealityModel.orbitGtBlob]].\r\n   * @alpha\r\n   */\r\n  orbitGtBlob?: OrbitGtBlobProps;\r\n  /** See [[ContextRealityModel.realityDataId]]. */\r\n  realityDataId?: string;\r\n  /** An optional, user-friendly name for the reality model suitable for display in a user interface. */\r\n  name?: string;\r\n  /** An optional, user-friendly description of the reality model suitable for display in a user interface. */\r\n  description?: string;\r\n  /** See [[ContextRealityModel.classifiers]]. */\r\n  classifiers?: SpatialClassifierProps[];\r\n  /** See [[ContextRealityModel.planarClipMask]]. */\r\n  planarClipMask?: PlanarClipMaskProps;\r\n  /** See [[ContextRealityModel.appearanceOverrides]]. */\r\n  appearanceOverrides?: FeatureAppearanceProps;\r\n}\r\n\r\n/** @public */\r\nexport namespace ContextRealityModelProps {\r\n  /** Produce a deep copy of `input`. */\r\n  export function clone(input: ContextRealityModelProps) {\r\n    // Spread operator is shallow, and includes `undefined` properties and empty strings.\r\n    // We want to make deep copies, omit undefined properties and empty strings, and require tilesetUrl to be defined.\r\n    const output: ContextRealityModelProps = { tilesetUrl: input.tilesetUrl ?? \"\" };\r\n\r\n    if (input.rdSourceKey)\r\n      output.rdSourceKey = { ...input.rdSourceKey };\r\n\r\n    if (input.name)\r\n      output.name = input.name;\r\n\r\n    if (input.realityDataId)\r\n      output.realityDataId = input.realityDataId;\r\n\r\n    if (input.description)\r\n      output.description = input.description;\r\n\r\n    if (input.orbitGtBlob)\r\n      output.orbitGtBlob = { ...input.orbitGtBlob };\r\n\r\n    if (input.appearanceOverrides) {\r\n      output.appearanceOverrides = { ...input.appearanceOverrides };\r\n      if (input.appearanceOverrides.rgb)\r\n        output.appearanceOverrides.rgb = { ...input.appearanceOverrides.rgb };\r\n    }\r\n\r\n    if (input.planarClipMask)\r\n      output.planarClipMask = { ...input.planarClipMask };\r\n\r\n    if (input.classifiers)\r\n      output.classifiers = input.classifiers.map((x) => { return { ...x, flags: { ...x.flags } }; });\r\n\r\n    return output;\r\n  }\r\n}\r\n\r\n/** A reality model not associated with a [GeometricModel]($backend) but instead defined in a [DisplayStyle]($backend) or [DisplayStyleState]($frontend).\r\n * Such reality models are displayed to provide context to the view and can be freely attached and detached at display time.\r\n * @see [this interactive example](https://www.itwinjs.org/sample-showcase/?group=Viewer&sample=reality-data-sample)\r\n * @see [[DisplayStyleSettings.contextRealityModels]] to define context reality models for a display style.\r\n * @public\r\n */\r\nexport class ContextRealityModel {\r\n  /** @internal */\r\n  protected readonly _props: ContextRealityModelProps;\r\n  /**\r\n   * The reality data source key identify the reality data provider and storage format.\r\n   * It takes precedence over tilesetUrl and orbitGtBlob when present and can be use to actually replace these properties.\r\n   * @beta\r\n   */\r\n  public readonly rdSourceKey?: RealityDataSourceKey;\r\n  /** A name suitable for display in a user interface. By default, an empty string. */\r\n  public readonly name: string;\r\n  /** The URL that supplies the 3d tiles for displaying the reality model. */\r\n  public readonly url: string;\r\n  /** A description of the model suitable for display in a user interface. By default, an empty string. */\r\n  public readonly description: string;\r\n  /** An optional identifier that, if present, can be used to elide a request to the reality data service. */\r\n  public readonly realityDataId?: string;\r\n  /** A set of [[SpatialClassifier]]s, of which one at any given time can be used to classify the reality model. */\r\n  public readonly classifiers?: SpatialClassifiers;\r\n  /** @alpha */\r\n  public readonly orbitGtBlob?: Readonly<OrbitGtBlobProps>;\r\n  protected _appearanceOverrides?: FeatureAppearance;\r\n  protected _planarClipMask?: PlanarClipMaskSettings;\r\n  /** Event dispatched just before assignment to [[planarClipMaskSettings]]. */\r\n  public readonly onPlanarClipMaskChanged = new BeEvent<(newSettings: PlanarClipMaskSettings | undefined, model: ContextRealityModel) => void>();\r\n  /** Event dispatched just before assignment to [[appearanceOverrides]]. */\r\n  public readonly onAppearanceOverridesChanged = new BeEvent<(newOverrides: FeatureAppearance | undefined, model: ContextRealityModel) => void>();\r\n\r\n  /** Construct a new context reality model.\r\n   * @param props JSON representation of the reality model, which will be kept in sync with changes made via the ContextRealityModel's methods.\r\n   */\r\n  public constructor(props: ContextRealityModelProps) {\r\n    this._props = props;\r\n    this.rdSourceKey = props.rdSourceKey;\r\n    this.name = props.name ?? \"\";\r\n    this.url = props.tilesetUrl ?? \"\";\r\n    this.orbitGtBlob = props.orbitGtBlob;\r\n    this.realityDataId = props.realityDataId;\r\n    this.description = props.description ?? \"\";\r\n    this._appearanceOverrides = props.appearanceOverrides ? FeatureAppearance.fromJSON(props.appearanceOverrides) : undefined;\r\n    if (props.planarClipMask && props.planarClipMask.mode !== PlanarClipMaskMode.None)\r\n      this._planarClipMask = PlanarClipMaskSettings.fromJSON(props.planarClipMask);\r\n\r\n    if (props.classifiers)\r\n      this.classifiers = new SpatialClassifiers(props);\r\n  }\r\n\r\n  /** Optionally describes how the geometry of the reality model can be masked by other models. */\r\n  public get planarClipMaskSettings(): PlanarClipMaskSettings | undefined {\r\n    return this._planarClipMask;\r\n  }\r\n  public set planarClipMaskSettings(settings: PlanarClipMaskSettings | undefined) {\r\n    this.onPlanarClipMaskChanged.raiseEvent(settings, this);\r\n    if (!settings)\r\n      delete this._props.planarClipMask;\r\n    else\r\n      this._props.planarClipMask = settings.toJSON();\r\n\r\n    this._planarClipMask = settings;\r\n  }\r\n\r\n  /** Overrides applied to the appearance of the reality model. Only the rgb, transparency, nonLocatable, and emphasized properties are applicable - the rest are ignored. */\r\n  public get appearanceOverrides(): FeatureAppearance | undefined {\r\n    return this._appearanceOverrides;\r\n  }\r\n  public set appearanceOverrides(overrides: FeatureAppearance | undefined) {\r\n    this.onAppearanceOverridesChanged.raiseEvent(overrides, this);\r\n    if (!overrides)\r\n      delete this._props.appearanceOverrides;\r\n    else\r\n      this._props.appearanceOverrides = overrides.toJSON();\r\n\r\n    this._appearanceOverrides = overrides;\r\n  }\r\n\r\n  /** Convert this model to its JSON representation. */\r\n  public toJSON(): ContextRealityModelProps {\r\n    return ContextRealityModelProps.clone(this._props);\r\n  }\r\n\r\n  /** Returns true if [[name]] and [[url]] match the specified name and url. */\r\n  public matchesNameAndUrl(name: string, url: string): boolean {\r\n    return this.name === name && this.url === url;\r\n  }\r\n}\r\n\r\n/** An object that can store the JSON representation of a list of [[ContextRealityModel]]s.\r\n * @see [[ContextRealityModels]].\r\n * @see [[DisplayStyleSettingsProps.contextRealityModels]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ContextRealityModelsContainer {\r\n  /** The list of reality models. */\r\n  contextRealityModels?: ContextRealityModelProps[];\r\n}\r\n\r\n/** A list of [[ContextRealityModel]]s attached to a [[DisplayStyleSettings]]. The list may be presented to the user with the name and description of each model.\r\n * The list is automatically synchronized with the underlying JSON representation provided by the input [[ContextRealityModelsContainer]].\r\n * @see [this interactive example](https://www.itwinjs.org/sample-showcase/?group=Viewer&sample=reality-data-sample)\r\n * @see [[DisplayStyleSettings.contextRealityModels]].\r\n * @public\r\n */\r\nexport class ContextRealityModels {\r\n  private readonly _container: ContextRealityModelsContainer;\r\n  private readonly _createModel: (props: ContextRealityModelProps) => ContextRealityModel;\r\n  private readonly _models: ContextRealityModel[] = [];\r\n  /** Event dispatched just before [[ContextRealityModel.planarClipMaskSettings]] is modified for one of the reality models. */\r\n  public readonly onPlanarClipMaskChanged = new BeEvent<(model: ContextRealityModel, newSettings: PlanarClipMaskSettings | undefined) => void>();\r\n  /** Event dispatched just before [[ContextRealityModel.appearanceOverrides]] is modified for one of the reality models. */\r\n  public readonly onAppearanceOverridesChanged = new BeEvent<(model: ContextRealityModel, newOverrides: FeatureAppearance | undefined) => void>();\r\n  /** Event dispatched when a model is [[add]]ed, [[delete]]d, [[replace]]d, or [[update]]d. */\r\n  public readonly onChanged = new BeEvent<(previousModel: ContextRealityModel | undefined, newModel: ContextRealityModel | undefined) => void>();\r\n\r\n  /** Construct a new list of reality models from its JSON representation. THe list will be initialized from `container.classifiers` and that JSON representation\r\n   * will be kept in sync with changes made to the list. The caller should not directly modify `container.classifiers` or its contents as that will cause the list\r\n   * to become out of sync with the JSON representation.\r\n   * @param container The object that holds the JSON representation of the list.\r\n   * @param createContextRealityModel Optional function used to instantiate ContextRealityModels added to the list.\r\n   */\r\n  public constructor(container: ContextRealityModelsContainer, createContextRealityModel?: (props: ContextRealityModelProps) => ContextRealityModel) {\r\n    this._container = container;\r\n    this._createModel = createContextRealityModel ?? ((props) => new ContextRealityModel(props));\r\n\r\n    const models = container.contextRealityModels;\r\n    if (models)\r\n      for (const model of models)\r\n        this._models.push(this.createModel(model));\r\n  }\r\n\r\n  /** The read-only list of reality models. */\r\n  public get models(): ReadonlyArray<ContextRealityModel> {\r\n    return this._models;\r\n  }\r\n\r\n  /** Append a new reality model to the list.\r\n   * @param The JSON representation of the reality model.\r\n   * @returns the newly-added reality model.\r\n   */\r\n  public add(props: ContextRealityModelProps): ContextRealityModel {\r\n    if (!this._container.contextRealityModels)\r\n      this._container.contextRealityModels = [];\r\n\r\n    props = ContextRealityModelProps.clone(props);\r\n    const model = this.createModel(props);\r\n\r\n    this.onChanged.raiseEvent(undefined, model);\r\n\r\n    this._models.push(model);\r\n    this._container.contextRealityModels.push(props);\r\n\r\n    return model;\r\n  }\r\n\r\n  /** Remove the specified reality model from the list.\r\n   * @param model The reality model to remove.\r\n   * @returns true if the model was removed, or false if the model was not present in the list.\r\n   */\r\n  public delete(model: ContextRealityModel): boolean {\r\n    const index = this._models.indexOf(model);\r\n    if (-1 === index)\r\n      return false;\r\n\r\n    assert(undefined !== this._container.contextRealityModels);\r\n    assert(index < this._container.contextRealityModels.length);\r\n\r\n    this.dropEventListeners(model);\r\n    this.onChanged.raiseEvent(model, undefined);\r\n\r\n    this._models.splice(index, 1);\r\n    if (this.models.length === 0)\r\n      this._container.contextRealityModels = undefined;\r\n    else\r\n      this._container.contextRealityModels.splice(index, 1);\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Remove all reality models from the list. */\r\n  public clear(): void {\r\n    for (const model of this.models) {\r\n      this.dropEventListeners(model);\r\n      this.onChanged.raiseEvent(model, undefined);\r\n    }\r\n\r\n    this._container.contextRealityModels = undefined;\r\n    this._models.length = 0;\r\n  }\r\n\r\n  /** Replace a reality model in the list.\r\n   * @param toReplace The reality model to be replaced.\r\n   * @param replaceWith The JSON representation of the replacement reality model.\r\n   * @returns the newly-created reality model that replaced `toReplace`.\r\n   * @throws Error if `toReplace` is not present in the list\r\n   * @note The replacement occupies the same index in the list as `toReplace` did.\r\n   */\r\n  public replace(toReplace: ContextRealityModel, replaceWith: ContextRealityModelProps): ContextRealityModel {\r\n    const index = this._models.indexOf(toReplace);\r\n    if (-1 === index)\r\n      throw new Error(\"ContextRealityModel not present in list.\");\r\n\r\n    assert(undefined !== this._container.contextRealityModels);\r\n    assert(index < this._container.contextRealityModels.length);\r\n\r\n    replaceWith = ContextRealityModelProps.clone(replaceWith);\r\n    const model = this.createModel(replaceWith);\r\n\r\n    this.onChanged.raiseEvent(toReplace, model);\r\n    this.dropEventListeners(toReplace);\r\n\r\n    this._models[index] = model;\r\n    this._container.contextRealityModels[index] = replaceWith;\r\n\r\n    return model;\r\n  }\r\n\r\n  /** Change selected properties of a reality model.\r\n   * @param toUpdate The reality model whose properties are to be modified.\r\n   * @param updateProps The properties to change.\r\n   * @returns The updated reality model, identical to `toUpdate` except for properties explicitly supplied by `updateProps`.\r\n   * @throws Error if `toUpdate` is not present in the list.\r\n   */\r\n  public update(toUpdate: ContextRealityModel, updateProps: Partial<ContextRealityModelProps>): ContextRealityModel {\r\n    const props = {\r\n      ...toUpdate.toJSON(),\r\n      ...updateProps,\r\n    };\r\n\r\n    // Partial<> makes it possible to pass `undefined` for tilesetUrl...preserve previous URL in that case.\r\n    if (undefined === props.tilesetUrl)\r\n      props.tilesetUrl = toUpdate.url;\r\n\r\n    return this.replace(toUpdate, props);\r\n  }\r\n\r\n  private createModel(props: ContextRealityModelProps): ContextRealityModel {\r\n    const model = this._createModel(props);\r\n    // eslint-disable-next-line @typescript-eslint/unbound-method\r\n    model.onPlanarClipMaskChanged.addListener(this.handlePlanarClipMaskChanged, this);\r\n    // eslint-disable-next-line @typescript-eslint/unbound-method\r\n    model.onAppearanceOverridesChanged.addListener(this.handleAppearanceOverridesChanged, this);\r\n    return model;\r\n  }\r\n\r\n  private dropEventListeners(model: ContextRealityModel): void {\r\n    // eslint-disable-next-line @typescript-eslint/unbound-method\r\n    model.onPlanarClipMaskChanged.removeListener(this.handlePlanarClipMaskChanged, this);\r\n    // eslint-disable-next-line @typescript-eslint/unbound-method\r\n    model.onAppearanceOverridesChanged.removeListener(this.handleAppearanceOverridesChanged, this);\r\n  }\r\n\r\n  private handlePlanarClipMaskChanged(mask: PlanarClipMaskSettings | undefined, model: ContextRealityModel): void {\r\n    this.onPlanarClipMaskChanged.raiseEvent(model, mask);\r\n  }\r\n\r\n  private handleAppearanceOverridesChanged(app: FeatureAppearance | undefined, model: ContextRealityModel): void {\r\n    this.onAppearanceOverridesChanged.raiseEvent(model, app);\r\n  }\r\n}\r\n"]}