@itwin/core-common 3.0.0-extension.0 → 3.1.0-dev.5

package/lib/esm/FeatureSymbology.js

@@ -5,7 +5,7 @@
 /** @packageDocumentation
  * @module Rendering
  */
-import { Id64 } from "@itwin/core-bentley";
+import { assert, Id64 } from "@itwin/core-bentley";
 import { BatchType } from "./FeatureTable";
 import { GeometryClass } from "./GeometryParams";
 import { RgbColor } from "./RgbColor";
@@ -36,6 +36,8 @@ export class FeatureAppearance {
         if (undefined !== this.weight)
             this.weight = Math.max(1, Math.min(this.weight, 32));
         if (undefined !== this.transparency) {
+            if (props.viewDependentTransparency)
+                this.viewDependentTransparency = true;
             this.transparency = Math.max(0, Math.min(this.transparency, 1));
             // Fix up rounding errors...
             const smallDelta = 0.0001;
@@ -60,23 +62,29 @@ export class FeatureAppearance {
     /** Create a FeatureAppearance that overrides the RGB and transparency.
      * The appearance's transparency is derived from the transparency component of the ColorDef.
      */
-    static fromRgba(color) {
+    static fromRgba(color, viewDependentTransparency = false) {
         return this.fromJSON({
             rgb: RgbColor.fromColorDef(color),
             transparency: color.colors.t / 255,
+            viewDependentTransparency: viewDependentTransparency ? true : undefined,
         });
     }
     /** Create a FeatureAppearance that overrides only the transparency */
-    static fromTransparency(transparencyValue) {
-        return this.fromJSON({ transparency: transparencyValue });
+    static fromTransparency(transparencyValue, viewDependent = false) {
+        return this.fromJSON({
+            transparency: transparencyValue,
+            viewDependentTransparency: viewDependent ? true : undefined,
+        });
     }
-    /** Create a FeatureAppearance with overrides corresponding to those defined by the supplied SubCategoryOverride. */
+    /** Create a FeatureAppearance with overrides corresponding to those defined by the supplied SubCategoryOverride.
+     * @note Subcategory overrides set [[viewDependentTransparency]] to `true`.
+     */
     static fromSubCategoryOverride(ovr) {
         const rgb = undefined !== ovr.color ? RgbColor.fromColorDef(ovr.color) : undefined;
         const transparency = ovr.transparency;
         const weight = ovr.weight;
         const ignoresMaterial = undefined !== ovr.material && Id64.isValid(ovr.material) ? true : undefined;
-        return this.fromJSON({ rgb, transparency, weight, ignoresMaterial });
+        return this.fromJSON({ rgb, transparency, weight, ignoresMaterial, viewDependentTransparency: true });
     }
     /** Returns true if this appearance does not override any aspects of symbology. */
     get matchesDefaults() {
@@ -99,11 +107,12 @@ export class FeatureAppearance {
             return true;
         return this.rgbIsEqual(other.rgb)
             && this.weight === other.weight
-            && this.transparency === other.transparency
+            && this.transparencyIsEqual(other.transparency)
             && this.linePixels === other.linePixels
             && this.ignoresMaterial === other.ignoresMaterial
             && this.nonLocatable === other.nonLocatable
-            && this.emphasized === other.emphasized;
+            && this.emphasized === other.emphasized
+            && this.viewDependentTransparency === other.viewDependentTransparency;
     }
     toJSON() {
         const props = {};
@@ -111,8 +120,11 @@ export class FeatureAppearance {
             props.rgb = this.rgb.toJSON();
         if (undefined !== this.weight)
             props.weight = this.weight;
-        if (undefined !== this.transparency)
+        if (undefined !== this.transparency) {
             props.transparency = this.transparency;
+            if (this.viewDependentTransparency)
+                props.viewDependentTransparency = true;
+        }
         if (undefined !== this.linePixels)
             props.linePixels = this.linePixels;
         if (true === this.ignoresMaterial)
@@ -167,10 +179,25 @@ export class FeatureAppearance {
             props.nonLocatable = true;
         if (undefined === props.emphasized && this.emphasized)
             props.emphasized = true;
+        if (undefined !== props.transparency && this.viewDependentTransparency)
+            props.viewDependentTransparency = true;
         return FeatureAppearance.fromJSON(props);
     }
     rgbIsEqual(rgb) {
-        return undefined === this.rgb ? undefined === rgb ? true : false : undefined === rgb ? false : this.rgb.equals(rgb);
+        if (undefined === this.rgb)
+            return undefined === rgb;
+        else if (undefined === rgb)
+            return false;
+        else
+            return this.rgb.equals(rgb);
+    }
+    transparencyIsEqual(transp) {
+        if (undefined === this.transparency)
+            return undefined === transp;
+        else if (undefined === transp)
+            return false;
+        else
+            return Math.floor(this.transparency * 0xff) === Math.floor(transp * 0xff);
     }
 }
 /** An appearance that overrides nothing. */
@@ -387,18 +414,54 @@ export class FeatureOverrides {
             default: return true;
         }
     }
+    /** Specify overrides for all elements belonging to a specified [GeometricModel]($backend), or all geometry belonging to a specified [GeometricElement]($backend) or [SubCategory]($backend). */
+    override(args) {
+        let id;
+        let map;
+        if (undefined !== args.elementId) {
+            id = args.elementId;
+            map = this._elementOverrides;
+        }
+        else if (undefined !== args.modelId) {
+            id = args.modelId;
+            map = this._modelOverrides;
+        }
+        else {
+            id = args.subCategoryId;
+            map = this._subCategoryOverrides;
+        }
+        let app = args.appearance;
+        const idLo = Id64.getLowerUint32(id);
+        const idHi = Id64.getUpperUint32(id);
+        if (undefined !== args.elementId && this.isNeverDrawn(idLo, idHi, 0))
+            return;
+        const replace = "replace" === args.onConflict;
+        const existing = replace ? undefined : map.get(idLo, idHi);
+        if (existing) {
+            assert("replace" !== args.onConflict);
+            switch (args.onConflict) {
+                case "skip":
+                    return;
+                case "extend":
+                    app = app.extendAppearance(existing);
+                    break;
+                default:
+                    app = existing.extendAppearance(app);
+                    break;
+            }
+        }
+        map.set(idLo, idHi, app);
+    }
     /** Specify overrides for all elements within the specified model.
      * @param id The Id of the model.
      * @param app The symbology overrides.
      * @param replaceExisting Specifies whether to replace a pre-existing override for the same model.
      * @note These overrides take priority over all other overrides.
      * @note If [[defaultOverrides]] are defined, they will not apply to any element within this model, even if the supplied appearance overrides nothing.
+     * @deprecated Use [[FeatureOverrides.override]].
      */
     overrideModel(id, app, replaceExisting = true) {
-        const idLo = Id64.getLowerUint32(id);
-        const idHi = Id64.getUpperUint32(id);
-        if (replaceExisting || undefined === this.getModelOverrides(idLo, idHi))
-            this._modelOverrides.set(idLo, idHi, app);
+        this.override({ modelId: id, appearance: app, onConflict: replaceExisting ? "replace" : "skip" });
     }
     /** Specify overrides for all geometry belonging to the specified [SubCategory]($backend).
      * @param id The Id of the subcategory.
@@ -406,14 +469,10 @@ export class FeatureOverrides {
      * @param replaceExisting Specifies whether to replace a pre-existing override for the same subcategory.
      * @note These overrides have lower priority than element and model overrides.
      * @note If [[defaultOverrides]] are defined, they will not apply to any geometry within this subcategory, even if the supplied appearance overrides nothing.
+     * @deprecated Use [[FeatureOverrides.override]].
      */
     overrideSubCategory(id, app, replaceExisting = true) {
-        // NB: We used to do nothing if this.isSubCategoryVisible() => false but now models can turn invisible subcategories visible in their own context.
-        const idLo = Id64.getLowerUint32(id);
-        const idHi = Id64.getUpperUint32(id);
-        // NB: Appearance may specify no overridden symbology - this means "don't apply the default overrides to this subcategory"
-        if (replaceExisting || undefined === this.getSubCategoryOverrides(idLo, idHi))
-            this._subCategoryOverrides.set(idLo, idHi, app);
+        this.override({ subCategoryId: id, appearance: app, onConflict: replaceExisting ? "replace" : "skip" });
     }
     /** Specify overrides for all geometry originating from the specified element.
      * @param id The Id of the element.
@@ -421,22 +480,19 @@ export class FeatureOverrides {
      * @param replaceExisting Specifies whether to replace a pre-existing override for the same element.
      * @note These overrides take precedence over subcategory overrides, but not over model overrides.
      * @note If [[defaultOverrides]] are defined, they will not apply to this element, even if the supplied appearance overrides nothing.
+     * @deprecated Use [[FeatureOverrides.override]].
      */
     overrideElement(id, app, replaceExisting = true) {
-        const idLo = Id64.getLowerUint32(id);
-        const idHi = Id64.getUpperUint32(id);
-        if (this.isNeverDrawn(idLo, idHi, 0))
-            return;
-        // NB: Appearance may specify no overridden symbology - this means "don't apply the default overrides to this element"
-        if (replaceExisting || undefined === this.getElementOverrides(idLo, idHi, 0))
-            this._elementOverrides.set(idLo, idHi, app);
+        this.override({ elementId: id, appearance: app, onConflict: replaceExisting ? "replace" : "skip" });
     }
     /** Specify overrides for all geometry originating from the specified animation node.
      * @param id The Id of the animation node.
      * @param app The symbology overrides.
      * @note These overrides do not take precedence over element overrides.
      */
-    overrideAnimationNode(id, app) { this.animationNodeOverrides.set(id, app); }
+    overrideAnimationNode(id, app) {
+        this.animationNodeOverrides.set(id, app);
+    }
     /** Defines a default appearance to be applied to any [[Feature]] *not* explicitly overridden.
      * @param appearance The symbology overrides.
      * @param replaceExisting Specifies whether to replace the current default overrides if they are already defined.

package/lib/esm/FeatureSymbology.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureSymbology.js","sourceRoot":"","sources":["../../src/FeatureSymbology.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 Rendering\r\n */\r\n\r\nimport { Id64, Id64String } from \"@itwin/core-bentley\";\r\nimport { BatchType, Feature } from \"./FeatureTable\";\r\nimport { ColorDef } from \"./ColorDef\";\r\nimport { GeometryClass } from \"./GeometryParams\";\r\nimport { LinePixels } from \"./LinePixels\";\r\nimport { RgbColor, RgbColorProps } from \"./RgbColor\";\r\nimport { SubCategoryOverride } from \"./SubCategoryOverride\";\r\n\r\nfunction copyIdSetToUint32Set(dst: Id64.Uint32Set, src: Iterable<string>): void {\r\n  dst.clear();\r\n  if (typeof src === \"string\") {\r\n    dst.addId(src);\r\n  } else {\r\n    for (const id of src)\r\n      dst.addId(id);\r\n  }\r\n}\r\n\r\n// cspell:ignore subcat subcats\r\n\r\n/** Properties used to initialize a [[FeatureAppearance]].\r\n * @public\r\n */\r\nexport interface FeatureAppearanceProps {\r\n  /** The color of the Feature */\r\n  rgb?: RgbColorProps;\r\n  /** The line weight in pixels as an integer in [1, 31] */\r\n  weight?: number;\r\n  /** The transparency in the range [0.0, 1.0] where 0 indicates fully opaque and 1 indicates fully transparent. */\r\n  transparency?: number;\r\n  /** The pixel pattern used to draw lines. */\r\n  linePixels?: LinePixels;\r\n  /** If true, ignore the [[RenderMaterial]] associated with surfaces. */\r\n  ignoresMaterial?: true | undefined;\r\n  /** If true, the associated [[Feature]] will not be drawn when using [Viewport.readPixels]($frontend). */\r\n  nonLocatable?: true | undefined;\r\n  /** If true, the associated [[Feature]] will be emphasized. Emphasized features are rendered using the [[Hilite.Settings]] defined by [Viewport.emphasisSettings]($frontend). */\r\n  emphasized?: true | undefined;\r\n}\r\n\r\n/** Defines overrides for selected aspects of a [[Feature]]'s symbology.\r\n * Any member defined in the appearance overrides that aspect of symbology for all [[Feature]]s to which the appearance is applied.\r\n * @see [[FeatureOverrides]] to customize the appearance of multiple features.\r\n * @public\r\n */\r\nexport class FeatureAppearance implements FeatureAppearanceProps {\r\n  public readonly rgb?: RgbColor;\r\n  public readonly weight?: number;\r\n  public readonly transparency?: number;\r\n  public readonly linePixels?: LinePixels;\r\n  public readonly ignoresMaterial?: true | undefined;\r\n  public readonly nonLocatable?: true | undefined;\r\n  public readonly emphasized?: true | undefined;\r\n\r\n  /** An appearance that overrides nothing. */\r\n  public static readonly defaults = new FeatureAppearance({});\r\n\r\n  public static fromJSON(props?: FeatureAppearanceProps) {\r\n    if (undefined === props || (undefined === props.rgb && undefined === props.weight && undefined === props.transparency && undefined === props.linePixels && !props.ignoresMaterial && !props.nonLocatable && !props.emphasized))\r\n      return this.defaults;\r\n    else\r\n      return new FeatureAppearance(props);\r\n  }\r\n\r\n  /** Create a FeatureAppearance that overrides only the RGB color.\r\n   * @note The transparency component of the ColorDef is ignored.\r\n   */\r\n  public static fromRgb(color: ColorDef): FeatureAppearance {\r\n    return this.fromJSON({ rgb: RgbColor.fromColorDef(color) });\r\n  }\r\n\r\n  /** Create a FeatureAppearance that overrides the RGB and transparency.\r\n   * The appearance's transparency is derived from the transparency component of the ColorDef.\r\n   */\r\n  public static fromRgba(color: ColorDef): FeatureAppearance {\r\n    return this.fromJSON({\r\n      rgb: RgbColor.fromColorDef(color),\r\n      transparency: color.colors.t / 255,\r\n    });\r\n  }\r\n  /** Create a FeatureAppearance that overrides only the transparency */\r\n  public static fromTransparency(transparencyValue: number): FeatureAppearance {\r\n    return this.fromJSON({ transparency: transparencyValue });\r\n  }\r\n\r\n  /** Create a FeatureAppearance with overrides corresponding to those defined by the supplied SubCategoryOverride. */\r\n  public static fromSubCategoryOverride(ovr: SubCategoryOverride): FeatureAppearance {\r\n    const rgb = undefined !== ovr.color ? RgbColor.fromColorDef(ovr.color) : undefined;\r\n    const transparency = ovr.transparency;\r\n    const weight = ovr.weight;\r\n    const ignoresMaterial = undefined !== ovr.material && Id64.isValid(ovr.material) ? true : undefined;\r\n    return this.fromJSON({ rgb, transparency, weight, ignoresMaterial });\r\n  }\r\n\r\n  /** Returns true if this appearance does not override any aspects of symbology. */\r\n  public get matchesDefaults(): boolean {\r\n    return this.equals(FeatureAppearance.defaults);\r\n  }\r\n\r\n  public get overridesRgb(): boolean { return undefined !== this.rgb; }\r\n  public get overridesTransparency(): boolean { return undefined !== this.transparency; }\r\n  public get overridesLinePixels(): boolean { return undefined !== this.linePixels; }\r\n  public get overridesWeight(): boolean { return undefined !== this.weight; }\r\n  public get overridesSymbology(): boolean {\r\n    return this.overridesRgb || this.overridesTransparency || this.overridesWeight || this.overridesLinePixels || !!this.ignoresMaterial\r\n      || this.emphasized || this.overridesNonLocatable;\r\n  }\r\n  public get overridesNonLocatable(): boolean { return undefined !== this.nonLocatable; }\r\n  public get isFullyTransparent(): boolean { return undefined !== this.transparency && this.transparency >= 1.0; }\r\n  /** Returns true if any aspect of the appearance is overridden (i.e., if any member is not undefined). */\r\n  public get anyOverridden(): boolean { return this.overridesSymbology || this.overridesNonLocatable; }\r\n\r\n  public equals(other: FeatureAppearance): boolean {\r\n    if (this === other)\r\n      return true;\r\n\r\n    return this.rgbIsEqual(other.rgb)\r\n      && this.weight === other.weight\r\n      && this.transparency === other.transparency\r\n      && this.linePixels === other.linePixels\r\n      && this.ignoresMaterial === other.ignoresMaterial\r\n      && this.nonLocatable === other.nonLocatable\r\n      && this.emphasized === other.emphasized;\r\n  }\r\n\r\n  public toJSON(): FeatureAppearanceProps {\r\n    const props: FeatureAppearanceProps = {};\r\n    if (this.rgb)\r\n      props.rgb = this.rgb.toJSON();\r\n\r\n    if (undefined !== this.weight)\r\n      props.weight = this.weight;\r\n\r\n    if (undefined !== this.transparency)\r\n      props.transparency = this.transparency;\r\n\r\n    if (undefined !== this.linePixels)\r\n      props.linePixels = this.linePixels;\r\n\r\n    if (true === this.ignoresMaterial)\r\n      props.ignoresMaterial = true;\r\n\r\n    if (true === this.nonLocatable)\r\n      props.nonLocatable = true;\r\n\r\n    if (true === this.emphasized)\r\n      props.emphasized = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Convert this appearance to JSON, and override any properties explicitly specified by `changedProps` in the result.\r\n   * Example:\r\n   * ```ts\r\n   *  const base = FeatureAppearance.fromRgba(ColorDef.white); // transparency=0, rgb=white\r\n   *  const clone = base.cloneProps({ transparency: undefined, weight: 5 }); // transparency=undefined, rgb=white, weight=5\r\n   * ```\r\n   * @see [[FeatureAppearance.clone]].\r\n   */\r\n  public cloneProps(changedProps: FeatureAppearanceProps): FeatureAppearanceProps {\r\n    return {\r\n      ...this.toJSON(),\r\n      ...changedProps,\r\n    };\r\n  }\r\n\r\n  /** Create a copy of this appearance, overriding any properties explicitly specified by `changedProps`.\r\n   * Example:\r\n   * ```ts\r\n   *  const base = FeatureAppearance.fromRgba(ColorDef.white); // transparency=0, rgb=white\r\n   *  const clone = base.clone({ transparency: undefined, weight: 5 }); // transparency=undefined, rgb=white, weight=5\r\n   * ```\r\n   * @see [[FeatureAppearance.cloneProps]].\r\n   */\r\n  public clone(changedProps: FeatureAppearanceProps): FeatureAppearance {\r\n    return FeatureAppearance.fromJSON(this.cloneProps(changedProps));\r\n  }\r\n\r\n  /** Produce a FeatureAppearance from the supplied appearance in which any aspect not defined by the base appearance is overridden by this appearance. */\r\n  public extendAppearance(base: FeatureAppearance): FeatureAppearance {\r\n    if (!this.overridesSymbology)\r\n      return base;\r\n\r\n    const props = base.toJSON();\r\n    if (undefined === props.rgb) props.rgb = this.rgb;\r\n    if (undefined === props.transparency) props.transparency = this.transparency;\r\n    if (undefined === props.linePixels) props.linePixels = this.linePixels;\r\n    if (undefined === props.weight) props.weight = this.weight;\r\n    if (undefined === props.ignoresMaterial && this.ignoresMaterial) props.ignoresMaterial = true;\r\n    if (undefined === props.nonLocatable && this.nonLocatable) props.nonLocatable = true;\r\n    if (undefined === props.emphasized && this.emphasized) props.emphasized = true;\r\n\r\n    return FeatureAppearance.fromJSON(props);\r\n  }\r\n\r\n  protected constructor(props: FeatureAppearanceProps) {\r\n    this.rgb = undefined !== props.rgb ? RgbColor.fromJSON(props.rgb) : undefined;\r\n    this.weight = props.weight;\r\n    this.transparency = props.transparency;\r\n    this.linePixels = props.linePixels;\r\n    this.ignoresMaterial = props.ignoresMaterial;\r\n    this.nonLocatable = props.nonLocatable;\r\n    this.emphasized = props.emphasized;\r\n\r\n    if (undefined !== this.weight)\r\n      this.weight = Math.max(1, Math.min(this.weight, 32));\r\n\r\n    if (undefined !== this.transparency) {\r\n      this.transparency = Math.max(0, Math.min(this.transparency, 1));\r\n\r\n      // Fix up rounding errors...\r\n      const smallDelta = 0.0001;\r\n      if (1.0 - this.transparency < smallDelta)\r\n        this.transparency = 1.0;\r\n      else if (this.transparency < smallDelta)\r\n        this.transparency = 0.0;\r\n    }\r\n  }\r\n\r\n  private rgbIsEqual(rgb?: RgbColor): boolean {\r\n    return undefined === this.rgb ? undefined === rgb ? true : false : undefined === rgb ? false : this.rgb.equals(rgb);\r\n  }\r\n}\r\n\r\n/** Interface adopted by an object that can supply a [[FeatureAppearance]] given a low-level description of a [[Feature]].\r\n * @see [[FeatureOverrides]] for the commonly-used implementation.\r\n * @see [[FeatureAppearanceProvider]] to supplement the appearance supplied by this interface.\r\n * @public\r\n */\r\nexport interface FeatureAppearanceSource {\r\n  /** Supplies the desired appearance overrides for the specified [[Feature]], or `undefined` if the feature should not be drawn.\r\n   * The feature is described by its components for efficiency reasons.\r\n   * @param elemLo The lower 32 bits of the feature's element Id.\r\n   * @param elemHi The upper 32 bits of the feature's element Id.\r\n   * @param subcatLo The lower 32 bits of the feature's subcategory Id.\r\n   * @param subcatHi The upper 32 bits of the feature's subcategory Id.\r\n   * @param geomClass The geometry class of the feature.\r\n   * @param modelLo The lower 32 bits of the feature's model Id.\r\n   * @param modelHi The upper 32 bits of the feature's model Id.\r\n   * @param type The type of batch to which the feature belongs.\r\n   * @param animationNodeId The Id of the corresponding node in the [[RenderSchedule]], or `0` if none.\r\n   * @returns The desired appearance overrides, or `undefined` to indicate the feature should not be displayed.\r\n   * @see [Id64.isValidUint32Pair]($core-bentley) to determine if the components of an [Id64String]($core-bentley) represent a valid Id.\r\n   */\r\n  getAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined;\r\n}\r\n\r\n/** Specifies how to customize the appearance of individual [[Feature]]s, typically within the context of a [Viewport]($frontend).\r\n * Individual aspects of a feature's appearance - like visibility, color, and transparency - are overridden by supplying a [[FeatureAppearance]].\r\n * Those overrides can be specified on the basis of the feature's model, element, and/or subcategory. A default set of overrides can also be specified to\r\n * apply to the appearance of any feature not otherwise overridden.\r\n *\r\n * It is possible to override multiple aspects of a feature on different bases. For example, you might specify that all features belonging to subcategory \"A\" should be drawn in red,\r\n * and that all features belonging to model \"B\" should be drawn 50% transparent. In this case, a feature belonging to both subcategory \"A\" and model \"B\" will be drawn as 50% transparent red -\r\n * the separate overrides are combined to produce the feature's overall appearance.\r\n *\r\n * In the case of conflicts, there is an order of precedence:\r\n *  - Model overrides take highest precedence.\r\n *  - Element overrides are of higher precedence than subcategory overrides.\r\n *  - Subcategory overrides have lowest precedence.\r\n *\r\n * For example, you might specify that all features belonging to subcategory \"A\" should be drawn in red, and all those belonging to model \"B\" should be drawn in green.\r\n * Then a feature belonging to subcategory \"A\" and model \"B\" will be drawn in green, because the model overrides take precedence.\r\n *\r\n * Instances of this class are not typically instantiated by an application directly; instead, an application can implement a [FeatureOverrideProvider]($frontend)\r\n * that augments the overrides supplied by a viewport.\r\n *\r\n * @see [FeatureSymbology.Overrides]($frontend) to create overrides specific to a [Viewport]($frontend) or [ViewState]($frontend).\r\n * @see [FeatureOverrideProvider]($frontend) to customize the appearance of features within a [Viewport]($frontend).\r\n * @public\r\n */\r\nexport class FeatureOverrides implements FeatureAppearanceSource {\r\n  /** Ids of elements that should never be drawn. This takes precedence over [[alwaysDrawn]]. @internal */\r\n  protected readonly _neverDrawn = new Id64.Uint32Set();\r\n  /** Ids of elements that should always be drawn. [[neverDrawn]] takes precedence over this set. @internal */\r\n  protected readonly _alwaysDrawn = new Id64.Uint32Set();\r\n  /** If true, no elements *except* those defined in the \"always drawn\" set will be drawn.\r\n   * @see [[setAlwaysDrawn]]\r\n   */\r\n  public isAlwaysDrawnExclusive = false;\r\n  /** If true, the always-drawn elements are drawn even if their subcategories are not visible.\r\n   * @see [[setAlwaysDrawn]]\r\n   */\r\n  public alwaysDrawnIgnoresSubCategory = true;\r\n  /** If true, all subcategories are considered visible. This is used for drawing sheets via section callouts in the absence of an actual sheet view.\r\n   * @internal\r\n   */\r\n  public ignoreSubCategory = false;\r\n\r\n  /** Overrides applied to any feature not explicitly overridden. @internal */\r\n  protected _defaultOverrides = FeatureAppearance.defaults;\r\n  /** Whether construction geometry should be drawn. @internal */\r\n  protected _constructions = false;\r\n  /** Whether dimensions should be drawn. @internal */\r\n  protected _dimensions = false;\r\n  /** Whether area patterns should be drawn. @internal */\r\n  protected _patterns = false;\r\n  /** Whether line weights should be applied. If false, all lines are rendered 1-pixel wide. @internal */\r\n  protected _lineWeights = true;\r\n\r\n  /** Overrides applied to all elements belonging to each model. @internal */\r\n  protected readonly _modelOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** Overrides applied to specific elements. @internal */\r\n  protected readonly _elementOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** Overrides applied to geometry belonging to each subcategory. @internal */\r\n  protected readonly _subCategoryOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** The set of displayed subcategories. Geometry belonging to subcategories not included in this set will not be drawn. @internal */\r\n  protected readonly _visibleSubCategories = new Id64.Uint32Set();\r\n  /** Display priorities assigned to subcategories, possibly overridden by display style. Only applicable for plan projection models. @internal */\r\n  protected readonly _subCategoryPriorities = new Id64.Uint32Map<number>();\r\n\r\n  /** Per-model, a set of subcategories whose visibility should be inverted for elements within that model.\r\n   * Populated by Viewport.\r\n   * @internal\r\n   */\r\n  protected readonly _modelSubCategoryOverrides = new Id64.Uint32Map<Id64.Uint32Set>();\r\n\r\n  /** Ids of animation nodes that should never be drawn.\r\n   * @internal\r\n   */\r\n  public readonly neverDrawnAnimationNodes = new Set<number>();\r\n  /** Mapping of animation node Ids to overrides applied to the corresponding animation nodes.\r\n   * @internal\r\n   */\r\n  public readonly animationNodeOverrides = new Map<number, FeatureAppearance>();\r\n\r\n  /** Overrides applied to features for which no other overrides are defined */\r\n  public get defaultOverrides(): FeatureAppearance { return this._defaultOverrides; }\r\n  /** Whether or not line weights are applied. If false, all lines are drawn with a weight of 1. */\r\n  public get lineWeights(): boolean { return this._lineWeights; }\r\n\r\n  /** @internal */\r\n  public get neverDrawn() { return this._neverDrawn; }\r\n  /** @internal */\r\n  public get alwaysDrawn() { return this._alwaysDrawn; }\r\n\r\n  /** @internal */\r\n  protected isNeverDrawn(elemIdLo: number, elemIdHi: number, animationNodeId: number): boolean {\r\n    if (this._neverDrawn.has(elemIdLo, elemIdHi))\r\n      return true;\r\n    else\r\n      return this.neverDrawnAnimationNodes.has(animationNodeId);\r\n  }\r\n  /** @internal */\r\n  protected isAlwaysDrawn(idLo: number, idHi: number): boolean { return this._alwaysDrawn.has(idLo, idHi); }\r\n  /** Returns true if the [SubCategory]($backend) specified by Id is in the set of visible subcategories. @internal */\r\n  public isSubCategoryVisible(idLo: number, idHi: number): boolean { return this._visibleSubCategories.has(idLo, idHi); }\r\n  /** @internal */\r\n  public isSubCategoryVisibleInModel(subcatLo: number, subcatHi: number, modelLo: number, modelHi: number): boolean {\r\n    if (this.ignoreSubCategory)\r\n      return true;\r\n\r\n    let vis = this.isSubCategoryVisible(subcatLo, subcatHi);\r\n    const modelOvr = this._modelSubCategoryOverrides.get(modelLo, modelHi);\r\n    if (undefined !== modelOvr && modelOvr.has(subcatLo, subcatHi))\r\n      vis = !vis;\r\n\r\n    return vis;\r\n  }\r\n\r\n  /** @internal */\r\n  protected getModelOverrides(idLo: number, idHi: number): FeatureAppearance | undefined { return this._modelOverrides.get(idLo, idHi); }\r\n  /** @internal */\r\n  protected getElementOverrides(idLo: number, idHi: number, animationNodeId: number): FeatureAppearance | undefined {\r\n    const app = this._elementOverrides.get(idLo, idHi);\r\n    if (app !== undefined)\r\n      return app;\r\n\r\n    return this.animationNodeOverrides.get(animationNodeId);\r\n  }\r\n  /** @internal */\r\n  protected getSubCategoryOverrides(idLo: number, idHi: number): FeatureAppearance | undefined { return this._subCategoryOverrides.get(idLo, idHi); }\r\n\r\n  /** Add a [SubCategory]($backend) to the set of visible subcategories. */\r\n  public setVisibleSubCategory(id: Id64String): void { this._visibleSubCategories.addId(id); }\r\n  /** Specify the Id of an element that should never be drawn. */\r\n  public setNeverDrawn(id: Id64String): void { this._neverDrawn.addId(id); }\r\n  /** Specify the Id of an element that should always be drawn. */\r\n  public setAlwaysDrawn(id: Id64String): void { this._alwaysDrawn.addId(id); }\r\n  /** Specify the Id of a animation node that should never be drawn. */\r\n  public setAnimationNodeNeverDrawn(id: number): void { this.neverDrawnAnimationNodes.add(id); }\r\n  /** Specify the Ids of elements that should never be drawn. */\r\n  public setNeverDrawnSet(ids: Iterable<Id64String>) { copyIdSetToUint32Set(this._neverDrawn, ids); }\r\n  /** Specify the Ids of elements that should always be drawn. */\r\n  public setAlwaysDrawnSet(ids: Iterable<Id64String>, exclusive: boolean, ignoreSubCategory = true) {\r\n    copyIdSetToUint32Set(this._alwaysDrawn, ids);\r\n    this.isAlwaysDrawnExclusive = exclusive;\r\n    this.alwaysDrawnIgnoresSubCategory = ignoreSubCategory;\r\n  }\r\n\r\n  /** Returns the feature's appearance overrides, or undefined if the feature is not visible. */\r\n  public getFeatureAppearance(feature: Feature, modelId: Id64String, type: BatchType = BatchType.Primary, animationNodeId = 0): FeatureAppearance | undefined {\r\n    return this.getAppearance(\r\n      Id64.getLowerUint32(feature.elementId), Id64.getUpperUint32(feature.elementId),\r\n      Id64.getLowerUint32(feature.subCategoryId), Id64.getUpperUint32(feature.subCategoryId),\r\n      feature.geometryClass,\r\n      Id64.getLowerUint32(modelId), Id64.getUpperUint32(modelId),\r\n      type, animationNodeId);\r\n  }\r\n\r\n  private static readonly _weight1Appearance = FeatureAppearance.fromJSON({ weight: 1 });\r\n\r\n  /** Returns a feature's appearance overrides, or undefined if the feature is not visible.\r\n   * Takes Id64s as pairs of unsigned 32-bit integers for efficiency, because that is how they are stored by the PackedFeatureTable associated with each batch of graphics.\r\n   * @see [[getFeatureAppearance]] for an equivalent function that accepts [Id64String]($core-bentley)s instead of integer pairs.\r\n   */\r\n  public getAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined {\r\n    if (BatchType.VolumeClassifier === type || BatchType.PlanarClassifier === type)\r\n      return this.getClassifierAppearance(elemLo, elemHi, subcatLo, subcatHi, modelLo, modelHi, animationNodeId);\r\n\r\n    let app = !this._lineWeights ? FeatureOverrides._weight1Appearance : FeatureAppearance.defaults;\r\n    const modelApp = this.getModelOverrides(modelLo, modelHi);\r\n    if (undefined !== modelApp)\r\n      app = modelApp.extendAppearance(app);\r\n\r\n    // Is the element visible?\r\n    let elemApp, alwaysDrawn = false;\r\n\r\n    if (Id64.isValidUint32Pair(elemLo, elemHi)) {\r\n      if (this.isNeverDrawn(elemLo, elemHi, animationNodeId))\r\n        return undefined;\r\n\r\n      alwaysDrawn = this.isAlwaysDrawn(elemLo, elemHi);\r\n      if (!alwaysDrawn && this.isAlwaysDrawnExclusive)\r\n        return undefined;\r\n\r\n      // Element overrides take precedence\r\n      elemApp = this.getElementOverrides(elemLo, elemHi, animationNodeId);\r\n      if (undefined !== elemApp)\r\n        app = undefined !== modelApp ? elemApp.extendAppearance(app) : elemApp;\r\n    }\r\n\r\n    let subCatApp;\r\n    if (!this.ignoreSubCategory && Id64.isValidUint32Pair(subcatLo, subcatHi)) {\r\n      if ((!alwaysDrawn || !this.alwaysDrawnIgnoresSubCategory) && !this.isSubCategoryVisibleInModel(subcatLo, subcatHi, modelLo, modelHi))\r\n        return undefined;\r\n\r\n      subCatApp = this.getSubCategoryOverrides(subcatLo, subcatHi);\r\n      if (undefined !== subCatApp)\r\n        app = subCatApp.extendAppearance(app);\r\n    }\r\n\r\n    // Only apply default if *no* appearance was explicitly registered (doesn't matter if registered appearance does not actually override anything)\r\n    if (undefined === elemApp && undefined === modelApp && undefined === subCatApp)\r\n      app = this._defaultOverrides.extendAppearance(app);\r\n\r\n    let visible = alwaysDrawn || this.isClassVisible(geomClass);\r\n    if (visible && app.isFullyTransparent)\r\n      visible = false; // don't bother rendering something with full transparency...\r\n\r\n    return visible ? app : undefined;\r\n  }\r\n\r\n  /** Classifiers behave totally differently...in particular they are never invisible unless fully-transparent.\r\n   * @internal\r\n   */\r\n  protected getClassifierAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, modelLo: number, modelHi: number, animationNodeId: number): FeatureAppearance | undefined {\r\n    let app = FeatureAppearance.defaults;\r\n    const modelApp = this.getModelOverrides(modelLo, modelHi);\r\n    if (undefined !== modelApp)\r\n      app = modelApp.extendAppearance(app);\r\n\r\n    const elemApp = this.getElementOverrides(elemLo, elemHi, animationNodeId);\r\n    if (undefined !== elemApp)\r\n      app = undefined !== modelApp ? elemApp.extendAppearance(app) : elemApp;\r\n\r\n    if (!this.ignoreSubCategory && Id64.isValidUint32Pair(subcatLo, subcatHi)) {\r\n      const subCat = this.getSubCategoryOverrides(subcatLo, subcatHi);\r\n      if (undefined !== subCat)\r\n        app = subCat.extendAppearance(app);\r\n    }\r\n\r\n    if (undefined === elemApp && undefined === modelApp)\r\n      app = this._defaultOverrides.extendAppearance(app);\r\n\r\n    // NB: A fully-transparent classifier means the classifier is a clip mask - classified pixels will be discarded.\r\n    return app;\r\n  }\r\n\r\n  /** Return whether geometry of the specified class should be drawn.\r\n   * @see [[ViewFlags.constructions]], [[ViewFlags.dimensions]], and [[ViewFlags.patterns]].\r\n   */\r\n  public isClassVisible(geomClass: GeometryClass): boolean {\r\n    switch (geomClass) {\r\n      case GeometryClass.Construction: return this._constructions;\r\n      case GeometryClass.Dimension: return this._dimensions;\r\n      case GeometryClass.Pattern: return this._patterns;\r\n      default: return true;\r\n    }\r\n  }\r\n\r\n  /** Specify overrides for all elements within the specified model.\r\n   * @param id The Id of the model.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same model.\r\n   * @note These overrides take priority over all other overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to any element within this model, even if the supplied appearance overrides nothing.\r\n   */\r\n  public overrideModel(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    const idLo = Id64.getLowerUint32(id);\r\n    const idHi = Id64.getUpperUint32(id);\r\n    if (replaceExisting || undefined === this.getModelOverrides(idLo, idHi))\r\n      this._modelOverrides.set(idLo, idHi, app);\r\n  }\r\n\r\n  /** Specify overrides for all geometry belonging to the specified [SubCategory]($backend).\r\n   * @param id The Id of the subcategory.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same subcategory.\r\n   * @note These overrides have lower priority than element and model overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to any geometry within this subcategory, even if the supplied appearance overrides nothing.\r\n   */\r\n  public overrideSubCategory(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    // NB: We used to do nothing if this.isSubCategoryVisible() => false but now models can turn invisible subcategories visible in their own context.\r\n    const idLo = Id64.getLowerUint32(id);\r\n    const idHi = Id64.getUpperUint32(id);\r\n\r\n    // NB: Appearance may specify no overridden symbology - this means \"don't apply the default overrides to this subcategory\"\r\n    if (replaceExisting || undefined === this.getSubCategoryOverrides(idLo, idHi))\r\n      this._subCategoryOverrides.set(idLo, idHi, app);\r\n  }\r\n\r\n  /** Specify overrides for all geometry originating from the specified element.\r\n   * @param id The Id of the element.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same element.\r\n   * @note These overrides take precedence over subcategory overrides, but not over model overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to this element, even if the supplied appearance overrides nothing.\r\n   */\r\n  public overrideElement(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    const idLo = Id64.getLowerUint32(id);\r\n    const idHi = Id64.getUpperUint32(id);\r\n    if (this.isNeverDrawn(idLo, idHi, 0))\r\n      return;\r\n\r\n    // NB: Appearance may specify no overridden symbology - this means \"don't apply the default overrides to this element\"\r\n    if (replaceExisting || undefined === this.getElementOverrides(idLo, idHi, 0))\r\n      this._elementOverrides.set(idLo, idHi, app);\r\n  }\r\n\r\n  /** Specify overrides for all geometry originating from the specified animation node.\r\n   * @param id The Id of the animation node.\r\n   * @param app The symbology overrides.\r\n   * @note These overrides do not take precedence over element overrides.\r\n   */\r\n  public overrideAnimationNode(id: number, app: FeatureAppearance): void { this.animationNodeOverrides.set(id, app); }\r\n\r\n  /** Defines a default appearance to be applied to any [[Feature]] *not* explicitly overridden.\r\n   * @param appearance The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace the current default overrides if they are already defined.\r\n   */\r\n  public setDefaultOverrides(appearance: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    if (replaceExisting || !appearance.overridesSymbology)\r\n      this._defaultOverrides = appearance;\r\n  }\r\n\r\n  /** Get the display priority of a subcategory. This is only relevant when using [[PlanProjectionSettings]].\r\n   * @internal\r\n   */\r\n  public getSubCategoryPriority(idLo: number, idHi: number): number {\r\n    return this._subCategoryPriorities.get(idLo, idHi) ?? 0;\r\n  }\r\n\r\n  /** Construct a new Overrides that overrides nothing.\r\n   * @see [FeatureSymbology.Overrides]($frontend) to construct overrides based on a [ViewState]($frontend) or [Viewport]($frontend).\r\n   */\r\n  public constructor() {\r\n    //\r\n  }\r\n\r\n  /** Returns true if geometry belonging to the specified subcategory will be drawn. */\r\n  public isSubCategoryIdVisible(id: Id64String): boolean { return this.isSubCategoryVisible(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n  /** Returns the overrides applied to geometry belonging to the specified model, if any such are defined. */\r\n  public getModelOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getModelOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n  /** Returns the overrides applied to geometry belonging to the specified element, if any such are defined. */\r\n  public getElementOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getElementOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id), 0); }\r\n  /** Returns the overrides applied to geometry belonging to the specified subcategory, if any such are defined. */\r\n  public getSubCategoryOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getSubCategoryOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n\r\n  /** Returns true if the specified Feature will be drawn. */\r\n  public isFeatureVisible(feature: Feature): boolean {\r\n    const { elementId, subCategoryId, geometryClass } = feature;\r\n    const isValidElemId = !Id64.isInvalid(elementId);\r\n    const elemIdParts = isValidElemId ? Id64.getUint32Pair(elementId) : undefined;\r\n\r\n    if (undefined !== elemIdParts && this.isNeverDrawn(elemIdParts.lower, elemIdParts.upper, 0))\r\n      return false;\r\n\r\n    const alwaysDrawn = undefined !== elemIdParts && this.isAlwaysDrawn(elemIdParts.lower, elemIdParts.upper);\r\n    if (alwaysDrawn || this.isAlwaysDrawnExclusive)\r\n      return alwaysDrawn;\r\n\r\n    // NB: This ignores per-model subcategory visibility overrides, because caller did not specify a model.\r\n    if (!this.isSubCategoryIdVisible(subCategoryId))\r\n      return false;\r\n\r\n    return this.isClassVisible(geometryClass);\r\n  }\r\n}\r\n\r\n/** Interface adopted by an object that can supply the [[FeatureAppearance]] supplied by a [[FeatureAppearanceSource]].\r\n * This is useful for selectively overriding or agumenting a [Viewport]($frontend)'s symbology overrides.\r\n * A typical implementation will invoke [[FeatureAppearanceSource.getAppeaprance]] and customize the returned appearance.\r\n * @see [[FeatureAppearanceProvider.chain]] to chain two providers together.\r\n * @public\r\n */\r\nexport interface FeatureAppearanceProvider {\r\n  /** Supply the desired appearance overrides for the specified [[Feature]], or `undefined` if the feature should not be drawn.\r\n   * The feature is described by its components for efficiency reasons.\r\n   * @param source The base symbology overrides, e.g., typically defined by a [Viewport]($frontend).\r\n   * @param elemLo The lower 32 bits of the feature's element Id.\r\n   * @param elemHi The upper 32 bits of the feature's element Id.\r\n   * @param subcatLo The lower 32 bits of the feature's subcategory Id.\r\n   * @param subcatHi The upper 32 bits of the feature's subcategory Id.\r\n   * @param geomClass The geometry class of the feature.\r\n   * @param modelLo The lower 32 bits of the feature's model Id.\r\n   * @param modelHi The upper 32 bits of the feature's model Id.\r\n   * @param type The type of batch to which the feature belongs.\r\n   * @param animationNodeId The Id of the corresponding node in the [[RenderSchedule]], or `0` if none.\r\n   * @returns The desired appearance overrides, or `undefined` to indicate the feature should not be displayed.\r\n   * @see [[FeatureAppearanceSource.getAppearance]] to forward the request to the source.\r\n   * @see [Id64.isValidUint32Pair]($core-bentley) to determine if the components of an [Id64String]($core-bentley) represent a valid Id.\r\n   */\r\n  getFeatureAppearance(source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined;\r\n}\r\n\r\n/** @public */\r\nexport namespace FeatureAppearanceProvider {\r\n  /** Produce a FeatureAppearanceSource for which `getAppearance()` returns the appearance specified in `source`, potentially modified by `provider`. */\r\n  function wrap(source: FeatureAppearanceSource, provider: FeatureAppearanceProvider): FeatureAppearanceSource {\r\n    return {\r\n      getAppearance: (elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        return provider.getFeatureAppearance(source, elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n      },\r\n    };\r\n  }\r\n\r\n  /** Create a provider that obtains each feature's appearance from the source, and if the feature is visible, modifies the appearance.\r\n   * @param supplementAppearance A function accepting the feature's base appearance and returning a supplemental appearance.\r\n   * @public\r\n   */\r\n  export function supplement(supplementAppearance: (appearance: FeatureAppearance) => FeatureAppearance): FeatureAppearanceProvider {\r\n    return {\r\n      getFeatureAppearance: (source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        const app = source.getAppearance(elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n        return app ? supplementAppearance(app) : app;\r\n      },\r\n    };\r\n  }\r\n\r\n  /** Chain two FeatureAppearanceProviders together such that `first`'s `getFeatureAppearance` function is applied before `second`'s.\r\n   * If `second` invokes `source.getAppearance()`, the returned appearance will include any modifications applied by `first`.\r\n   * @public\r\n   */\r\n  export function chain(first: FeatureAppearanceProvider, second: FeatureAppearanceProvider): FeatureAppearanceProvider {\r\n    if (first === second)\r\n      return first;\r\n\r\n    return {\r\n      getFeatureAppearance: (source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        return second.getFeatureAppearance(wrap(source, first), elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n      },\r\n    };\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FeatureSymbology.js","sourceRoot":"","sources":["../../src/FeatureSymbology.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 Rendering\r\n */\r\n\r\nimport { assert, Id64, Id64String } from \"@itwin/core-bentley\";\r\nimport { BatchType, Feature } from \"./FeatureTable\";\r\nimport { ColorDef } from \"./ColorDef\";\r\nimport { GeometryClass } from \"./GeometryParams\";\r\nimport { LinePixels } from \"./LinePixels\";\r\nimport { RgbColor, RgbColorProps } from \"./RgbColor\";\r\nimport { SubCategoryOverride } from \"./SubCategoryOverride\";\r\n\r\nfunction copyIdSetToUint32Set(dst: Id64.Uint32Set, src: Iterable<string>): void {\r\n  dst.clear();\r\n  if (typeof src === \"string\") {\r\n    dst.addId(src);\r\n  } else {\r\n    for (const id of src)\r\n      dst.addId(id);\r\n  }\r\n}\r\n\r\n// cspell:ignore subcat subcats\r\n\r\n/** JSON representation of a [[FeatureAppearance]].\r\n * @public\r\n */\r\nexport interface FeatureAppearanceProps {\r\n  /** @see [[FeatureAppearance.rgb]]. */\r\n  rgb?: RgbColorProps;\r\n  /** @see [[FeatureAppearance.weight]]. */\r\n  weight?: number;\r\n  /** @see [[FeatureAppearance.transparency]]. */\r\n  transparency?: number;\r\n  /** @see [[FeatureAppearance.viewDependentTransparency]]. */\r\n  viewDependentTransparency?: true;\r\n  /** @see [[FeatureAppearance.linePixels]]. */\r\n  linePixels?: LinePixels;\r\n  /** @see [[FeatureAppearance.ignoresMaterial]]. */\r\n  ignoresMaterial?: true;\r\n  /** @see [[FeatureAppearance.nonLocatable]]. */\r\n  nonLocatable?: true;\r\n  /** @see [[FeatureAppearance.emphasized]]. */\r\n  emphasized?: true;\r\n}\r\n\r\n/** Defines overrides for selected aspects of a [[Feature]]'s symbology.\r\n * Any member defined in the appearance overrides that aspect of symbology for all [[Feature]]s to which the appearance is applied.\r\n * @see [[FeatureOverrides]] to customize the appearance of multiple features.\r\n * @public\r\n */\r\nexport class FeatureAppearance {\r\n  /** Overrides the feature's color. */\r\n  public readonly rgb?: RgbColor;\r\n  /** The width of lines and edges in pixels as an integer in [1, 31]. */\r\n  public readonly weight?: number;\r\n  /** The transparency in the range [0, 1] where 0 indicates fully opaque and 1 indicates fully transparent.\r\n   * @see [[viewDependentTransparency]] for details on how this override interacts with the [DisplayStyle]($backend).\r\n   */\r\n  public readonly transparency?: number;\r\n  /** The pixel pattern applied to lines and edges. */\r\n  public readonly linePixels?: LinePixels;\r\n  /** If true, don't apply the [[RenderMaterial]] to the feature's surfaces. */\r\n  public readonly ignoresMaterial?: true;\r\n  /** If true, the feature will not be drawn when using [Viewport.readPixels]($frontend), meaning [Tool]($frontend)s will not be able to interact with it. */\r\n  public readonly nonLocatable?: true;\r\n  /** If true, the feature will be rendered using the [[Hilite.Settings]] defined by [Viewport.emphasisSettings]($frontend) to make it stand out. */\r\n  public readonly emphasized?: true;\r\n  /** If true, then [[transparency]] will only be applied if [[ViewFlags.transparency]] is enabled and the current [[RenderMode]] supports transparency.\r\n   * Default: false, meaning the transparency will be applied regardless of view flags or render mode.\r\n   * This property has no effect if [[transparency]] is `undefined`.\r\n   */\r\n  public readonly viewDependentTransparency?: true;\r\n\r\n  /** An appearance that overrides nothing. */\r\n  public static readonly defaults = new FeatureAppearance({});\r\n\r\n  public static fromJSON(props?: FeatureAppearanceProps) {\r\n    if (undefined === props || (undefined === props.rgb && undefined === props.weight && undefined === props.transparency && undefined === props.linePixels && !props.ignoresMaterial && !props.nonLocatable && !props.emphasized))\r\n      return this.defaults;\r\n    else\r\n      return new FeatureAppearance(props);\r\n  }\r\n\r\n  /** Create a FeatureAppearance that overrides only the RGB color.\r\n   * @note The transparency component of the ColorDef is ignored.\r\n   */\r\n  public static fromRgb(color: ColorDef): FeatureAppearance {\r\n    return this.fromJSON({ rgb: RgbColor.fromColorDef(color) });\r\n  }\r\n\r\n  /** Create a FeatureAppearance that overrides the RGB and transparency.\r\n   * The appearance's transparency is derived from the transparency component of the ColorDef.\r\n   */\r\n  public static fromRgba(color: ColorDef, viewDependentTransparency = false): FeatureAppearance {\r\n    return this.fromJSON({\r\n      rgb: RgbColor.fromColorDef(color),\r\n      transparency: color.colors.t / 255,\r\n      viewDependentTransparency: viewDependentTransparency ? true : undefined,\r\n    });\r\n  }\r\n  /** Create a FeatureAppearance that overrides only the transparency */\r\n  public static fromTransparency(transparencyValue: number, viewDependent = false): FeatureAppearance {\r\n    return this.fromJSON({\r\n      transparency: transparencyValue,\r\n      viewDependentTransparency: viewDependent ? true : undefined,\r\n    });\r\n  }\r\n\r\n  /** Create a FeatureAppearance with overrides corresponding to those defined by the supplied SubCategoryOverride.\r\n   * @note Subcategory overrides set [[viewDependentTransparency]] to `true`.\r\n   */\r\n  public static fromSubCategoryOverride(ovr: SubCategoryOverride): FeatureAppearance {\r\n    const rgb = undefined !== ovr.color ? RgbColor.fromColorDef(ovr.color) : undefined;\r\n    const transparency = ovr.transparency;\r\n    const weight = ovr.weight;\r\n    const ignoresMaterial = undefined !== ovr.material && Id64.isValid(ovr.material) ? true : undefined;\r\n    return this.fromJSON({ rgb, transparency, weight, ignoresMaterial, viewDependentTransparency: true });\r\n  }\r\n\r\n  /** Returns true if this appearance does not override any aspects of symbology. */\r\n  public get matchesDefaults(): boolean {\r\n    return this.equals(FeatureAppearance.defaults);\r\n  }\r\n\r\n  public get overridesRgb(): boolean { return undefined !== this.rgb; }\r\n  public get overridesTransparency(): boolean { return undefined !== this.transparency; }\r\n  public get overridesLinePixels(): boolean { return undefined !== this.linePixels; }\r\n  public get overridesWeight(): boolean { return undefined !== this.weight; }\r\n  public get overridesSymbology(): boolean {\r\n    return this.overridesRgb || this.overridesTransparency || this.overridesWeight || this.overridesLinePixels || !!this.ignoresMaterial\r\n      || this.emphasized || this.overridesNonLocatable;\r\n  }\r\n  public get overridesNonLocatable(): boolean { return undefined !== this.nonLocatable; }\r\n  public get isFullyTransparent(): boolean { return undefined !== this.transparency && this.transparency >= 1.0; }\r\n  /** Returns true if any aspect of the appearance is overridden (i.e., if any member is not undefined). */\r\n  public get anyOverridden(): boolean { return this.overridesSymbology || this.overridesNonLocatable; }\r\n\r\n  public equals(other: FeatureAppearance): boolean {\r\n    if (this === other)\r\n      return true;\r\n\r\n    return this.rgbIsEqual(other.rgb)\r\n      && this.weight === other.weight\r\n      && this.transparencyIsEqual(other.transparency)\r\n      && this.linePixels === other.linePixels\r\n      && this.ignoresMaterial === other.ignoresMaterial\r\n      && this.nonLocatable === other.nonLocatable\r\n      && this.emphasized === other.emphasized\r\n      && this.viewDependentTransparency === other.viewDependentTransparency;\r\n  }\r\n\r\n  public toJSON(): FeatureAppearanceProps {\r\n    const props: FeatureAppearanceProps = {};\r\n    if (this.rgb)\r\n      props.rgb = this.rgb.toJSON();\r\n\r\n    if (undefined !== this.weight)\r\n      props.weight = this.weight;\r\n\r\n    if (undefined !== this.transparency) {\r\n      props.transparency = this.transparency;\r\n      if (this.viewDependentTransparency)\r\n        props.viewDependentTransparency = true;\r\n    }\r\n\r\n    if (undefined !== this.linePixels)\r\n      props.linePixels = this.linePixels;\r\n\r\n    if (true === this.ignoresMaterial)\r\n      props.ignoresMaterial = true;\r\n\r\n    if (true === this.nonLocatable)\r\n      props.nonLocatable = true;\r\n\r\n    if (true === this.emphasized)\r\n      props.emphasized = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Convert this appearance to JSON, and override any properties explicitly specified by `changedProps` in the result.\r\n   * Example:\r\n   * ```ts\r\n   *  const base = FeatureAppearance.fromRgba(ColorDef.white); // transparency=0, rgb=white\r\n   *  const clone = base.cloneProps({ transparency: undefined, weight: 5 }); // transparency=undefined, rgb=white, weight=5\r\n   * ```\r\n   * @see [[FeatureAppearance.clone]].\r\n   */\r\n  public cloneProps(changedProps: FeatureAppearanceProps): FeatureAppearanceProps {\r\n    return {\r\n      ...this.toJSON(),\r\n      ...changedProps,\r\n    };\r\n  }\r\n\r\n  /** Create a copy of this appearance, overriding any properties explicitly specified by `changedProps`.\r\n   * Example:\r\n   * ```ts\r\n   *  const base = FeatureAppearance.fromRgba(ColorDef.white); // transparency=0, rgb=white\r\n   *  const clone = base.clone({ transparency: undefined, weight: 5 }); // transparency=undefined, rgb=white, weight=5\r\n   * ```\r\n   * @see [[FeatureAppearance.cloneProps]].\r\n   */\r\n  public clone(changedProps: FeatureAppearanceProps): FeatureAppearance {\r\n    return FeatureAppearance.fromJSON(this.cloneProps(changedProps));\r\n  }\r\n\r\n  /** Produce a FeatureAppearance from the supplied appearance in which any aspect not defined by the base appearance is overridden by this appearance. */\r\n  public extendAppearance(base: FeatureAppearance): FeatureAppearance {\r\n    if (!this.overridesSymbology)\r\n      return base;\r\n\r\n    const props = base.toJSON();\r\n    if (undefined === props.rgb) props.rgb = this.rgb;\r\n    if (undefined === props.transparency) props.transparency = this.transparency;\r\n    if (undefined === props.linePixels) props.linePixels = this.linePixels;\r\n    if (undefined === props.weight) props.weight = this.weight;\r\n    if (undefined === props.ignoresMaterial && this.ignoresMaterial) props.ignoresMaterial = true;\r\n    if (undefined === props.nonLocatable && this.nonLocatable) props.nonLocatable = true;\r\n    if (undefined === props.emphasized && this.emphasized) props.emphasized = true;\r\n\r\n    if (undefined !== props.transparency && this.viewDependentTransparency)\r\n      props.viewDependentTransparency = true;\r\n\r\n    return FeatureAppearance.fromJSON(props);\r\n  }\r\n\r\n  protected constructor(props: FeatureAppearanceProps) {\r\n    this.rgb = undefined !== props.rgb ? RgbColor.fromJSON(props.rgb) : undefined;\r\n    this.weight = props.weight;\r\n    this.transparency = props.transparency;\r\n    this.linePixels = props.linePixels;\r\n    this.ignoresMaterial = props.ignoresMaterial;\r\n    this.nonLocatable = props.nonLocatable;\r\n    this.emphasized = props.emphasized;\r\n\r\n    if (undefined !== this.weight)\r\n      this.weight = Math.max(1, Math.min(this.weight, 32));\r\n\r\n    if (undefined !== this.transparency) {\r\n      if (props.viewDependentTransparency)\r\n        this.viewDependentTransparency = true;\r\n\r\n      this.transparency = Math.max(0, Math.min(this.transparency, 1));\r\n\r\n      // Fix up rounding errors...\r\n      const smallDelta = 0.0001;\r\n      if (1.0 - this.transparency < smallDelta)\r\n        this.transparency = 1.0;\r\n      else if (this.transparency < smallDelta)\r\n        this.transparency = 0.0;\r\n    }\r\n  }\r\n\r\n  private rgbIsEqual(rgb?: RgbColor): boolean {\r\n    if (undefined === this.rgb)\r\n      return undefined === rgb;\r\n    else if (undefined === rgb)\r\n      return false;\r\n    else\r\n      return this.rgb.equals(rgb);\r\n  }\r\n\r\n  private transparencyIsEqual(transp?: number): boolean {\r\n    if (undefined === this.transparency)\r\n      return undefined === transp;\r\n    else if (undefined === transp)\r\n      return false;\r\n    else\r\n      return Math.floor(this.transparency * 0xff) === Math.floor(transp * 0xff);\r\n  }\r\n}\r\n\r\n/** Interface adopted by an object that can supply a [[FeatureAppearance]] given a low-level description of a [[Feature]].\r\n * @see [[FeatureOverrides]] for the commonly-used implementation.\r\n * @see [[FeatureAppearanceProvider]] to supplement the appearance supplied by this interface.\r\n * @public\r\n */\r\nexport interface FeatureAppearanceSource {\r\n  /** Supplies the desired appearance overrides for the specified [[Feature]], or `undefined` if the feature should not be drawn.\r\n   * The feature is described by its components for efficiency reasons.\r\n   * @param elemLo The lower 32 bits of the feature's element Id.\r\n   * @param elemHi The upper 32 bits of the feature's element Id.\r\n   * @param subcatLo The lower 32 bits of the feature's subcategory Id.\r\n   * @param subcatHi The upper 32 bits of the feature's subcategory Id.\r\n   * @param geomClass The geometry class of the feature.\r\n   * @param modelLo The lower 32 bits of the feature's model Id.\r\n   * @param modelHi The upper 32 bits of the feature's model Id.\r\n   * @param type The type of batch to which the feature belongs.\r\n   * @param animationNodeId The Id of the corresponding node in the [[RenderSchedule]], or `0` if none.\r\n   * @returns The desired appearance overrides, or `undefined` to indicate the feature should not be displayed.\r\n   * @see [Id64.isValidUint32Pair]($core-bentley) to determine if the components of an [Id64String]($core-bentley) represent a valid Id.\r\n   */\r\n  getAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined;\r\n}\r\n\r\n/** Common options for [[FeatureOverrides.override]].\r\n * @public\r\n */\r\nexport interface OverrideFeatureAppearanceOptions {\r\n  /** Specifies the aspects of the [[Feature]]'s appearance to be overridden. */\r\n  appearance: FeatureAppearance;\r\n  /** Specifies what to do if a [[FeatureAppearance]] has already been configured for the specified element, model, or subcategory by a previous call to [[FeatureOverrides.override]].\r\n   *  - \"subsume\" (the default): Merge the two appearances using the logic described by [[FeatureAppearance.extendAppearance]] such that any aspect overridden by the existing appearance will be overwritten\r\n   *    if also overridden by [[appearance]].\r\n   *    - The resulting appearance is computed as `existingAppearance.extendAppearance(newAppearance)`.\r\n   *  - \"extend\": Merge the two appearances using the logic described by [[FeatureAppearance.extendAppearance]] such that any aspect overridden by [[appearance]] will only\r\n   *    apply if that aspect is not already overridden by a previous appearance.\r\n   *    - The resulting appearance is computed as `newAppearance.extendAppearance(existingAppearance)`.\r\n   *  - \"replace\": Completely replace the existing appearance with [[appearance]].\r\n   *  - \"skip\": Keep the existing appearance.\r\n   */\r\n  onConflict?: \"extend\" | \"subsume\" | \"replace\" | \"skip\";\r\n}\r\n\r\n/** Options for using [[FeatureOverrides.override]] to override the appearance of a [GeometricModel]($backend).\r\n * @public\r\n */\r\nexport interface OverrideModelAppearanceOptions extends OverrideFeatureAppearanceOptions {\r\n  /** The Id of the model whose appearance is to be overridden. */\r\n  modelId: Id64String;\r\n  /** @internal */\r\n  elementId?: never;\r\n  /** @internal */\r\n  subCategoryId?: never;\r\n}\r\n\r\n/** Options for using [[FeatureOverrides.override]] to override the appearance of a [GeometricElement]($backend).\r\n * @public\r\n */\r\nexport interface OverrideElementAppearanceOptions extends OverrideFeatureAppearanceOptions {\r\n  /** The Id of the element whose appearance is to be overridden. */\r\n  elementId: Id64String;\r\n  /** @internal */\r\n  modelId?: never;\r\n  /** @internal */\r\n  subCategoryId?: never;\r\n}\r\n\r\n/** Options for using [[FeatureOverrides.override]] to override the appearance of a [SubCategory]($backend).\r\n * @public\r\n */\r\nexport interface OverrideSubCategoryAppearanceOptions extends OverrideFeatureAppearanceOptions {\r\n  /** The Id of the subcategory whose appearance is to be overridden. */\r\n  subCategoryId: Id64String;\r\n  /** @internal */\r\n  modelId?: never;\r\n  /** @internal */\r\n  elementId?: never;\r\n}\r\n\r\n/** Arguments supplied to [[FeatureOverrides.override]].\r\n * @public\r\n */\r\nexport type OverrideFeatureAppearanceArgs = OverrideElementAppearanceOptions | OverrideModelAppearanceOptions | OverrideSubCategoryAppearanceOptions;\r\n\r\n/** Specifies how to customize the appearance of individual [[Feature]]s, typically within the context of a [Viewport]($frontend).\r\n * Individual aspects of a feature's appearance - like visibility, color, and transparency - are overridden by supplying a [[FeatureAppearance]].\r\n * Those overrides can be specified on the basis of the feature's model, element, and/or subcategory. A default set of overrides can also be specified to\r\n * apply to the appearance of any feature not otherwise overridden.\r\n *\r\n * It is possible to override multiple aspects of a feature on different bases. For example, you might specify that all features belonging to subcategory \"A\" should be drawn in red,\r\n * and that all features belonging to model \"B\" should be drawn 50% transparent. In this case, a feature belonging to both subcategory \"A\" and model \"B\" will be drawn as 50% transparent red -\r\n * the separate overrides are combined to produce the feature's overall appearance.\r\n *\r\n * In the case of conflicts, there is an order of precedence:\r\n *  - Model overrides take highest precedence.\r\n *  - Element overrides are of higher precedence than subcategory overrides.\r\n *  - Subcategory overrides have lowest precedence.\r\n *\r\n * For example, you might specify that all features belonging to subcategory \"A\" should be drawn in red, and all those belonging to model \"B\" should be drawn in green.\r\n * Then a feature belonging to subcategory \"A\" and model \"B\" will be drawn in green, because the model overrides take precedence.\r\n *\r\n * Instances of this class are not typically instantiated by an application directly; instead, an application can implement a [FeatureOverrideProvider]($frontend)\r\n * that augments the overrides supplied by a viewport.\r\n *\r\n * @see [FeatureSymbology.Overrides]($frontend) to create overrides specific to a [Viewport]($frontend) or [ViewState]($frontend).\r\n * @see [FeatureOverrideProvider]($frontend) to customize the appearance of features within a [Viewport]($frontend).\r\n * @public\r\n */\r\nexport class FeatureOverrides implements FeatureAppearanceSource {\r\n  /** Ids of elements that should never be drawn. This takes precedence over [[alwaysDrawn]]. @internal */\r\n  protected readonly _neverDrawn = new Id64.Uint32Set();\r\n  /** Ids of elements that should always be drawn. [[neverDrawn]] takes precedence over this set. @internal */\r\n  protected readonly _alwaysDrawn = new Id64.Uint32Set();\r\n  /** If true, no elements *except* those defined in the \"always drawn\" set will be drawn.\r\n   * @see [[setAlwaysDrawn]]\r\n   */\r\n  public isAlwaysDrawnExclusive = false;\r\n  /** If true, the always-drawn elements are drawn even if their subcategories are not visible.\r\n   * @see [[setAlwaysDrawn]]\r\n   */\r\n  public alwaysDrawnIgnoresSubCategory = true;\r\n  /** If true, all subcategories are considered visible. This is used for drawing sheets via section callouts in the absence of an actual sheet view.\r\n   * @internal\r\n   */\r\n  public ignoreSubCategory = false;\r\n\r\n  /** Overrides applied to any feature not explicitly overridden. @internal */\r\n  protected _defaultOverrides = FeatureAppearance.defaults;\r\n  /** Whether construction geometry should be drawn. @internal */\r\n  protected _constructions = false;\r\n  /** Whether dimensions should be drawn. @internal */\r\n  protected _dimensions = false;\r\n  /** Whether area patterns should be drawn. @internal */\r\n  protected _patterns = false;\r\n  /** Whether line weights should be applied. If false, all lines are rendered 1-pixel wide. @internal */\r\n  protected _lineWeights = true;\r\n\r\n  /** Overrides applied to all elements belonging to each model. @internal */\r\n  protected readonly _modelOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** Overrides applied to specific elements. @internal */\r\n  protected readonly _elementOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** Overrides applied to geometry belonging to each subcategory. @internal */\r\n  protected readonly _subCategoryOverrides = new Id64.Uint32Map<FeatureAppearance>();\r\n  /** The set of displayed subcategories. Geometry belonging to subcategories not included in this set will not be drawn. @internal */\r\n  protected readonly _visibleSubCategories = new Id64.Uint32Set();\r\n  /** Display priorities assigned to subcategories, possibly overridden by display style. Only applicable for plan projection models. @internal */\r\n  protected readonly _subCategoryPriorities = new Id64.Uint32Map<number>();\r\n\r\n  /** Per-model, a set of subcategories whose visibility should be inverted for elements within that model.\r\n   * Populated by Viewport.\r\n   * @internal\r\n   */\r\n  protected readonly _modelSubCategoryOverrides = new Id64.Uint32Map<Id64.Uint32Set>();\r\n\r\n  /** Ids of animation nodes that should never be drawn.\r\n   * @internal\r\n   */\r\n  public readonly neverDrawnAnimationNodes = new Set<number>();\r\n  /** Mapping of animation node Ids to overrides applied to the corresponding animation nodes.\r\n   * @internal\r\n   */\r\n  public readonly animationNodeOverrides = new Map<number, FeatureAppearance>();\r\n\r\n  /** Overrides applied to features for which no other overrides are defined */\r\n  public get defaultOverrides(): FeatureAppearance { return this._defaultOverrides; }\r\n  /** Whether or not line weights are applied. If false, all lines are drawn with a weight of 1. */\r\n  public get lineWeights(): boolean { return this._lineWeights; }\r\n\r\n  /** @internal */\r\n  public get neverDrawn() { return this._neverDrawn; }\r\n  /** @internal */\r\n  public get alwaysDrawn() { return this._alwaysDrawn; }\r\n\r\n  /** @internal */\r\n  protected isNeverDrawn(elemIdLo: number, elemIdHi: number, animationNodeId: number): boolean {\r\n    if (this._neverDrawn.has(elemIdLo, elemIdHi))\r\n      return true;\r\n    else\r\n      return this.neverDrawnAnimationNodes.has(animationNodeId);\r\n  }\r\n  /** @internal */\r\n  protected isAlwaysDrawn(idLo: number, idHi: number): boolean { return this._alwaysDrawn.has(idLo, idHi); }\r\n  /** Returns true if the [SubCategory]($backend) specified by Id is in the set of visible subcategories. @internal */\r\n  public isSubCategoryVisible(idLo: number, idHi: number): boolean { return this._visibleSubCategories.has(idLo, idHi); }\r\n  /** @internal */\r\n  public isSubCategoryVisibleInModel(subcatLo: number, subcatHi: number, modelLo: number, modelHi: number): boolean {\r\n    if (this.ignoreSubCategory)\r\n      return true;\r\n\r\n    let vis = this.isSubCategoryVisible(subcatLo, subcatHi);\r\n    const modelOvr = this._modelSubCategoryOverrides.get(modelLo, modelHi);\r\n    if (undefined !== modelOvr && modelOvr.has(subcatLo, subcatHi))\r\n      vis = !vis;\r\n\r\n    return vis;\r\n  }\r\n\r\n  /** @internal */\r\n  protected getModelOverrides(idLo: number, idHi: number): FeatureAppearance | undefined { return this._modelOverrides.get(idLo, idHi); }\r\n  /** @internal */\r\n  protected getElementOverrides(idLo: number, idHi: number, animationNodeId: number): FeatureAppearance | undefined {\r\n    const app = this._elementOverrides.get(idLo, idHi);\r\n    if (app !== undefined)\r\n      return app;\r\n\r\n    return this.animationNodeOverrides.get(animationNodeId);\r\n  }\r\n  /** @internal */\r\n  protected getSubCategoryOverrides(idLo: number, idHi: number): FeatureAppearance | undefined { return this._subCategoryOverrides.get(idLo, idHi); }\r\n\r\n  /** Add a [SubCategory]($backend) to the set of visible subcategories. */\r\n  public setVisibleSubCategory(id: Id64String): void { this._visibleSubCategories.addId(id); }\r\n  /** Specify the Id of an element that should never be drawn. */\r\n  public setNeverDrawn(id: Id64String): void { this._neverDrawn.addId(id); }\r\n  /** Specify the Id of an element that should always be drawn. */\r\n  public setAlwaysDrawn(id: Id64String): void { this._alwaysDrawn.addId(id); }\r\n  /** Specify the Id of a animation node that should never be drawn. */\r\n  public setAnimationNodeNeverDrawn(id: number): void { this.neverDrawnAnimationNodes.add(id); }\r\n  /** Specify the Ids of elements that should never be drawn. */\r\n  public setNeverDrawnSet(ids: Iterable<Id64String>) { copyIdSetToUint32Set(this._neverDrawn, ids); }\r\n  /** Specify the Ids of elements that should always be drawn. */\r\n  public setAlwaysDrawnSet(ids: Iterable<Id64String>, exclusive: boolean, ignoreSubCategory = true) {\r\n    copyIdSetToUint32Set(this._alwaysDrawn, ids);\r\n    this.isAlwaysDrawnExclusive = exclusive;\r\n    this.alwaysDrawnIgnoresSubCategory = ignoreSubCategory;\r\n  }\r\n\r\n  /** Returns the feature's appearance overrides, or undefined if the feature is not visible. */\r\n  public getFeatureAppearance(feature: Feature, modelId: Id64String, type: BatchType = BatchType.Primary, animationNodeId = 0): FeatureAppearance | undefined {\r\n    return this.getAppearance(\r\n      Id64.getLowerUint32(feature.elementId), Id64.getUpperUint32(feature.elementId),\r\n      Id64.getLowerUint32(feature.subCategoryId), Id64.getUpperUint32(feature.subCategoryId),\r\n      feature.geometryClass,\r\n      Id64.getLowerUint32(modelId), Id64.getUpperUint32(modelId),\r\n      type, animationNodeId);\r\n  }\r\n\r\n  private static readonly _weight1Appearance = FeatureAppearance.fromJSON({ weight: 1 });\r\n\r\n  /** Returns a feature's appearance overrides, or undefined if the feature is not visible.\r\n   * Takes Id64s as pairs of unsigned 32-bit integers for efficiency, because that is how they are stored by the PackedFeatureTable associated with each batch of graphics.\r\n   * @see [[getFeatureAppearance]] for an equivalent function that accepts [Id64String]($core-bentley)s instead of integer pairs.\r\n   */\r\n  public getAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined {\r\n    if (BatchType.VolumeClassifier === type || BatchType.PlanarClassifier === type)\r\n      return this.getClassifierAppearance(elemLo, elemHi, subcatLo, subcatHi, modelLo, modelHi, animationNodeId);\r\n\r\n    let app = !this._lineWeights ? FeatureOverrides._weight1Appearance : FeatureAppearance.defaults;\r\n    const modelApp = this.getModelOverrides(modelLo, modelHi);\r\n    if (undefined !== modelApp)\r\n      app = modelApp.extendAppearance(app);\r\n\r\n    // Is the element visible?\r\n    let elemApp, alwaysDrawn = false;\r\n\r\n    if (Id64.isValidUint32Pair(elemLo, elemHi)) {\r\n      if (this.isNeverDrawn(elemLo, elemHi, animationNodeId))\r\n        return undefined;\r\n\r\n      alwaysDrawn = this.isAlwaysDrawn(elemLo, elemHi);\r\n      if (!alwaysDrawn && this.isAlwaysDrawnExclusive)\r\n        return undefined;\r\n\r\n      // Element overrides take precedence\r\n      elemApp = this.getElementOverrides(elemLo, elemHi, animationNodeId);\r\n      if (undefined !== elemApp)\r\n        app = undefined !== modelApp ? elemApp.extendAppearance(app) : elemApp;\r\n    }\r\n\r\n    let subCatApp;\r\n    if (!this.ignoreSubCategory && Id64.isValidUint32Pair(subcatLo, subcatHi)) {\r\n      if ((!alwaysDrawn || !this.alwaysDrawnIgnoresSubCategory) && !this.isSubCategoryVisibleInModel(subcatLo, subcatHi, modelLo, modelHi))\r\n        return undefined;\r\n\r\n      subCatApp = this.getSubCategoryOverrides(subcatLo, subcatHi);\r\n      if (undefined !== subCatApp)\r\n        app = subCatApp.extendAppearance(app);\r\n    }\r\n\r\n    // Only apply default if *no* appearance was explicitly registered (doesn't matter if registered appearance does not actually override anything)\r\n    if (undefined === elemApp && undefined === modelApp && undefined === subCatApp)\r\n      app = this._defaultOverrides.extendAppearance(app);\r\n\r\n    let visible = alwaysDrawn || this.isClassVisible(geomClass);\r\n    if (visible && app.isFullyTransparent)\r\n      visible = false; // don't bother rendering something with full transparency...\r\n\r\n    return visible ? app : undefined;\r\n  }\r\n\r\n  /** Classifiers behave totally differently...in particular they are never invisible unless fully-transparent.\r\n   * @internal\r\n   */\r\n  protected getClassifierAppearance(elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, modelLo: number, modelHi: number, animationNodeId: number): FeatureAppearance | undefined {\r\n    let app = FeatureAppearance.defaults;\r\n    const modelApp = this.getModelOverrides(modelLo, modelHi);\r\n    if (undefined !== modelApp)\r\n      app = modelApp.extendAppearance(app);\r\n\r\n    const elemApp = this.getElementOverrides(elemLo, elemHi, animationNodeId);\r\n    if (undefined !== elemApp)\r\n      app = undefined !== modelApp ? elemApp.extendAppearance(app) : elemApp;\r\n\r\n    if (!this.ignoreSubCategory && Id64.isValidUint32Pair(subcatLo, subcatHi)) {\r\n      const subCat = this.getSubCategoryOverrides(subcatLo, subcatHi);\r\n      if (undefined !== subCat)\r\n        app = subCat.extendAppearance(app);\r\n    }\r\n\r\n    if (undefined === elemApp && undefined === modelApp)\r\n      app = this._defaultOverrides.extendAppearance(app);\r\n\r\n    // NB: A fully-transparent classifier means the classifier is a clip mask - classified pixels will be discarded.\r\n    return app;\r\n  }\r\n\r\n  /** Return whether geometry of the specified class should be drawn.\r\n   * @see [[ViewFlags.constructions]], [[ViewFlags.dimensions]], and [[ViewFlags.patterns]].\r\n   */\r\n  public isClassVisible(geomClass: GeometryClass): boolean {\r\n    switch (geomClass) {\r\n      case GeometryClass.Construction: return this._constructions;\r\n      case GeometryClass.Dimension: return this._dimensions;\r\n      case GeometryClass.Pattern: return this._patterns;\r\n      default: return true;\r\n    }\r\n  }\r\n\r\n  /** Specify overrides for all elements belonging to a specified [GeometricModel]($backend), or all geometry belonging to a specified [GeometricElement]($backend) or [SubCategory]($backend). */\r\n  public override(args: OverrideFeatureAppearanceArgs): void {\r\n    let id: Id64String;\r\n    let map: Id64.Uint32Map<FeatureAppearance>;\r\n    if (undefined !== args.elementId) {\r\n      id = args.elementId;\r\n      map = this._elementOverrides;\r\n    } else if (undefined !== args.modelId) {\r\n      id = args.modelId;\r\n      map = this._modelOverrides;\r\n    } else {\r\n      id = args.subCategoryId;\r\n      map = this._subCategoryOverrides;\r\n    }\r\n\r\n    let app = args.appearance;\r\n    const idLo = Id64.getLowerUint32(id);\r\n    const idHi = Id64.getUpperUint32(id);\r\n\r\n    if (undefined !== args.elementId && this.isNeverDrawn(idLo, idHi, 0))\r\n      return;\r\n\r\n    const replace = \"replace\" === args.onConflict;\r\n    const existing = replace ? undefined : map.get(idLo, idHi);\r\n    if (existing) {\r\n      assert(\"replace\" !== args.onConflict);\r\n      switch (args.onConflict) {\r\n        case \"skip\":\r\n          return;\r\n        case \"extend\":\r\n          app = app.extendAppearance(existing);\r\n          break;\r\n        default:\r\n          app = existing.extendAppearance(app);\r\n          break;\r\n      }\r\n    }\r\n\r\n    map.set(idLo, idHi, app);\r\n  }\r\n\r\n  /** Specify overrides for all elements within the specified model.\r\n   * @param id The Id of the model.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same model.\r\n   * @note These overrides take priority over all other overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to any element within this model, even if the supplied appearance overrides nothing.\r\n   * @deprecated Use [[FeatureOverrides.override]].\r\n   */\r\n  public overrideModel(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    this.override({ modelId: id, appearance: app, onConflict: replaceExisting ? \"replace\" : \"skip\" });\r\n  }\r\n\r\n  /** Specify overrides for all geometry belonging to the specified [SubCategory]($backend).\r\n   * @param id The Id of the subcategory.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same subcategory.\r\n   * @note These overrides have lower priority than element and model overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to any geometry within this subcategory, even if the supplied appearance overrides nothing.\r\n   * @deprecated Use [[FeatureOverrides.override]].\r\n   */\r\n  public overrideSubCategory(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    this.override({ subCategoryId: id, appearance: app, onConflict: replaceExisting ? \"replace\" : \"skip\" });\r\n  }\r\n\r\n  /** Specify overrides for all geometry originating from the specified element.\r\n   * @param id The Id of the element.\r\n   * @param app The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace a pre-existing override for the same element.\r\n   * @note These overrides take precedence over subcategory overrides, but not over model overrides.\r\n   * @note If [[defaultOverrides]] are defined, they will not apply to this element, even if the supplied appearance overrides nothing.\r\n   * @deprecated Use [[FeatureOverrides.override]].\r\n   */\r\n  public overrideElement(id: Id64String, app: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    this.override({ elementId: id, appearance: app, onConflict: replaceExisting ? \"replace\" : \"skip\" });\r\n  }\r\n\r\n  /** Specify overrides for all geometry originating from the specified animation node.\r\n   * @param id The Id of the animation node.\r\n   * @param app The symbology overrides.\r\n   * @note These overrides do not take precedence over element overrides.\r\n   */\r\n  public overrideAnimationNode(id: number, app: FeatureAppearance): void {\r\n    this.animationNodeOverrides.set(id, app);\r\n  }\r\n\r\n  /** Defines a default appearance to be applied to any [[Feature]] *not* explicitly overridden.\r\n   * @param appearance The symbology overrides.\r\n   * @param replaceExisting Specifies whether to replace the current default overrides if they are already defined.\r\n   */\r\n  public setDefaultOverrides(appearance: FeatureAppearance, replaceExisting: boolean = true): void {\r\n    if (replaceExisting || !appearance.overridesSymbology)\r\n      this._defaultOverrides = appearance;\r\n  }\r\n\r\n  /** Get the display priority of a subcategory. This is only relevant when using [[PlanProjectionSettings]].\r\n   * @internal\r\n   */\r\n  public getSubCategoryPriority(idLo: number, idHi: number): number {\r\n    return this._subCategoryPriorities.get(idLo, idHi) ?? 0;\r\n  }\r\n\r\n  /** Construct a new Overrides that overrides nothing.\r\n   * @see [FeatureSymbology.Overrides]($frontend) to construct overrides based on a [ViewState]($frontend) or [Viewport]($frontend).\r\n   */\r\n  public constructor() {\r\n    //\r\n  }\r\n\r\n  /** Returns true if geometry belonging to the specified subcategory will be drawn. */\r\n  public isSubCategoryIdVisible(id: Id64String): boolean { return this.isSubCategoryVisible(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n  /** Returns the overrides applied to geometry belonging to the specified model, if any such are defined. */\r\n  public getModelOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getModelOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n  /** Returns the overrides applied to geometry belonging to the specified element, if any such are defined. */\r\n  public getElementOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getElementOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id), 0); }\r\n  /** Returns the overrides applied to geometry belonging to the specified subcategory, if any such are defined. */\r\n  public getSubCategoryOverridesById(id: Id64String): FeatureAppearance | undefined { return this.getSubCategoryOverrides(Id64.getLowerUint32(id), Id64.getUpperUint32(id)); }\r\n\r\n  /** Returns true if the specified Feature will be drawn. */\r\n  public isFeatureVisible(feature: Feature): boolean {\r\n    const { elementId, subCategoryId, geometryClass } = feature;\r\n    const isValidElemId = !Id64.isInvalid(elementId);\r\n    const elemIdParts = isValidElemId ? Id64.getUint32Pair(elementId) : undefined;\r\n\r\n    if (undefined !== elemIdParts && this.isNeverDrawn(elemIdParts.lower, elemIdParts.upper, 0))\r\n      return false;\r\n\r\n    const alwaysDrawn = undefined !== elemIdParts && this.isAlwaysDrawn(elemIdParts.lower, elemIdParts.upper);\r\n    if (alwaysDrawn || this.isAlwaysDrawnExclusive)\r\n      return alwaysDrawn;\r\n\r\n    // NB: This ignores per-model subcategory visibility overrides, because caller did not specify a model.\r\n    if (!this.isSubCategoryIdVisible(subCategoryId))\r\n      return false;\r\n\r\n    return this.isClassVisible(geometryClass);\r\n  }\r\n}\r\n\r\n/** Interface adopted by an object that can supply the [[FeatureAppearance]] supplied by a [[FeatureAppearanceSource]].\r\n * This is useful for selectively overriding or agumenting a [Viewport]($frontend)'s symbology overrides.\r\n * A typical implementation will invoke [[FeatureAppearanceSource.getAppeaprance]] and customize the returned appearance.\r\n * @see [[FeatureAppearanceProvider.chain]] to chain two providers together.\r\n * @public\r\n */\r\nexport interface FeatureAppearanceProvider {\r\n  /** Supply the desired appearance overrides for the specified [[Feature]], or `undefined` if the feature should not be drawn.\r\n   * The feature is described by its components for efficiency reasons.\r\n   * @param source The base symbology overrides, e.g., typically defined by a [Viewport]($frontend).\r\n   * @param elemLo The lower 32 bits of the feature's element Id.\r\n   * @param elemHi The upper 32 bits of the feature's element Id.\r\n   * @param subcatLo The lower 32 bits of the feature's subcategory Id.\r\n   * @param subcatHi The upper 32 bits of the feature's subcategory Id.\r\n   * @param geomClass The geometry class of the feature.\r\n   * @param modelLo The lower 32 bits of the feature's model Id.\r\n   * @param modelHi The upper 32 bits of the feature's model Id.\r\n   * @param type The type of batch to which the feature belongs.\r\n   * @param animationNodeId The Id of the corresponding node in the [[RenderSchedule]], or `0` if none.\r\n   * @returns The desired appearance overrides, or `undefined` to indicate the feature should not be displayed.\r\n   * @see [[FeatureAppearanceSource.getAppearance]] to forward the request to the source.\r\n   * @see [Id64.isValidUint32Pair]($core-bentley) to determine if the components of an [Id64String]($core-bentley) represent a valid Id.\r\n   */\r\n  getFeatureAppearance(source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number): FeatureAppearance | undefined;\r\n}\r\n\r\n/** @public */\r\nexport namespace FeatureAppearanceProvider {\r\n  /** Produce a FeatureAppearanceSource for which `getAppearance()` returns the appearance specified in `source`, potentially modified by `provider`. */\r\n  function wrap(source: FeatureAppearanceSource, provider: FeatureAppearanceProvider): FeatureAppearanceSource {\r\n    return {\r\n      getAppearance: (elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        return provider.getFeatureAppearance(source, elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n      },\r\n    };\r\n  }\r\n\r\n  /** Create a provider that obtains each feature's appearance from the source, and if the feature is visible, modifies the appearance.\r\n   * @param supplementAppearance A function accepting the feature's base appearance and returning a supplemental appearance.\r\n   * @public\r\n   */\r\n  export function supplement(supplementAppearance: (appearance: FeatureAppearance) => FeatureAppearance): FeatureAppearanceProvider {\r\n    return {\r\n      getFeatureAppearance: (source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        const app = source.getAppearance(elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n        return app ? supplementAppearance(app) : app;\r\n      },\r\n    };\r\n  }\r\n\r\n  /** Chain two FeatureAppearanceProviders together such that `first`'s `getFeatureAppearance` function is applied before `second`'s.\r\n   * If `second` invokes `source.getAppearance()`, the returned appearance will include any modifications applied by `first`.\r\n   * @public\r\n   */\r\n  export function chain(first: FeatureAppearanceProvider, second: FeatureAppearanceProvider): FeatureAppearanceProvider {\r\n    if (first === second)\r\n      return first;\r\n\r\n    return {\r\n      getFeatureAppearance: (source: FeatureAppearanceSource, elemLo: number, elemHi: number, subcatLo: number, subcatHi: number, geomClass: GeometryClass, modelLo: number, modelHi: number, type: BatchType, animationNodeId: number) => {\r\n        return second.getFeatureAppearance(wrap(source, first), elemLo, elemHi, subcatLo, subcatHi, geomClass, modelLo, modelHi, type, animationNodeId);\r\n      },\r\n    };\r\n  }\r\n}\r\n"]}

package/lib/esm/GeoCoordinateServices.d.ts

@@ -3,15 +3,53 @@
  */
 import { GeoServiceStatus } from "@itwin/core-bentley";
 import { XYZProps } from "@itwin/core-geometry";
-/** @public */
+import { GeographicCRSProps } from "./geometry/CoordinateReferenceSystem";
+/** This enumeration lists all possible status as returned from a coordinate conversion to or from a
+ * [[GeographicCRS]] and either another [[GeographicCRS]] or a [[GeodeticDatum]].
+ * @see the [[PointWithStatus]] included in an [[IModelCoordinatesResponseProps]] or [[GeoCoordinatesResponseProps]].
+ * @public
+ */
 export declare enum GeoCoordStatus {
+    /** Indicates successful coordinate conversion. */
     Success = 0,
+    /** Indicates that the source or target of the conversion is not defined, usually the iModel Geographic Coordinate Reference System.*/
     NoGCSDefined = 100,
+    /** This value indicates that the conversion was performed outside of the normal use of application of either Geographic Coordinate Reference Systems.
+     *  This return value can often be treated as a warning in specific cases. For example, global imagery extent spans the whole globe and
+     *  may extend far beyond the normal area of the iModel project extents and the extent of normal use of its Geographic Coordinate Reference System.
+     *  In such cases this value can be considered a warning as accuracy and precision is not expected in this specific case and approximate localization
+     *  of global imagery or other low accuracy context data is not essential far from the project.
+     *  If this status is returned for high accuracy data then it indicates that either Geographic Coordinate Reference Systems were inappropriately selected
+     *  for the iModel or other geolocated data. If this is the case the status should be somehow reported so action
+     *  can be performed to verify used geolocation parameters.
+     *  In either case the returned coordinates are to be considered valid though they may be inaccurate or result in some unexpected distortion of graphical
+     *  elements.
+     */
     OutOfUsefulRange = 1,
+    /** Indicates a hard error where conversions were requested outside of the area of the mathematical capacity of the conversion process for either
+     *  Geographic Coordinate Reference Systems involved. An example could be to attempt a conversion involving a Transverse Mercator more than 60 degrees
+     *  East or West of the projection central meridian.
+     *  The values returned may or may not be valid and should be discarded.
+     */
     OutOfMathematicalDomain = 2,
+    /** Indicates that datum transformation between the two Geographic Coordinate Reference Systems could not be performed.
+     *  This error is usually the result of a datum transformation path requiring use of latitude/longitude grid shift files that could not be obtained
+     *  or installed. In this case the latitude/longitude transformation is bypassed but the remainder of the conversion process is completed.
+     *  This error can be ignored for low accuracy data but should be somehow reported so actions can be performed to provide the missing files.
+     */
     NoDatumConverter = 25,
+    /** Indicates that a problem occurred during vertical datum conversion. This may the result of the inability to access the
+     *  Geoid separation data or vertical datum differential data (such as used by NGVD29 to NAVD88 conversion).
+     *  The horizontal coordinates returned are valid but the elevation ordinate will be returned unchanged or partially changed.
+     *  This status should be somehow reported so actions can be performed to provide the missing information.
+     */
     VerticalDatumConvertError = 26,
+    /** General inner conversion engine error. Coordinates returned are invalid and should be discarded */
     CSMapError = 4096,
+    /** This temporary status is used to mark coordinates for which the conversion has not yet been processed by the backend
+     *  as opposed to other coordinate conversions that may have been resolved otherwise (typically a cache).
+     *  At the completion of the conversion promise no coordinates should have this status.
+     */
     Pending = -41556
 }
 /** Maps a GeoCoordStatus to the equivalent GeoServiceStatus.
@@ -51,4 +89,31 @@ export interface GeoCoordinatesResponseProps {
     geoCoords: PointWithStatus[];
     fromCache: number;
 }
+/** Information required to interpret or complete a Geographic CRS in the specified format.
+ *  The only currently supported formats are JSON (for completion) and WKT (OGC Well Known Text)
+ * @beta
+ */
+export interface GeographicCRSInterpretRequestProps {
+    /** The format of the geographic CRS definition provided in the geographicCRSDef property. */
+    format: "WKT" | "JSON";
+    /** The geographic CRS definition in the format specified in the format property.
+     *  Note that when the WKT is used the WKT fragment provided can start with a COMPD_CS clause
+     *  which should then contain both the horizontal CRS definition as well as the vertical CRS specification.
+     *  WKT fragments starting with PROJCS or GEOGCS are also supported but the vertical CRS will be assigned a
+     *  default value.
+    */
+    geographicCRSDef: string;
+}
+/** Information returned from a request to interpret or complete a Geographic CRS
+ * @beta
+ */
+export interface GeographicCRSInterpretResponseProps {
+    /** The result status of the interpret operation. A value of zero indicates successful interpretation.
+     *  Any value other than zero is to be considered a hard error and no valid result will
+     *  be returned in the geographicCRS property.
+    */
+    status: number;
+    /** The property that receives the interpreted geographic CRS if the process was successful. */
+    geographicCRS?: GeographicCRSProps;
+}
 //# sourceMappingURL=GeoCoordinateServices.d.ts.map

package/lib/esm/GeoCoordinateServices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeoCoordinateServices.d.ts","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,cAAc;AACd,oBAAY,cAAc;IACxB,OAAO,IAAI;IACX,YAAY,MAAM;IAClB,gBAAgB,IAAI;IACpB,uBAAuB,IAAI;IAC3B,gBAAgB,KAAK;IACrB,yBAAyB,KAAK;IAC9B,UAAU,OAAO;IACjB,OAAO,SAAS;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAazE;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,QAAQ,CAAC;IACZ,CAAC,EAAE,cAAc,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"GeoCoordinateServices.d.ts","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E;;;;GAIG;AACH,oBAAY,cAAc;IACxB,kDAAkD;IAClD,OAAO,IAAI;IACX,sIAAsI;IACtI,YAAY,MAAM;IAClB;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI;IACpB;;;;OAIG;IACH,uBAAuB,IAAI;IAC3B;;;;OAIG;IACH,gBAAgB,KAAK;IACrB;;;;OAIG;IACH,yBAAyB,KAAK;IAC9B,sGAAsG;IACtG,UAAU,OAAO;IACjB;;;OAGG;IACH,OAAO,SAAS;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAazE;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,QAAQ,CAAC;IACZ,CAAC,EAAE,cAAc,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,6FAA6F;IAC7F,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB;;;;;MAKE;IACF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;MAGE;IACF,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC"}