@itwin/core-common 4.0.0-dev.4 → 4.0.0-dev.40

package/lib/cjs/SkyBox.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkyBox.js","sourceRoot":"","sources":["../../src/SkyBox.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { Id64, Id64String, NonFunctionPropertiesOf } from \"@itwin/core-bentley\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { TextureImageSpec } from \"./RenderTexture\";\r\n\r\n/** Supported types of [[SkyBox]] images.\r\n * @see [[SkyBoxImageProps]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SkyBoxImageType {\r\n  /** No image, indicating a [[SkyGradient]] should be displayed. */\r\n  None = 0,\r\n  /** A single image mapped to the surface of a sphere.\r\n   * @see [[SkySphere]].\r\n   */\r\n  Spherical = 1,\r\n  /** @internal not yet supported */\r\n  Cylindrical = 2,\r\n  /** Six images mapped to the faces of a cube.\r\n   * @see [[SkyCube]].\r\n   */\r\n  Cube = 3,\r\n}\r\n\r\n/** JSON representation of the six images used by a [[SkyCube]].\r\n * Each property specifies the image for a face of the cube as either an image URL, or the Id of a [Texture]($backend) element.\r\n * Each image must be square and have the same dimensions as all the other images.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SkyCubeProps {\r\n  front: TextureImageSpec;\r\n  back: TextureImageSpec;\r\n  top: TextureImageSpec;\r\n  bottom: TextureImageSpec;\r\n  right: TextureImageSpec;\r\n  left: TextureImageSpec;\r\n}\r\n\r\n/** JSON representation of the image used for a [[SkySphere]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n */\r\nexport interface SkySphereImageProps {\r\n  type: SkyBoxImageType.Spherical;\r\n  texture: TextureImageSpec;\r\n  /** @internal */\r\n  textures?: never;\r\n}\r\n\r\n/** JSON representation of the images used for a [[SkyCube]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n */\r\nexport interface SkyCubeImageProps {\r\n  type: SkyBoxImageType.Cube;\r\n  textures: SkyCubeProps;\r\n  /** @internal */\r\n  texture?: never;\r\n}\r\n\r\n/** JSON representation of the image(s) to be mapped to the surfaces of a [[SkyBox]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n * @extensions\r\n */\r\nexport type SkyBoxImageProps = SkySphereImageProps | SkyCubeImageProps | { type?: SkyBoxImageType, texture?: never, textures?: never };\r\n\r\n/** JSON representation of a [[SkyBox]] that can be drawn as the background of a [ViewState3d]($frontend).\r\n * An object of this type can describe one of several types of sky box:\r\n *  - A cube with a texture image mapped to each face; or\r\n *  - A sphere with a single texture image mapped to its surface; or\r\n *  - A sphere with a two- or four-color vertical [[Gradient]] mapped to its surface.\r\n *\r\n * Whether cuboid or spherical, the skybox is drawn as if the viewer and the contents of the view are contained within its interior.\r\n *\r\n * For a two-color gradient, the gradient transitions smoothly from the nadir color at the bottom of the sphere to the zenith color at the top of the sphere.\r\n * The sky and ground colors are unused, as are the sky and ground exponents.\r\n *\r\n * For a four-color gradient, a \"horizon\" is produced on the equator of the sphere, where the ground color and sky color meet. The lower half of the sphere transitions\r\n * smoothly from the ground color at the equator to the nadir color at the bottom, and the upper half transitions from the sky color at the equator to the zenith color at\r\n * the top of the sphere.\r\n *\r\n * The color and exponent properties are unused if one or more texture images are supplied.\r\n *\r\n * @see [[DisplayStyle3dSettings.environment]] to define the skybox for a display style.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SkyBoxProps {\r\n  /** Whether or not the skybox should be displayed.\r\n   * Default: false.\r\n   */\r\n  display?: boolean;\r\n  /** For a [[SkyGradient]], if true, a 2-color gradient skybox is used instead of a 4-color.\r\n   * Default: false.\r\n   */\r\n  twoColor?: boolean;\r\n  /** The color of the sky at the horizon. Unused unless this is a four-color [[SkyGradient]].\r\n   * Default: (143, 205, 255).\r\n   */\r\n  skyColor?: ColorDefProps;\r\n  /** The color of the ground at the horizon. Unused unless this is a four-color [[SkyGradient]].\r\n   * Default: (120, 143, 125).\r\n   */\r\n  groundColor?: ColorDefProps;\r\n  /** The color of the top of the sphere.\r\n   * Default: (54, 117, 255).\r\n   */\r\n  zenithColor?: ColorDefProps;\r\n  /** The color of the bottom of the sphere.\r\n   * Default: (40, 15, 0).\r\n   */\r\n  nadirColor?: ColorDefProps;\r\n  /** For a 4-color [[SkyGradient]], controls speed of change from sky color to zenith color; otherwise unused.\r\n   * Default: 4.0.\r\n   */\r\n  skyExponent?: number;\r\n  /** For a 4-color [[SkyGradient]], controls speed of change from ground color to nadir color; otherwise unused.\r\n   * Default: 4.0.\r\n   */\r\n  groundExponent?: number;\r\n  /** The image(s), if any, to be mapped to the surfaces of the sphere or cube. If undefined, the skybox will be displayed as a gradient instead.\r\n   * Default: undefined.\r\n   */\r\n  image?: SkyBoxImageProps;\r\n}\r\n\r\nconst defaultGroundColor = ColorDef.from(143, 205, 125);\r\nconst defaultZenithColor = ColorDef.from(54, 117, 255);\r\nconst defaultNadirColor = ColorDef.from(40, 125, 0);\r\nconst defaultSkyColor = ColorDef.from(142, 205, 255);\r\nconst defaultExponent = 4.0;\r\n\r\nfunction colorDefFromJson(props?: ColorDefProps): ColorDef | undefined {\r\n  return undefined !== props ? ColorDef.fromJSON(props) : undefined;\r\n}\r\n\r\n/** A type containing all of the properties and none of the methods of [[SkyGradient]] with `readonly` modifiers removed.\r\n * @see [[SkyGradient.create]] and [[SkyGradient.clone]].\r\n * @public\r\n */\r\nexport type SkyGradientProperties = NonFunctionPropertiesOf<SkyGradient>;\r\n\r\n/** Describes how to map a two- or four-color [[Gradient]] to the interior of a sphere to produce a [[SkyBox]].\r\n * @see [[SkyBox.gradient]].\r\n * @public\r\n */\r\nexport class SkyGradient {\r\n  public readonly twoColor: boolean;\r\n  public readonly skyColor: ColorDef;\r\n  public readonly groundColor: ColorDef;\r\n  public readonly zenithColor: ColorDef;\r\n  public readonly nadirColor: ColorDef;\r\n  public readonly skyExponent: number;\r\n  public readonly groundExponent: number;\r\n\r\n  private constructor(args: Partial<SkyGradientProperties>) {\r\n    this.twoColor = args.twoColor ?? false;\r\n    this.skyColor = args.skyColor ?? defaultSkyColor;\r\n    this.groundColor = args.groundColor ?? defaultGroundColor;\r\n    this.nadirColor = args.nadirColor ?? defaultNadirColor;\r\n    this.zenithColor = args.zenithColor ?? defaultZenithColor;\r\n    this.skyExponent = args.skyExponent ?? defaultExponent;\r\n    this.groundExponent = args.groundExponent ?? defaultExponent;\r\n  }\r\n\r\n  /** Default settings for a four-color gradient. */\r\n  public static readonly defaults = new SkyGradient({});\r\n\r\n  /** Create a new gradient. Any properties not specified by `props` are initialized to their default values. */\r\n  public static create(props?: Partial<SkyGradientProperties>): SkyGradient {\r\n    return props ? new this(props) : this.defaults;\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: SkyBoxProps): SkyGradient {\r\n    if (!props)\r\n      return this.defaults;\r\n\r\n    return new this({\r\n      twoColor: props.twoColor,\r\n      skyExponent: props.skyExponent,\r\n      groundExponent: props.groundExponent,\r\n      skyColor: colorDefFromJson(props.skyColor),\r\n      groundColor: colorDefFromJson(props.groundColor),\r\n      nadirColor: colorDefFromJson(props.nadirColor),\r\n      zenithColor: colorDefFromJson(props.zenithColor),\r\n    });\r\n  }\r\n\r\n  /** Create ea copy of this gradient, identical except for any properties explicitly specified by `changedProps`.\r\n   * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.\r\n   */\r\n  public clone(changedProps: SkyGradientProperties): SkyGradient {\r\n    return new SkyGradient({ ...this, ...changedProps });\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): SkyBoxProps {\r\n    const props: SkyBoxProps = {\r\n      skyColor: this.skyColor.toJSON(),\r\n      groundColor: this.groundColor.toJSON(),\r\n      nadirColor: this.nadirColor.toJSON(),\r\n      zenithColor: this.zenithColor.toJSON(),\r\n    };\r\n\r\n    if (this.groundExponent !== defaultExponent)\r\n      props.groundExponent = this.groundExponent;\r\n\r\n    if (this.skyExponent !== defaultExponent)\r\n      props.skyExponent = this.skyExponent;\r\n\r\n    if (this.twoColor)\r\n      props.twoColor = this.twoColor;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Returns true if this gradient is equivalent to the supplied gradient. */\r\n  public equals(other: SkyGradient): boolean {\r\n    if (this === other)\r\n      return true;\r\n\r\n    return this.twoColor === other.twoColor && this.skyColor.equals(other.skyColor) && this.groundColor.equals(other.groundColor) &&\r\n      this.zenithColor.equals(other.zenithColor) && this.nadirColor.equals(other.nadirColor);\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky, as part of an [[Environment]].\r\n * @see [[SkyBoxProps]].\r\n * @public\r\n */\r\nexport class SkyBox {\r\n  /** The gradient settings, used if no cube or sphere images are supplied, or if the images cannot be loaded. */\r\n  public readonly gradient: SkyGradient;\r\n\r\n  protected constructor(gradient: SkyGradient) {\r\n    this.gradient = gradient;\r\n  }\r\n\r\n  /** Default settings for a four-color gradient. */\r\n  public static readonly defaults = new SkyBox(SkyGradient.defaults);\r\n\r\n  /** Create a skybox that displays the specified gradient, or the default gradient if none is supplied. */\r\n  public static createGradient(gradient?: SkyGradient): SkyBox {\r\n    return gradient ? new this(gradient) : this.defaults;\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: SkyBoxProps): SkyBox {\r\n    const gradient = SkyGradient.fromJSON(props);\r\n\r\n    if (props?.image) {\r\n      switch (props.image.type) {\r\n        case SkyBoxImageType.Spherical:\r\n          if (undefined !== props.image.texture)\r\n            return new SkySphere(props.image.texture, gradient);\r\n\r\n          break;\r\n        case SkyBoxImageType.Cube: {\r\n          const tx = props.image.textures;\r\n          if (tx && undefined !== tx.top && undefined !== tx.bottom && undefined !== tx.right && undefined !== tx.left && undefined !== tx.front && undefined !== tx.back)\r\n            return new SkyCube(tx, gradient);\r\n\r\n          break;\r\n        }\r\n      }\r\n    }\r\n\r\n    return this.createGradient(gradient);\r\n  }\r\n\r\n  /** Convert to JSON representation.\r\n   * @param display If defined, the value to use for [[SkyBoxProps.display]]; otherwise, that property will be left undefined.\r\n   */\r\n  public toJSON(display?: boolean): SkyBoxProps {\r\n    const props = this.gradient.toJSON();\r\n    if (undefined !== display)\r\n      props.display = display;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public get textureIds(): Iterable<Id64String> {\r\n    return [];\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky by mapping a single image to the interior of a sphere.\r\n * @public\r\n */\r\nexport class SkySphere extends SkyBox {\r\n  /** The image to map to the interior of the sphere. */\r\n  public readonly image: TextureImageSpec;\r\n\r\n  /** Create a new sky sphere using the specified image.\r\n   * @param image The image to map to the interior of the sphere.\r\n   * @param gradient Optionally overrides the default gradient settings used if the image cannot be obtained.\r\n   */\r\n  public constructor(image: TextureImageSpec, gradient?: SkyGradient) {\r\n    super(gradient ?? SkyGradient.defaults);\r\n    this.image = image;\r\n  }\r\n\r\n  /** @internal override */\r\n  public override toJSON(display?: boolean): SkyBoxProps {\r\n    const props = super.toJSON(display);\r\n    props.image = {\r\n      type: SkyBoxImageType.Spherical,\r\n      texture: this.image,\r\n    };\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public override get textureIds(): Iterable<Id64String> {\r\n    return Id64.isValidId64(this.image) ? [this.image] : [];\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky by mapping images to the interior faces of a cube.\r\n * The images are required to be *square*, and each image must have the same dimensions as the other images.\r\n * @public\r\n */\r\nexport class SkyCube extends SkyBox {\r\n  /** The images to map to each face of the cube. */\r\n  public readonly images: SkyCubeProps;\r\n\r\n  /** Create a new sky cube using the specified images.\r\n   * @param images The images to map to each face of the cube.\r\n   * @param Optionally overrides  the default gradient settings used if the images cannot be obtained.\r\n   */\r\n  public constructor(images: SkyCubeProps, gradient?: SkyGradient) {\r\n    super(gradient ?? SkyGradient.defaults);\r\n    this.images = { ...images };\r\n  }\r\n\r\n  /** @internal override */\r\n  public override toJSON(display?: boolean): SkyBoxProps {\r\n    const props = super.toJSON(display);\r\n    props.image = {\r\n      type: SkyBoxImageType.Cube,\r\n      textures: { ...this.images },\r\n    };\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public override get textureIds(): Iterable<Id64String> {\r\n    const imgs = this.images;\r\n    return [imgs.front, imgs.back, imgs.top, imgs.bottom, imgs.left, imgs.right].filter((x) => Id64.isValidId64(x));\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SkyBox.js","sourceRoot":"","sources":["../../src/SkyBox.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { Id64, Id64String, NonFunctionPropertiesOf } from \"@itwin/core-bentley\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { TextureImageSpec } from \"./RenderTexture\";\r\n\r\n/** Supported types of [[SkyBox]] images.\r\n * @see [[SkyBoxImageProps]].\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SkyBoxImageType {\r\n  /** No image, indicating a [[SkyGradient]] should be displayed. */\r\n  None = 0,\r\n  /** A single image mapped to the surface of a sphere.\r\n   * @see [[SkySphere]].\r\n   */\r\n  Spherical = 1,\r\n  /** @internal not yet supported */\r\n  Cylindrical = 2,\r\n  /** Six images mapped to the faces of a cube.\r\n   * @see [[SkyCube]].\r\n   */\r\n  Cube = 3,\r\n}\r\n\r\n/** JSON representation of the six images used by a [[SkyCube]].\r\n * Each property specifies the image for a face of the cube as either an image URL, or the Id of a [Texture]($backend) element.\r\n * Each image must be square and have the same dimensions as all the other images.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SkyCubeProps {\r\n  front: TextureImageSpec;\r\n  back: TextureImageSpec;\r\n  top: TextureImageSpec;\r\n  bottom: TextureImageSpec;\r\n  right: TextureImageSpec;\r\n  left: TextureImageSpec;\r\n}\r\n\r\n/** JSON representation of the image used for a [[SkySphere]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n */\r\nexport interface SkySphereImageProps {\r\n  type: SkyBoxImageType.Spherical;\r\n  texture: TextureImageSpec;\r\n  /** @internal */\r\n  textures?: never;\r\n}\r\n\r\n/** JSON representation of the images used for a [[SkyCube]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n */\r\nexport interface SkyCubeImageProps {\r\n  type: SkyBoxImageType.Cube;\r\n  textures: SkyCubeProps;\r\n  /** @internal */\r\n  texture?: never;\r\n}\r\n\r\n/** JSON representation of the image(s) to be mapped to the surfaces of a [[SkyBox]].\r\n * @see [[SkyBoxProps.image]].\r\n * @public\r\n * @extensions\r\n */\r\nexport type SkyBoxImageProps = SkySphereImageProps | SkyCubeImageProps | { type?: SkyBoxImageType, texture?: never, textures?: never };\r\n\r\n/** JSON representation of a [[SkyBox]] that can be drawn as the background of a [ViewState3d]($frontend).\r\n * An object of this type can describe one of several types of sky box:\r\n *  - A cube with a texture image mapped to each face; or\r\n *  - A sphere with a single texture image mapped to its surface; or\r\n *  - A sphere with a two- or four-color vertical [[Gradient]] mapped to its surface.\r\n *\r\n * Whether cuboid or spherical, the skybox is drawn as if the viewer and the contents of the view are contained within its interior.\r\n *\r\n * For a two-color gradient, the gradient transitions smoothly from the nadir color at the bottom of the sphere to the zenith color at the top of the sphere.\r\n * The sky and ground colors are unused, as are the sky and ground exponents.\r\n *\r\n * For a four-color gradient, a \"horizon\" is produced on the equator of the sphere, where the ground color and sky color meet. The lower half of the sphere transitions\r\n * smoothly from the ground color at the equator to the nadir color at the bottom, and the upper half transitions from the sky color at the equator to the zenith color at\r\n * the top of the sphere.\r\n *\r\n * The color and exponent properties are unused if one or more texture images are supplied.\r\n *\r\n * @see [[DisplayStyle3dSettings.environment]] to define the skybox for a display style.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SkyBoxProps {\r\n  /** Whether or not the skybox should be displayed.\r\n   * Default: false.\r\n   */\r\n  display?: boolean;\r\n  /** For a [[SkyGradient]], if true, a 2-color gradient skybox is used instead of a 4-color.\r\n   * Default: false.\r\n   */\r\n  twoColor?: boolean;\r\n  /** The color of the sky at the horizon. Unused unless this is a four-color [[SkyGradient]].\r\n   * Default: (143, 205, 255).\r\n   */\r\n  skyColor?: ColorDefProps;\r\n  /** The color of the ground at the horizon. Unused unless this is a four-color [[SkyGradient]].\r\n   * Default: (120, 143, 125).\r\n   */\r\n  groundColor?: ColorDefProps;\r\n  /** The color of the top of the sphere.\r\n   * Default: (54, 117, 255).\r\n   */\r\n  zenithColor?: ColorDefProps;\r\n  /** The color of the bottom of the sphere.\r\n   * Default: (40, 15, 0).\r\n   */\r\n  nadirColor?: ColorDefProps;\r\n  /** For a 4-color [[SkyGradient]], controls speed of change from sky color to zenith color; otherwise unused.\r\n   * Default: 4.0.\r\n   */\r\n  skyExponent?: number;\r\n  /** For a 4-color [[SkyGradient]], controls speed of change from ground color to nadir color; otherwise unused.\r\n   * Default: 4.0.\r\n   */\r\n  groundExponent?: number;\r\n  /** The image(s), if any, to be mapped to the surfaces of the sphere or cube. If undefined, the skybox will be displayed as a gradient instead.\r\n   * Default: undefined.\r\n   */\r\n  image?: SkyBoxImageProps;\r\n}\r\n\r\nconst defaultGroundColor = ColorDef.from(143, 205, 125);\r\nconst defaultZenithColor = ColorDef.from(54, 117, 255);\r\nconst defaultNadirColor = ColorDef.from(40, 125, 0);\r\nconst defaultSkyColor = ColorDef.from(142, 205, 255);\r\nconst defaultExponent = 4.0;\r\n\r\nfunction colorDefFromJson(props?: ColorDefProps): ColorDef | undefined {\r\n  return undefined !== props ? ColorDef.fromJSON(props) : undefined;\r\n}\r\n\r\n/** A type containing all of the properties and none of the methods of [[SkyGradient]] with `readonly` modifiers removed.\r\n * @see [[SkyGradient.create]] and [[SkyGradient.clone]].\r\n * @public\r\n */\r\nexport type SkyGradientProperties = NonFunctionPropertiesOf<SkyGradient>;\r\n\r\n/** Describes how to map a two- or four-color [[Gradient]] to the interior of a sphere to produce a [[SkyBox]].\r\n * @see [[SkyBox.gradient]].\r\n * @public\r\n */\r\nexport class SkyGradient {\r\n  public readonly twoColor: boolean;\r\n  public readonly skyColor: ColorDef;\r\n  public readonly groundColor: ColorDef;\r\n  public readonly zenithColor: ColorDef;\r\n  public readonly nadirColor: ColorDef;\r\n  public readonly skyExponent: number;\r\n  public readonly groundExponent: number;\r\n\r\n  private constructor(args: Partial<SkyGradientProperties>) {\r\n    this.twoColor = args.twoColor ?? false;\r\n    this.skyColor = args.skyColor ?? defaultSkyColor;\r\n    this.groundColor = args.groundColor ?? defaultGroundColor;\r\n    this.nadirColor = args.nadirColor ?? defaultNadirColor;\r\n    this.zenithColor = args.zenithColor ?? defaultZenithColor;\r\n    this.skyExponent = args.skyExponent ?? defaultExponent;\r\n    this.groundExponent = args.groundExponent ?? defaultExponent;\r\n  }\r\n\r\n  /** Default settings for a four-color gradient. */\r\n  public static readonly defaults = new SkyGradient({});\r\n\r\n  /** Create a new gradient. Any properties not specified by `props` are initialized to their default values. */\r\n  public static create(props?: Partial<SkyGradientProperties>): SkyGradient {\r\n    return props ? new this(props) : this.defaults;\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: SkyBoxProps): SkyGradient {\r\n    if (!props)\r\n      return this.defaults;\r\n\r\n    return new this({\r\n      twoColor: props.twoColor,\r\n      skyExponent: props.skyExponent,\r\n      groundExponent: props.groundExponent,\r\n      skyColor: colorDefFromJson(props.skyColor),\r\n      groundColor: colorDefFromJson(props.groundColor),\r\n      nadirColor: colorDefFromJson(props.nadirColor),\r\n      zenithColor: colorDefFromJson(props.zenithColor),\r\n    });\r\n  }\r\n\r\n  /** Create ea copy of this gradient, identical except for any properties explicitly specified by `changedProps`.\r\n   * Any properties of `changedProps` explicitly set to `undefined` will be reset to their default values.\r\n   */\r\n  public clone(changedProps: SkyGradientProperties): SkyGradient {\r\n    return new SkyGradient({ ...this, ...changedProps });\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): SkyBoxProps {\r\n    const props: SkyBoxProps = {\r\n      skyColor: this.skyColor.toJSON(),\r\n      groundColor: this.groundColor.toJSON(),\r\n      nadirColor: this.nadirColor.toJSON(),\r\n      zenithColor: this.zenithColor.toJSON(),\r\n    };\r\n\r\n    if (this.groundExponent !== defaultExponent)\r\n      props.groundExponent = this.groundExponent;\r\n\r\n    if (this.skyExponent !== defaultExponent)\r\n      props.skyExponent = this.skyExponent;\r\n\r\n    if (this.twoColor)\r\n      props.twoColor = this.twoColor;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Returns true if this gradient is equivalent to the supplied gradient. */\r\n  public equals(other: SkyGradient): boolean {\r\n    if (this === other)\r\n      return true;\r\n\r\n    return this.twoColor === other.twoColor && this.skyColor.equals(other.skyColor) && this.groundColor.equals(other.groundColor) &&\r\n      this.zenithColor.equals(other.zenithColor) && this.nadirColor.equals(other.nadirColor);\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky, as part of an [[Environment]].\r\n * @see [[SkyBoxProps]].\r\n * @public\r\n */\r\nexport class SkyBox {\r\n  /** The gradient settings, used if no cube or sphere images are supplied, or if the images cannot be loaded. */\r\n  public readonly gradient: SkyGradient;\r\n\r\n  protected constructor(gradient: SkyGradient) {\r\n    this.gradient = gradient;\r\n  }\r\n\r\n  /** Default settings for a four-color gradient. */\r\n  public static readonly defaults = new SkyBox(SkyGradient.defaults);\r\n\r\n  /** Create a skybox that displays the specified gradient, or the default gradient if none is supplied. */\r\n  public static createGradient(gradient?: SkyGradient): SkyBox {\r\n    return gradient ? new this(gradient) : this.defaults;\r\n  }\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: SkyBoxProps): SkyBox {\r\n    const gradient = SkyGradient.fromJSON(props);\r\n\r\n    if (props?.image) {\r\n      switch (props.image.type) {\r\n        case SkyBoxImageType.Spherical:\r\n          if (undefined !== props.image.texture)\r\n            return new SkySphere(props.image.texture, gradient);\r\n\r\n          break;\r\n        case SkyBoxImageType.Cube: {\r\n          const tx = props.image.textures;\r\n          if (tx && undefined !== tx.top && undefined !== tx.bottom && undefined !== tx.right && undefined !== tx.left && undefined !== tx.front && undefined !== tx.back)\r\n            return new SkyCube(tx, gradient);\r\n\r\n          break;\r\n        }\r\n      }\r\n    }\r\n\r\n    return this.createGradient(gradient);\r\n  }\r\n\r\n  /** Convert to JSON representation.\r\n   * @param display If defined, the value to use for [[SkyBoxProps.display]]; otherwise, that property will be left undefined.\r\n   */\r\n  public toJSON(display?: boolean): SkyBoxProps {\r\n    const props = this.gradient.toJSON();\r\n    if (undefined !== display)\r\n      props.display = display;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public get textureIds(): Iterable<Id64String> {\r\n    return [];\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky by mapping a single image to the interior of a sphere.\r\n * @public\r\n */\r\nexport class SkySphere extends SkyBox {\r\n  /** The image to map to the interior of the sphere. */\r\n  public readonly image: TextureImageSpec;\r\n\r\n  /** Create a new sky sphere using the specified image.\r\n   * @param image The image to map to the interior of the sphere.\r\n   * @param gradient Optionally overrides the default gradient settings used if the image cannot be obtained.\r\n   */\r\n  public constructor(image: TextureImageSpec, gradient?: SkyGradient) {\r\n    super(gradient ?? SkyGradient.defaults);\r\n    this.image = image;\r\n  }\r\n\r\n  /** @internal override */\r\n  public override toJSON(display?: boolean): SkyBoxProps {\r\n    const props = super.toJSON(display);\r\n    props.image = {\r\n      type: SkyBoxImageType.Spherical,\r\n      texture: this.image,\r\n    };\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public override get textureIds(): Iterable<Id64String> {\r\n    return Id64.isValidId64(this.image) ? [this.image] : [];\r\n  }\r\n}\r\n\r\n/** Describes how to draw a representation of a sky by mapping images to the interior faces of a cube.\r\n * The images are required to be *square*, and each image must have the same dimensions as the other images.\r\n * @public\r\n */\r\nexport class SkyCube extends SkyBox {\r\n  /** The images to map to each face of the cube. */\r\n  public readonly images: SkyCubeProps;\r\n\r\n  /** Create a new sky cube using the specified images.\r\n   * @param images The images to map to each face of the cube.\r\n   * @param Optionally overrides  the default gradient settings used if the images cannot be obtained.\r\n   */\r\n  public constructor(images: SkyCubeProps, gradient?: SkyGradient) {\r\n    super(gradient ?? SkyGradient.defaults);\r\n    this.images = { ...images };\r\n  }\r\n\r\n  /** @internal override */\r\n  public override toJSON(display?: boolean): SkyBoxProps {\r\n    const props = super.toJSON(display);\r\n    props.image = {\r\n      type: SkyBoxImageType.Cube,\r\n      textures: { ...this.images },\r\n    };\r\n\r\n    return props;\r\n  }\r\n\r\n  /** @internal */\r\n  public override get textureIds(): Iterable<Id64String> {\r\n    const imgs = this.images;\r\n    return [imgs.front, imgs.back, imgs.top, imgs.bottom, imgs.left, imgs.right].filter((x) => Id64.isValidId64(x));\r\n  }\r\n}\r\n"]}

package/lib/cjs/SolarShadows.js

@@ -47,10 +47,9 @@ class SolarShadowSettings {
      * @returns A settings object equivalent to this one except for any properties explicitly overridden by `changedProps`.
      */
     clone(changedProps) {
-        var _a;
         if (!changedProps)
             return this;
-        const props = (_a = this.toJSON()) !== null && _a !== void 0 ? _a : {};
+        const props = this.toJSON() ?? {};
         if (changedProps.color)
             props.color = changedProps.color;
         if (undefined !== changedProps.bias)

package/lib/cjs/SolarShadows.js.map

@@ -1 +1 @@
-{"version":3,"file":"SolarShadows.js","sourceRoot":"","sources":["../../src/SolarShadows.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAgD;AAChD,+CAA4C;AAC5C,yCAAqD;AACrD,yCAAsC;AAatC,MAAM,YAAY,GAAG,mBAAQ,CAAC,YAAY,CAAC,mBAAQ,CAAC,QAAQ,CAAC,yBAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAa,mBAAmB;IAM9B,YAAoB,KAA+B;QACjD,IAAI,CAAC,IAAI,GAAG,wBAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK;YACnD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;;YAE1B,IAAI,CAAC,KAAK,GAAG,mBAAQ,CAAC,YAAY,CAAC,mBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAgC;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAChE,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC7B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,GAAwB;QACpC,OAAO,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAuC;;QAClD,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,MAAM,KAAK,GAAG,MAAA,IAAI,CAAC,MAAM,EAAE,mCAAI,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,KAAK;YACpB,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;QAEnC,IAAI,SAAS,KAAK,YAAY,CAAC,IAAI;YACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAEjC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;;AAvDH,kDAwDC;AA1Ce,4BAAQ,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { ColorByName } from \"./ColorByName\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { RgbColor } from \"./RgbColor\";\r\n\r\n/** JSON representation of [[SolarShadowSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SolarShadowSettingsProps {\r\n  /** Shadow color. Default: [[ColorByName.grey]]. */\r\n  color?: ColorDefProps;\r\n  /** @internal */\r\n  bias?: number;\r\n}\r\n\r\nconst defaultColor = RgbColor.fromColorDef(ColorDef.fromTbgr(ColorByName.grey));\r\n\r\n/** Settings controlling display of solar shadows for a [[DisplayStyle3dSettings]].\r\n * Solar shadows are imposed as a color scaling on geometry occluded from solar lighting.\r\n * @public\r\n */\r\nexport class SolarShadowSettings {\r\n  /** Shadow color. */\r\n  public readonly color: RgbColor;\r\n  /** @internal */\r\n  public readonly bias: number;\r\n\r\n  private constructor(props: SolarShadowSettingsProps) {\r\n    this.bias = JsonUtils.asDouble(props.bias, 0.001);\r\n    if (undefined === props.color || null === props.color)\r\n      this.color = defaultColor;\r\n    else\r\n      this.color = RgbColor.fromColorDef(ColorDef.fromJSON(props.color));\r\n  }\r\n\r\n  public static defaults = new SolarShadowSettings({});\r\n\r\n  public static fromJSON(props?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    return props ? new SolarShadowSettings(props) : this.defaults;\r\n  }\r\n\r\n  public toJSON(): SolarShadowSettingsProps | undefined {\r\n    const defaults = SolarShadowSettings.defaults;\r\n    if (this.equals(defaults))\r\n      return undefined;\r\n\r\n    const props: SolarShadowSettingsProps = {};\r\n    if (!this.color.equals(defaults.color))\r\n      props.color = this.color.toColorDef().toJSON();\r\n\r\n    if (this.bias !== defaults.bias)\r\n      props.bias = this.bias;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(rhs: SolarShadowSettings): boolean {\r\n    return this.bias === rhs.bias && this.color.equals(rhs.color);\r\n  }\r\n\r\n  /** Create a copy of these settings.\r\n   * @param changedProps Any property explicitly defined will be overridden in the copy.\r\n   * @returns A settings object equivalent to this one except for any properties explicitly overridden by `changedProps`.\r\n   */\r\n  public clone(changedProps?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    const props = this.toJSON() ?? {};\r\n    if (changedProps.color)\r\n      props.color = changedProps.color;\r\n\r\n    if (undefined !== changedProps.bias)\r\n      props.bias = changedProps.bias;\r\n\r\n    return SolarShadowSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SolarShadows.js","sourceRoot":"","sources":["../../src/SolarShadows.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAgD;AAChD,+CAA4C;AAC5C,yCAAqD;AACrD,yCAAsC;AAatC,MAAM,YAAY,GAAG,mBAAQ,CAAC,YAAY,CAAC,mBAAQ,CAAC,QAAQ,CAAC,yBAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAa,mBAAmB;IAM9B,YAAoB,KAA+B;QACjD,IAAI,CAAC,IAAI,GAAG,wBAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK;YACnD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;;YAE1B,IAAI,CAAC,KAAK,GAAG,mBAAQ,CAAC,YAAY,CAAC,mBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAgC;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAChE,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC7B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,GAAwB;QACpC,OAAO,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAuC;QAClD,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,KAAK;YACpB,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;QAEnC,IAAI,SAAS,KAAK,YAAY,CAAC,IAAI;YACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAEjC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;;AAvDH,kDAwDC;AA1Ce,4BAAQ,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { ColorByName } from \"./ColorByName\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { RgbColor } from \"./RgbColor\";\r\n\r\n/** JSON representation of [[SolarShadowSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SolarShadowSettingsProps {\r\n  /** Shadow color. Default: [[ColorByName.grey]]. */\r\n  color?: ColorDefProps;\r\n  /** @internal */\r\n  bias?: number;\r\n}\r\n\r\nconst defaultColor = RgbColor.fromColorDef(ColorDef.fromTbgr(ColorByName.grey));\r\n\r\n/** Settings controlling display of solar shadows for a [[DisplayStyle3dSettings]].\r\n * Solar shadows are imposed as a color scaling on geometry occluded from solar lighting.\r\n * @public\r\n */\r\nexport class SolarShadowSettings {\r\n  /** Shadow color. */\r\n  public readonly color: RgbColor;\r\n  /** @internal */\r\n  public readonly bias: number;\r\n\r\n  private constructor(props: SolarShadowSettingsProps) {\r\n    this.bias = JsonUtils.asDouble(props.bias, 0.001);\r\n    if (undefined === props.color || null === props.color)\r\n      this.color = defaultColor;\r\n    else\r\n      this.color = RgbColor.fromColorDef(ColorDef.fromJSON(props.color));\r\n  }\r\n\r\n  public static defaults = new SolarShadowSettings({});\r\n\r\n  public static fromJSON(props?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    return props ? new SolarShadowSettings(props) : this.defaults;\r\n  }\r\n\r\n  public toJSON(): SolarShadowSettingsProps | undefined {\r\n    const defaults = SolarShadowSettings.defaults;\r\n    if (this.equals(defaults))\r\n      return undefined;\r\n\r\n    const props: SolarShadowSettingsProps = {};\r\n    if (!this.color.equals(defaults.color))\r\n      props.color = this.color.toColorDef().toJSON();\r\n\r\n    if (this.bias !== defaults.bias)\r\n      props.bias = this.bias;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(rhs: SolarShadowSettings): boolean {\r\n    return this.bias === rhs.bias && this.color.equals(rhs.color);\r\n  }\r\n\r\n  /** Create a copy of these settings.\r\n   * @param changedProps Any property explicitly defined will be overridden in the copy.\r\n   * @returns A settings object equivalent to this one except for any properties explicitly overridden by `changedProps`.\r\n   */\r\n  public clone(changedProps?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    const props = this.toJSON() ?? {};\r\n    if (changedProps.color)\r\n      props.color = changedProps.color;\r\n\r\n    if (undefined !== changedProps.bias)\r\n      props.bias = changedProps.bias;\r\n\r\n    return SolarShadowSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}

package/lib/cjs/SpatialClassification.js

@@ -224,8 +224,7 @@ class SpatialClassifiers {
     }
     /** The number of classifiers in this set. */
     get size() {
-        var _a, _b;
-        return (_b = (_a = this._array) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+        return this._array?.length ?? 0;
     }
     /** Returns the first classifier that satisfies `criterion`, or `undefined` if no classifier satisfies it. */
     find(criterion) {

package/lib/cjs/SpatialClassification.js.map

@@ -1 +1 @@
-{"version":3,"file":"SpatialClassification.js","sourceRoot":"","sources":["../../src/SpatialClassification.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { assert, Id64String } from \"@itwin/core-bentley\";\r\nimport { ModelMapLayerSettings } from \"./MapLayerSettings\";\r\n\r\n/** Describes how a [[SpatialClassifier]] affects the display of classified geometry - that is, geometry intersecting\r\n * the classifier.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SpatialClassifierInsideDisplay {\r\n  /** The geometry is not displayed. */\r\n  Off = 0,\r\n  /** The geometry is displayed without alteration. */\r\n  On = 1,\r\n  /** The geometry is darkened. */\r\n  Dimmed = 2,\r\n  /** The geometry is tinted by the [Viewport.hilite]($frontend) color. */\r\n  Hilite = 3,\r\n  /** The geometry is tinted with the colors of the classifier elements. */\r\n  ElementColor = 4,\r\n}\r\n\r\n/** Describes how a [[SpatialClassifier]] affects the display of unclassified geometry - that is, geometry not intersecting\r\n * the classifier.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SpatialClassifierOutsideDisplay {\r\n  /** The geometry is not displayed. */\r\n  Off = 0,\r\n  /** The geometry is displayed without alteration. */\r\n  On = 1,\r\n  /** The geometry is darkened. */\r\n  Dimmed = 2,\r\n}\r\n\r\n/** JSON representation of a [[SpatialClassifierFlags]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifierFlagsProps {\r\n  /** See [[SpatialClassifierFlags.inside]]. */\r\n  inside: SpatialClassifierInsideDisplay;\r\n  /** See [[SpatialClassifierFlags.outside]]. */\r\n  outside: SpatialClassifierOutsideDisplay;\r\n  /** See [[SpatialClassifierFlags.isVolumeClassifier]]. */\r\n  isVolumeClassifier?: boolean;\r\n}\r\n\r\n/** Flags affecting how a [[SpatialClassifier]] is applied.\r\n * @public\r\n */\r\nexport class SpatialClassifierFlags {\r\n  /** How geometry intersecting the classifier should be displayed. */\r\n  public readonly inside: SpatialClassifierInsideDisplay;\r\n  /** How geometry not intersecting the classifier should be displayed. */\r\n  public readonly outside: SpatialClassifierOutsideDisplay;\r\n  /** True for volume classification; false for planar classification. */\r\n  public readonly isVolumeClassifier: boolean;\r\n\r\n  /** Construct new flags. */\r\n  public constructor(inside = SpatialClassifierInsideDisplay.ElementColor, outside = SpatialClassifierOutsideDisplay.Dimmed, isVolumeClassifier = false) {\r\n    this.inside = insideDisplay(inside);\r\n    this.outside = outsideDisplay(outside);\r\n    this.isVolumeClassifier = isVolumeClassifier;\r\n  }\r\n\r\n  /** Construct from JSON representation. */\r\n  public static fromJSON(props: SpatialClassifierFlagsProps): SpatialClassifierFlags {\r\n    return new SpatialClassifierFlags(props.inside, props.outside, true === props.isVolumeClassifier);\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): SpatialClassifierFlagsProps {\r\n    const props: SpatialClassifierFlagsProps = {\r\n      inside: this.inside,\r\n      outside: this.outside,\r\n    };\r\n\r\n    if (this.isVolumeClassifier)\r\n      props.isVolumeClassifier = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Create flags indentical to these ones except for any properties explicitly specified by `changedProps`. */\r\n  public clone(changedProps?: Partial<SpatialClassifierFlagsProps>): SpatialClassifierFlags {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return SpatialClassifierFlags.fromJSON({ ...this.toJSON(), ...changedProps });\r\n  }\r\n\r\n  /** Return true if these flags are equivalent to `other`. */\r\n  public equals(other: SpatialClassifierFlags): boolean {\r\n    if (other === this)\r\n      return true;\r\n\r\n    return other.inside === this.inside && other.outside === this.outside && other.isVolumeClassifier === this.isVolumeClassifier;\r\n  }\r\n\r\n  /** Return true if these flags are equivalent to `props`. */\r\n  public equalsProps(props: SpatialClassifierFlagsProps): boolean {\r\n    return this.inside === props.inside && this.outside === props.outside && this.isVolumeClassifier === (true === props.isVolumeClassifier);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[SpatialClassifier]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifierProps {\r\n  /** See [[SpatialClassifier.modelId]]. */\r\n  modelId: Id64String;\r\n  /** See [[SpatialClassifier.expand]]. */\r\n  expand: number;\r\n  /** See [[SpatialClassifier.flags]]. */\r\n  flags: SpatialClassifierFlagsProps;\r\n  /** See [[SpatialClassifier.name]]. */\r\n  name: string;\r\n  /** Records whether this is the active classifier.\r\n   * See [[SpatialClassifier.active]].\r\n   */\r\n  isActive?: boolean;\r\n}\r\n\r\n/** Describes how to use the geometry of one [GeometricModel]($backend) to classify the contents of other models - most typically, reality models.\r\n * Applying a classifier divides the geometry of the classified model into two groups:\r\n *  - Classified (intersecting the classifier); and\r\n *  - Unclassified (not intersecting the classifier).\r\n * For example, a model containing the building footprints for a city block could be used to classify a reality mesh captured from photographs of the\r\n * real-world block. Then, buildings within the reality mesh can be selected individually, and present the properties of the classifier geometry (e.g.,\r\n * the address of the building). The appearance of the geometry can also be customized based using [[SpatialClassifierInsideDisplay]] and [[SpatialClassifierOutsideDisplay]].\r\n * Two types of classification are supported:\r\n *  - Planar classification, in which the geometry of the classifier model is projected onto a plane to classify geometry within a region extruded perpendicular\r\n * the plane (e.g., the building footprints example); and\r\n *  - Volume classification, in which closed, non-intersecting volumes within the classifier classify geometry that intersects (i.e. is contained within) those same volumes (e.g., imagine using boxes instead\r\n * of footprints to classify buildings, or floors of buildings).\r\n * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].\r\n * @see [[SpatialClassifiers]] to define a set of classifiers.\r\n * @see [[ContextRealityModel.classifiers]] to classify a context reality model.\r\n * @see [SpatialModelState.classifiers]($frontend) to classify a persistent reality model.\r\n * @public\r\n */\r\nexport class SpatialClassifier {\r\n  /** The Id of the [GeometricModel]($backend) whose geometry is used to produce the classifier. */\r\n  public readonly modelId: Id64String;\r\n  /** A distance in meters by which to expand the classifier geometry. For example, if line strings are used to represent streets,\r\n   * you might expand them to the average width of a street.\r\n   */\r\n  public readonly expand: number;\r\n  /** Flags controlling how to apply the classifier. */\r\n  public readonly flags: SpatialClassifierFlags;\r\n  /** A user-friendly name, useful for identifying individual classifiers within a [[SpatialClassifiers]]. */\r\n  public readonly name: string;\r\n\r\n  /** Construct a new classifier. */\r\n  public constructor(modelId: Id64String, name: string, flags = new SpatialClassifierFlags(), expand = 0) {\r\n    this.modelId = modelId;\r\n    this.expand = expand;\r\n    this.flags = flags;\r\n    this.name = name;\r\n  }\r\n\r\n  /** Construct from JSON representation. */\r\n  public static fromJSON(props: SpatialClassifierProps): SpatialClassifier {\r\n    return new SpatialClassifier(props.modelId, props.name, SpatialClassifierFlags.fromJSON(props.flags), props.expand);\r\n  }\r\n\r\n  /** Convert to JSON representation.\r\n   * @note This method always sets the [[SpatialClassifierProps.isActive]] property to `false`.\r\n   */\r\n  public toJSON(): SpatialClassifierProps {\r\n    return {\r\n      modelId: this.modelId,\r\n      expand: this.expand,\r\n      flags: this.flags.toJSON(),\r\n      name: this.name,\r\n      isActive: false,\r\n    };\r\n  }\r\n\r\n  /** Construct from Model Map Layer.\r\n   * @beta\r\n   */\r\n  public static fromModelMapLayer(mapLayer: ModelMapLayerSettings): SpatialClassifier {\r\n    const flags =  SpatialClassifierFlags.fromJSON({ inside: SpatialClassifierInsideDisplay.Off, outside: SpatialClassifierOutsideDisplay.Off });\r\n\r\n    return new SpatialClassifier(mapLayer.modelId, mapLayer.name, flags);\r\n  }\r\n\r\n  /** Create a classifier identical to this one except for any properties explicitly specified by `changedProps`. */\r\n  public clone(changedProps?: Partial<SpatialClassifierProps>): SpatialClassifier {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return SpatialClassifier.fromJSON({ ...this.toJSON(), ...changedProps });\r\n  }\r\n\r\n  /** Return true if this classifier is equivalent to `other`. */\r\n  public equals(other: SpatialClassifier): boolean {\r\n    if (other === this)\r\n      return true;\r\n\r\n    return this.modelId === other.modelId && this.expand === other.expand && this.name === other.name && this.flags.equals(other.flags);\r\n  }\r\n\r\n  /** Return true if this classifier is equivalent to `props`. */\r\n  public equalsProps(props: SpatialClassifierProps): boolean {\r\n    return this.modelId === props.modelId && this.expand === props.expand && this.name === props.name && this.flags.equalsProps(props.flags);\r\n  }\r\n}\r\n\r\n/** An object that can store the JSON representation of a list of [[SpatialClassifier]]s.\r\n * @see [[SpatialClassifiers]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifiersContainer {\r\n  /** The list of classifiers. */\r\n  classifiers?: SpatialClassifierProps[];\r\n}\r\n\r\n/** A set of [[SpatialClassifier]]s for a given reality model. At most one of the classifiers can be actively classifying the model at any given time.\r\n * The set of classifiers can be presented to the user, listed by name, so that the active classifier can be changed.\r\n * The set of classifiers is populated from its JSON representation and that representation is kept in sync as the set of classifiers is modified.\r\n * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].\r\n * @see [[SpatialClassifier]] for details on how spatial classification works.\r\n * @see [[ContextRealityModel.classifiers]] to define classifiers for a context reality model.\r\n * @see [SpatialModelState.classifiers]($frontend) to define classifiers for a persistent reality model.\r\n * @public\r\n */\r\nexport class SpatialClassifiers implements Iterable<SpatialClassifier> {\r\n  private readonly _json: SpatialClassifiersContainer;\r\n  private readonly _classifiers: SpatialClassifier[] = [];\r\n  private _active?: SpatialClassifier;\r\n\r\n  /** Construct a new set of classifiers from the JSON representation. The set will be initialized from `container.classifiers` and that JSON representation\r\n   * will be kept in sync with changes made to the set. The caller should not directly modify `container.classifiers` or its contents as that will cause the set to become out\r\n   * of sync with the JSON representation.\r\n   * The [[active]] classifier will be determined by the first [[SpatialClassifierProps]] whose `isActive` property is set to `true`, if any.\r\n   */\r\n  public constructor(container: SpatialClassifiersContainer) {\r\n    this._json = container;\r\n\r\n    const json = this._array;\r\n    if (!json)\r\n      return;\r\n\r\n    for (const props of json) {\r\n      const classifier = SpatialClassifier.fromJSON(props);\r\n      this._classifiers.push(classifier);\r\n      if (props.isActive) {\r\n        if (!this._active)\r\n          this._active = classifier;\r\n        else\r\n          props.isActive = false;\r\n      }\r\n    }\r\n  }\r\n\r\n  /** The classifier currently classifying the target reality model. The classifier passed to the setter must be one obtained from this set, or one equivalent to\r\n   * one contained in this set; in the latter case, the equivalent classifier contained in this set becomes active.\r\n   */\r\n  /** The classifier currently classifying the target reality model, if any.\r\n   * @see [[setActive]] to change the active classifier.\r\n   */\r\n  public get active(): SpatialClassifier | undefined {\r\n    return this._active;\r\n  }\r\n\r\n  /** Change the [[active]] classifier. The input must be a classifier belonging to this set, or equivalent to one in the set.\r\n   * If no equivalent classifier exists in the set, the active classifier remains unchanged.\r\n   * @param The classifier to set as active, or `undefined` to clear the active classifier.\r\n   * @returns the active classifier.\r\n   */\r\n  public setActive(active: SpatialClassifier | undefined): SpatialClassifier | undefined {\r\n    const array = this._array;\r\n    if (!array)\r\n      return this.active;\r\n\r\n    if (active) {\r\n      active = this.findEquivalent(active);\r\n      if (!active)\r\n        return this.active;\r\n    }\r\n\r\n    if (active === this.active)\r\n      return this.active;\r\n\r\n    let propsIndex = -1;\r\n    if (active) {\r\n      propsIndex = array.findIndex((x) => active!.equalsProps(x));\r\n      if (-1 === propsIndex)\r\n        return this.active;\r\n    }\r\n\r\n    this._active = active;\r\n    for (let i = 0; i < array.length; i++)\r\n      array[i].isActive = (i === propsIndex);\r\n\r\n    return this.active;\r\n  }\r\n\r\n  /** Obtain an iterator over the classifiers contained in this set. */\r\n  public [Symbol.iterator](): Iterator<SpatialClassifier> {\r\n    return this._classifiers[Symbol.iterator]();\r\n  }\r\n\r\n  /** The number of classifiers in this set. */\r\n  public get size(): number {\r\n    return this._array?.length ?? 0;\r\n  }\r\n\r\n  /** Returns the first classifier that satisfies `criterion`, or `undefined` if no classifier satisfies it. */\r\n  public find(criterion: (classifier: SpatialClassifier) => boolean): SpatialClassifier | undefined {\r\n    return this._classifiers.find(criterion);\r\n  }\r\n\r\n  /** Find the first classifier that is equivalent to the supplied classifier, or `undefined` if no equivalent classifier exists in this set. */\r\n  public findEquivalent(classifier: SpatialClassifier): SpatialClassifier | undefined {\r\n    return this.find((x) => x.equals(classifier));\r\n  }\r\n\r\n  /** Return true if the specified classifier or one equivalent to it exists in this set. */\r\n  public has(classifier: SpatialClassifier): boolean {\r\n    return undefined !== this.findEquivalent(classifier);\r\n  }\r\n\r\n  /** Add a classifier to this set. If an equivalent classifier already exists, the supplied classifier is not added.\r\n   * @param classifier The classifier to add.\r\n   * @returns The equivalent pre-existing classifier, if one existed; or the supplied classifier, if it was added to the set.\r\n   */\r\n  public add(classifier: SpatialClassifier): SpatialClassifier {\r\n    const existing = this.findEquivalent(classifier);\r\n    if (existing)\r\n      return existing;\r\n\r\n    let array = this._array;\r\n    if (!array)\r\n      array = this._json.classifiers = [];\r\n\r\n    this._classifiers.push(classifier);\r\n    array.push(classifier.toJSON());\r\n    return classifier;\r\n  }\r\n\r\n  /** Replace an existing classifier with a different one.\r\n   * @param toReplace The classifier to be replaced.\r\n   * @param replacement The classifier to replace `toReplace`.\r\n   * @returns true if a classifier equivalent to `toReplace` existed in the set and was replaced by `replacement`.\r\n   * @note If `toReplace` was the [[active]] classifier, `replacement` will become active.\r\n   */\r\n  public replace(toReplace: SpatialClassifier, replacement: SpatialClassifier): boolean {\r\n    const list = this._array;\r\n    if (!list)\r\n      return false;\r\n\r\n    const classifierIndex = this._classifiers.findIndex((x) => x.equals(toReplace));\r\n    if (-1 === classifierIndex)\r\n      return false;\r\n\r\n    const propsIndex = list.findIndex((x) => toReplace.equalsProps(x));\r\n    assert(propsIndex === classifierIndex);\r\n    if (-1 === propsIndex)\r\n      return false;\r\n\r\n    toReplace = this._classifiers[classifierIndex];\r\n    const wasActive = this.active === toReplace;\r\n\r\n    this._classifiers[classifierIndex] = replacement;\r\n    const props = list[propsIndex] = replacement.toJSON();\r\n\r\n    if (wasActive) {\r\n      props.isActive = true;\r\n      this._active = replacement;\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Remove the first classifier equivalent to `classifier` from this set.\r\n   * @param classifier The classifier to remove.\r\n   * @returns The classifier that was actually removed, or `undefined` if none was removed.\r\n   */\r\n  public delete(classifier: SpatialClassifier): SpatialClassifier | undefined {\r\n    const list = this._array;\r\n    if (!list)\r\n      return undefined;\r\n\r\n    const classifierIndex = this._classifiers.findIndex((x) => x.equals(classifier));\r\n    if (-1 === classifierIndex)\r\n      return undefined;\r\n\r\n    classifier = this._classifiers[classifierIndex];\r\n    const propsIndex = list.findIndex((x) => classifier.equalsProps(x));\r\n    assert(propsIndex === classifierIndex);\r\n    if (-1 === propsIndex)\r\n      return undefined;\r\n\r\n    list.splice(propsIndex, 1);\r\n    this._classifiers.splice(classifierIndex, 1);\r\n    if (list.length === 0)\r\n      this._json.classifiers = undefined;\r\n\r\n    if (classifier === this.active)\r\n      this._active = undefined;\r\n\r\n    return classifier;\r\n  }\r\n\r\n  /** Remove all classifiers from this set. */\r\n  public clear(): void {\r\n    this._classifiers.length = 0;\r\n    this._json.classifiers = undefined;\r\n    this._active = undefined;\r\n  }\r\n\r\n  private get _array(): SpatialClassifierProps[] | undefined {\r\n    return Array.isArray(this._json.classifiers) ? this._json.classifiers : undefined;\r\n  }\r\n}\r\n\r\nfunction insideDisplay(display: number): SpatialClassifierInsideDisplay {\r\n  switch (display) {\r\n    case SpatialClassifierInsideDisplay.Off:\r\n    case SpatialClassifierInsideDisplay.On:\r\n    case SpatialClassifierInsideDisplay.Dimmed:\r\n    case SpatialClassifierInsideDisplay.Hilite:\r\n    case SpatialClassifierInsideDisplay.ElementColor:\r\n      return display;\r\n    default:\r\n      return SpatialClassifierInsideDisplay.ElementColor;\r\n  }\r\n}\r\n\r\nfunction outsideDisplay(display: number): SpatialClassifierOutsideDisplay {\r\n  switch (display) {\r\n    case SpatialClassifierOutsideDisplay.Off:\r\n    case SpatialClassifierOutsideDisplay.On:\r\n    case SpatialClassifierOutsideDisplay.Dimmed:\r\n      return display;\r\n    default:\r\n      return SpatialClassifierOutsideDisplay.Dimmed;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SpatialClassification.js","sourceRoot":"","sources":["../../src/SpatialClassification.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAyD;AAGzD;;;;GAIG;AACH,IAAY,8BAWX;AAXD,WAAY,8BAA8B;IACxC,qCAAqC;IACrC,iFAAO,CAAA;IACP,oDAAoD;IACpD,+EAAM,CAAA;IACN,gCAAgC;IAChC,uFAAU,CAAA;IACV,wEAAwE;IACxE,uFAAU,CAAA;IACV,yEAAyE;IACzE,mGAAgB,CAAA;AAClB,CAAC,EAXW,8BAA8B,GAA9B,sCAA8B,KAA9B,sCAA8B,QAWzC;AAED;;;;GAIG;AACH,IAAY,+BAOX;AAPD,WAAY,+BAA+B;IACzC,qCAAqC;IACrC,mFAAO,CAAA;IACP,oDAAoD;IACpD,iFAAM,CAAA;IACN,gCAAgC;IAChC,yFAAU,CAAA;AACZ,CAAC,EAPW,+BAA+B,GAA/B,uCAA+B,KAA/B,uCAA+B,QAO1C;AAeD;;GAEG;AACH,MAAa,sBAAsB;IAQjC,2BAA2B;IAC3B,YAAmB,MAAM,GAAG,8BAA8B,CAAC,YAAY,EAAE,OAAO,GAAG,+BAA+B,CAAC,MAAM,EAAE,kBAAkB,GAAG,KAAK;QACnJ,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,0CAA0C;IACnC,MAAM,CAAC,QAAQ,CAAC,KAAkC;QACvD,OAAO,IAAI,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpG,CAAC;IAED,sCAAsC;IAC/B,MAAM;QACX,MAAM,KAAK,GAAgC;YACzC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;QAEF,IAAI,IAAI,CAAC,kBAAkB;YACzB,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAElC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8GAA8G;IACvG,KAAK,CAAC,YAAmD;QAC9D,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,OAAO,sBAAsB,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,4DAA4D;IACrD,MAAM,CAAC,KAA6B;QACzC,IAAI,KAAK,KAAK,IAAI;YAChB,OAAO,IAAI,CAAC;QAEd,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB,CAAC;IAChI,CAAC;IAED,4DAA4D;IACrD,WAAW,CAAC,KAAkC;QACnD,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,kBAAkB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC3I,CAAC;CACF;AArDD,wDAqDC;AAqBD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,iBAAiB;IAY5B,kCAAkC;IAClC,YAAmB,OAAmB,EAAE,IAAY,EAAE,KAAK,GAAG,IAAI,sBAAsB,EAAE,EAAE,MAAM,GAAG,CAAC;QACpG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,0CAA0C;IACnC,MAAM,CAAC,QAAQ,CAAC,KAA6B;QAClD,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtH,CAAC;IAED;;OAEG;IACI,MAAM;QACX,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB,CAAC,QAA+B;QAC7D,MAAM,KAAK,GAAI,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,8BAA8B,CAAC,GAAG,EAAE,OAAO,EAAE,+BAA+B,CAAC,GAAG,EAAE,CAAC,CAAC;QAE7I,OAAO,IAAI,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,kHAAkH;IAC3G,KAAK,CAAC,YAA8C;QACzD,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,OAAO,iBAAiB,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,+DAA+D;IACxD,MAAM,CAAC,KAAwB;QACpC,IAAI,KAAK,KAAK,IAAI;YAChB,OAAO,IAAI,CAAC;QAEd,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtI,CAAC;IAED,+DAA+D;IACxD,WAAW,CAAC,KAA6B;QAC9C,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3I,CAAC;CACF;AAnED,8CAmEC;AAYD;;;;;;;;GAQG;AACH,MAAa,kBAAkB;IAK7B;;;;OAIG;IACH,YAAmB,SAAsC;QARxC,iBAAY,GAAwB,EAAE,CAAC;QAStD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,IAAI;YACP,OAAO;QAET,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE;YACxB,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,QAAQ,EAAE;gBAClB,IAAI,CAAC,IAAI,CAAC,OAAO;oBACf,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;;oBAE1B,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;aAC1B;SACF;IACH,CAAC;IAED;;OAEG;IACH;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAqC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK;YACR,OAAO,IAAI,CAAC,MAAM,CAAC;QAErB,IAAI,MAAM,EAAE;YACV,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM;gBACT,OAAO,IAAI,CAAC,MAAM,CAAC;SACtB;QAED,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM;YACxB,OAAO,IAAI,CAAC,MAAM,CAAC;QAErB,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,EAAE;YACV,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,CAAC,KAAK,UAAU;gBACnB,OAAO,IAAI,CAAC,MAAM,CAAC;SACtB;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;YACnC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;QAEzC,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,qEAAqE;IAC9D,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,6CAA6C;IAC7C,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,6GAA6G;IACtG,IAAI,CAAC,SAAqD;QAC/D,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,8IAA8I;IACvI,cAAc,CAAC,UAA6B;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,0FAA0F;IACnF,GAAG,CAAC,UAA6B;QACtC,OAAO,SAAS,KAAK,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,UAA6B;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAElB,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,KAAK;YACR,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,SAA4B,EAAE,WAA8B;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,IAAI;YACP,OAAO,KAAK,CAAC;QAEf,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,CAAC,KAAK,eAAe;YACxB,OAAO,KAAK,CAAC;QAEf,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAA,qBAAM,EAAC,UAAU,KAAK,eAAe,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,KAAK,UAAU;YACnB,OAAO,KAAK,CAAC;QAEf,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAE5C,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,WAAW,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QAEtD,IAAI,SAAS,EAAE;YACb,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC;SAC5B;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,UAA6B;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,IAAI;YACP,OAAO,SAAS,CAAC;QAEnB,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,CAAC,KAAK,eAAe;YACxB,OAAO,SAAS,CAAC;QAEnB,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,IAAA,qBAAM,EAAC,UAAU,KAAK,eAAe,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,KAAK,UAAU;YACnB,OAAO,SAAS,CAAC;QAEnB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QAErC,IAAI,UAAU,KAAK,IAAI,CAAC,MAAM;YAC5B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAE3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4CAA4C;IACrC,KAAK;QACV,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC;CACF;AA7LD,gDA6LC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,QAAQ,OAAO,EAAE;QACf,KAAK,8BAA8B,CAAC,GAAG,CAAC;QACxC,KAAK,8BAA8B,CAAC,EAAE,CAAC;QACvC,KAAK,8BAA8B,CAAC,MAAM,CAAC;QAC3C,KAAK,8BAA8B,CAAC,MAAM,CAAC;QAC3C,KAAK,8BAA8B,CAAC,YAAY;YAC9C,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,8BAA8B,CAAC,YAAY,CAAC;KACtD;AACH,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,QAAQ,OAAO,EAAE;QACf,KAAK,+BAA+B,CAAC,GAAG,CAAC;QACzC,KAAK,+BAA+B,CAAC,EAAE,CAAC;QACxC,KAAK,+BAA+B,CAAC,MAAM;YACzC,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,+BAA+B,CAAC,MAAM,CAAC;KACjD;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { assert, Id64String } from \"@itwin/core-bentley\";\r\nimport { ModelMapLayerSettings } from \"./MapLayerSettings\";\r\n\r\n/** Describes how a [[SpatialClassifier]] affects the display of classified geometry - that is, geometry intersecting\r\n * the classifier.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SpatialClassifierInsideDisplay {\r\n  /** The geometry is not displayed. */\r\n  Off = 0,\r\n  /** The geometry is displayed without alteration. */\r\n  On = 1,\r\n  /** The geometry is darkened. */\r\n  Dimmed = 2,\r\n  /** The geometry is tinted by the [Viewport.hilite]($frontend) color. */\r\n  Hilite = 3,\r\n  /** The geometry is tinted with the colors of the classifier elements. */\r\n  ElementColor = 4,\r\n}\r\n\r\n/** Describes how a [[SpatialClassifier]] affects the display of unclassified geometry - that is, geometry not intersecting\r\n * the classifier.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SpatialClassifierOutsideDisplay {\r\n  /** The geometry is not displayed. */\r\n  Off = 0,\r\n  /** The geometry is displayed without alteration. */\r\n  On = 1,\r\n  /** The geometry is darkened. */\r\n  Dimmed = 2,\r\n}\r\n\r\n/** JSON representation of a [[SpatialClassifierFlags]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifierFlagsProps {\r\n  /** See [[SpatialClassifierFlags.inside]]. */\r\n  inside: SpatialClassifierInsideDisplay;\r\n  /** See [[SpatialClassifierFlags.outside]]. */\r\n  outside: SpatialClassifierOutsideDisplay;\r\n  /** See [[SpatialClassifierFlags.isVolumeClassifier]]. */\r\n  isVolumeClassifier?: boolean;\r\n}\r\n\r\n/** Flags affecting how a [[SpatialClassifier]] is applied.\r\n * @public\r\n */\r\nexport class SpatialClassifierFlags {\r\n  /** How geometry intersecting the classifier should be displayed. */\r\n  public readonly inside: SpatialClassifierInsideDisplay;\r\n  /** How geometry not intersecting the classifier should be displayed. */\r\n  public readonly outside: SpatialClassifierOutsideDisplay;\r\n  /** True for volume classification; false for planar classification. */\r\n  public readonly isVolumeClassifier: boolean;\r\n\r\n  /** Construct new flags. */\r\n  public constructor(inside = SpatialClassifierInsideDisplay.ElementColor, outside = SpatialClassifierOutsideDisplay.Dimmed, isVolumeClassifier = false) {\r\n    this.inside = insideDisplay(inside);\r\n    this.outside = outsideDisplay(outside);\r\n    this.isVolumeClassifier = isVolumeClassifier;\r\n  }\r\n\r\n  /** Construct from JSON representation. */\r\n  public static fromJSON(props: SpatialClassifierFlagsProps): SpatialClassifierFlags {\r\n    return new SpatialClassifierFlags(props.inside, props.outside, true === props.isVolumeClassifier);\r\n  }\r\n\r\n  /** Convert to JSON representation. */\r\n  public toJSON(): SpatialClassifierFlagsProps {\r\n    const props: SpatialClassifierFlagsProps = {\r\n      inside: this.inside,\r\n      outside: this.outside,\r\n    };\r\n\r\n    if (this.isVolumeClassifier)\r\n      props.isVolumeClassifier = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Create flags indentical to these ones except for any properties explicitly specified by `changedProps`. */\r\n  public clone(changedProps?: Partial<SpatialClassifierFlagsProps>): SpatialClassifierFlags {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return SpatialClassifierFlags.fromJSON({ ...this.toJSON(), ...changedProps });\r\n  }\r\n\r\n  /** Return true if these flags are equivalent to `other`. */\r\n  public equals(other: SpatialClassifierFlags): boolean {\r\n    if (other === this)\r\n      return true;\r\n\r\n    return other.inside === this.inside && other.outside === this.outside && other.isVolumeClassifier === this.isVolumeClassifier;\r\n  }\r\n\r\n  /** Return true if these flags are equivalent to `props`. */\r\n  public equalsProps(props: SpatialClassifierFlagsProps): boolean {\r\n    return this.inside === props.inside && this.outside === props.outside && this.isVolumeClassifier === (true === props.isVolumeClassifier);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[SpatialClassifier]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifierProps {\r\n  /** See [[SpatialClassifier.modelId]]. */\r\n  modelId: Id64String;\r\n  /** See [[SpatialClassifier.expand]]. */\r\n  expand: number;\r\n  /** See [[SpatialClassifier.flags]]. */\r\n  flags: SpatialClassifierFlagsProps;\r\n  /** See [[SpatialClassifier.name]]. */\r\n  name: string;\r\n  /** Records whether this is the active classifier.\r\n   * See [[SpatialClassifier.active]].\r\n   */\r\n  isActive?: boolean;\r\n}\r\n\r\n/** Describes how to use the geometry of one [GeometricModel]($backend) to classify the contents of other models - most typically, reality models.\r\n * Applying a classifier divides the geometry of the classified model into two groups:\r\n *  - Classified (intersecting the classifier); and\r\n *  - Unclassified (not intersecting the classifier).\r\n * For example, a model containing the building footprints for a city block could be used to classify a reality mesh captured from photographs of the\r\n * real-world block. Then, buildings within the reality mesh can be selected individually, and present the properties of the classifier geometry (e.g.,\r\n * the address of the building). The appearance of the geometry can also be customized based using [[SpatialClassifierInsideDisplay]] and [[SpatialClassifierOutsideDisplay]].\r\n * Two types of classification are supported:\r\n *  - Planar classification, in which the geometry of the classifier model is projected onto a plane to classify geometry within a region extruded perpendicular\r\n * the plane (e.g., the building footprints example); and\r\n *  - Volume classification, in which closed, non-intersecting volumes within the classifier classify geometry that intersects (i.e. is contained within) those same volumes (e.g., imagine using boxes instead\r\n * of footprints to classify buildings, or floors of buildings).\r\n * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].\r\n * @see [[SpatialClassifiers]] to define a set of classifiers.\r\n * @see [[ContextRealityModel.classifiers]] to classify a context reality model.\r\n * @see [SpatialModelState.classifiers]($frontend) to classify a persistent reality model.\r\n * @public\r\n */\r\nexport class SpatialClassifier {\r\n  /** The Id of the [GeometricModel]($backend) whose geometry is used to produce the classifier. */\r\n  public readonly modelId: Id64String;\r\n  /** A distance in meters by which to expand the classifier geometry. For example, if line strings are used to represent streets,\r\n   * you might expand them to the average width of a street.\r\n   */\r\n  public readonly expand: number;\r\n  /** Flags controlling how to apply the classifier. */\r\n  public readonly flags: SpatialClassifierFlags;\r\n  /** A user-friendly name, useful for identifying individual classifiers within a [[SpatialClassifiers]]. */\r\n  public readonly name: string;\r\n\r\n  /** Construct a new classifier. */\r\n  public constructor(modelId: Id64String, name: string, flags = new SpatialClassifierFlags(), expand = 0) {\r\n    this.modelId = modelId;\r\n    this.expand = expand;\r\n    this.flags = flags;\r\n    this.name = name;\r\n  }\r\n\r\n  /** Construct from JSON representation. */\r\n  public static fromJSON(props: SpatialClassifierProps): SpatialClassifier {\r\n    return new SpatialClassifier(props.modelId, props.name, SpatialClassifierFlags.fromJSON(props.flags), props.expand);\r\n  }\r\n\r\n  /** Convert to JSON representation.\r\n   * @note This method always sets the [[SpatialClassifierProps.isActive]] property to `false`.\r\n   */\r\n  public toJSON(): SpatialClassifierProps {\r\n    return {\r\n      modelId: this.modelId,\r\n      expand: this.expand,\r\n      flags: this.flags.toJSON(),\r\n      name: this.name,\r\n      isActive: false,\r\n    };\r\n  }\r\n\r\n  /** Construct from Model Map Layer.\r\n   * @beta\r\n   */\r\n  public static fromModelMapLayer(mapLayer: ModelMapLayerSettings): SpatialClassifier {\r\n    const flags =  SpatialClassifierFlags.fromJSON({ inside: SpatialClassifierInsideDisplay.Off, outside: SpatialClassifierOutsideDisplay.Off });\r\n\r\n    return new SpatialClassifier(mapLayer.modelId, mapLayer.name, flags);\r\n  }\r\n\r\n  /** Create a classifier identical to this one except for any properties explicitly specified by `changedProps`. */\r\n  public clone(changedProps?: Partial<SpatialClassifierProps>): SpatialClassifier {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    return SpatialClassifier.fromJSON({ ...this.toJSON(), ...changedProps });\r\n  }\r\n\r\n  /** Return true if this classifier is equivalent to `other`. */\r\n  public equals(other: SpatialClassifier): boolean {\r\n    if (other === this)\r\n      return true;\r\n\r\n    return this.modelId === other.modelId && this.expand === other.expand && this.name === other.name && this.flags.equals(other.flags);\r\n  }\r\n\r\n  /** Return true if this classifier is equivalent to `props`. */\r\n  public equalsProps(props: SpatialClassifierProps): boolean {\r\n    return this.modelId === props.modelId && this.expand === props.expand && this.name === props.name && this.flags.equalsProps(props.flags);\r\n  }\r\n}\r\n\r\n/** An object that can store the JSON representation of a list of [[SpatialClassifier]]s.\r\n * @see [[SpatialClassifiers]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialClassifiersContainer {\r\n  /** The list of classifiers. */\r\n  classifiers?: SpatialClassifierProps[];\r\n}\r\n\r\n/** A set of [[SpatialClassifier]]s for a given reality model. At most one of the classifiers can be actively classifying the model at any given time.\r\n * The set of classifiers can be presented to the user, listed by name, so that the active classifier can be changed.\r\n * The set of classifiers is populated from its JSON representation and that representation is kept in sync as the set of classifiers is modified.\r\n * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].\r\n * @see [[SpatialClassifier]] for details on how spatial classification works.\r\n * @see [[ContextRealityModel.classifiers]] to define classifiers for a context reality model.\r\n * @see [SpatialModelState.classifiers]($frontend) to define classifiers for a persistent reality model.\r\n * @public\r\n */\r\nexport class SpatialClassifiers implements Iterable<SpatialClassifier> {\r\n  private readonly _json: SpatialClassifiersContainer;\r\n  private readonly _classifiers: SpatialClassifier[] = [];\r\n  private _active?: SpatialClassifier;\r\n\r\n  /** Construct a new set of classifiers from the JSON representation. The set will be initialized from `container.classifiers` and that JSON representation\r\n   * will be kept in sync with changes made to the set. The caller should not directly modify `container.classifiers` or its contents as that will cause the set to become out\r\n   * of sync with the JSON representation.\r\n   * The [[active]] classifier will be determined by the first [[SpatialClassifierProps]] whose `isActive` property is set to `true`, if any.\r\n   */\r\n  public constructor(container: SpatialClassifiersContainer) {\r\n    this._json = container;\r\n\r\n    const json = this._array;\r\n    if (!json)\r\n      return;\r\n\r\n    for (const props of json) {\r\n      const classifier = SpatialClassifier.fromJSON(props);\r\n      this._classifiers.push(classifier);\r\n      if (props.isActive) {\r\n        if (!this._active)\r\n          this._active = classifier;\r\n        else\r\n          props.isActive = false;\r\n      }\r\n    }\r\n  }\r\n\r\n  /** The classifier currently classifying the target reality model. The classifier passed to the setter must be one obtained from this set, or one equivalent to\r\n   * one contained in this set; in the latter case, the equivalent classifier contained in this set becomes active.\r\n   */\r\n  /** The classifier currently classifying the target reality model, if any.\r\n   * @see [[setActive]] to change the active classifier.\r\n   */\r\n  public get active(): SpatialClassifier | undefined {\r\n    return this._active;\r\n  }\r\n\r\n  /** Change the [[active]] classifier. The input must be a classifier belonging to this set, or equivalent to one in the set.\r\n   * If no equivalent classifier exists in the set, the active classifier remains unchanged.\r\n   * @param The classifier to set as active, or `undefined` to clear the active classifier.\r\n   * @returns the active classifier.\r\n   */\r\n  public setActive(active: SpatialClassifier | undefined): SpatialClassifier | undefined {\r\n    const array = this._array;\r\n    if (!array)\r\n      return this.active;\r\n\r\n    if (active) {\r\n      active = this.findEquivalent(active);\r\n      if (!active)\r\n        return this.active;\r\n    }\r\n\r\n    if (active === this.active)\r\n      return this.active;\r\n\r\n    let propsIndex = -1;\r\n    if (active) {\r\n      propsIndex = array.findIndex((x) => active!.equalsProps(x));\r\n      if (-1 === propsIndex)\r\n        return this.active;\r\n    }\r\n\r\n    this._active = active;\r\n    for (let i = 0; i < array.length; i++)\r\n      array[i].isActive = (i === propsIndex);\r\n\r\n    return this.active;\r\n  }\r\n\r\n  /** Obtain an iterator over the classifiers contained in this set. */\r\n  public [Symbol.iterator](): Iterator<SpatialClassifier> {\r\n    return this._classifiers[Symbol.iterator]();\r\n  }\r\n\r\n  /** The number of classifiers in this set. */\r\n  public get size(): number {\r\n    return this._array?.length ?? 0;\r\n  }\r\n\r\n  /** Returns the first classifier that satisfies `criterion`, or `undefined` if no classifier satisfies it. */\r\n  public find(criterion: (classifier: SpatialClassifier) => boolean): SpatialClassifier | undefined {\r\n    return this._classifiers.find(criterion);\r\n  }\r\n\r\n  /** Find the first classifier that is equivalent to the supplied classifier, or `undefined` if no equivalent classifier exists in this set. */\r\n  public findEquivalent(classifier: SpatialClassifier): SpatialClassifier | undefined {\r\n    return this.find((x) => x.equals(classifier));\r\n  }\r\n\r\n  /** Return true if the specified classifier or one equivalent to it exists in this set. */\r\n  public has(classifier: SpatialClassifier): boolean {\r\n    return undefined !== this.findEquivalent(classifier);\r\n  }\r\n\r\n  /** Add a classifier to this set. If an equivalent classifier already exists, the supplied classifier is not added.\r\n   * @param classifier The classifier to add.\r\n   * @returns The equivalent pre-existing classifier, if one existed; or the supplied classifier, if it was added to the set.\r\n   */\r\n  public add(classifier: SpatialClassifier): SpatialClassifier {\r\n    const existing = this.findEquivalent(classifier);\r\n    if (existing)\r\n      return existing;\r\n\r\n    let array = this._array;\r\n    if (!array)\r\n      array = this._json.classifiers = [];\r\n\r\n    this._classifiers.push(classifier);\r\n    array.push(classifier.toJSON());\r\n    return classifier;\r\n  }\r\n\r\n  /** Replace an existing classifier with a different one.\r\n   * @param toReplace The classifier to be replaced.\r\n   * @param replacement The classifier to replace `toReplace`.\r\n   * @returns true if a classifier equivalent to `toReplace` existed in the set and was replaced by `replacement`.\r\n   * @note If `toReplace` was the [[active]] classifier, `replacement` will become active.\r\n   */\r\n  public replace(toReplace: SpatialClassifier, replacement: SpatialClassifier): boolean {\r\n    const list = this._array;\r\n    if (!list)\r\n      return false;\r\n\r\n    const classifierIndex = this._classifiers.findIndex((x) => x.equals(toReplace));\r\n    if (-1 === classifierIndex)\r\n      return false;\r\n\r\n    const propsIndex = list.findIndex((x) => toReplace.equalsProps(x));\r\n    assert(propsIndex === classifierIndex);\r\n    if (-1 === propsIndex)\r\n      return false;\r\n\r\n    toReplace = this._classifiers[classifierIndex];\r\n    const wasActive = this.active === toReplace;\r\n\r\n    this._classifiers[classifierIndex] = replacement;\r\n    const props = list[propsIndex] = replacement.toJSON();\r\n\r\n    if (wasActive) {\r\n      props.isActive = true;\r\n      this._active = replacement;\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Remove the first classifier equivalent to `classifier` from this set.\r\n   * @param classifier The classifier to remove.\r\n   * @returns The classifier that was actually removed, or `undefined` if none was removed.\r\n   */\r\n  public delete(classifier: SpatialClassifier): SpatialClassifier | undefined {\r\n    const list = this._array;\r\n    if (!list)\r\n      return undefined;\r\n\r\n    const classifierIndex = this._classifiers.findIndex((x) => x.equals(classifier));\r\n    if (-1 === classifierIndex)\r\n      return undefined;\r\n\r\n    classifier = this._classifiers[classifierIndex];\r\n    const propsIndex = list.findIndex((x) => classifier.equalsProps(x));\r\n    assert(propsIndex === classifierIndex);\r\n    if (-1 === propsIndex)\r\n      return undefined;\r\n\r\n    list.splice(propsIndex, 1);\r\n    this._classifiers.splice(classifierIndex, 1);\r\n    if (list.length === 0)\r\n      this._json.classifiers = undefined;\r\n\r\n    if (classifier === this.active)\r\n      this._active = undefined;\r\n\r\n    return classifier;\r\n  }\r\n\r\n  /** Remove all classifiers from this set. */\r\n  public clear(): void {\r\n    this._classifiers.length = 0;\r\n    this._json.classifiers = undefined;\r\n    this._active = undefined;\r\n  }\r\n\r\n  private get _array(): SpatialClassifierProps[] | undefined {\r\n    return Array.isArray(this._json.classifiers) ? this._json.classifiers : undefined;\r\n  }\r\n}\r\n\r\nfunction insideDisplay(display: number): SpatialClassifierInsideDisplay {\r\n  switch (display) {\r\n    case SpatialClassifierInsideDisplay.Off:\r\n    case SpatialClassifierInsideDisplay.On:\r\n    case SpatialClassifierInsideDisplay.Dimmed:\r\n    case SpatialClassifierInsideDisplay.Hilite:\r\n    case SpatialClassifierInsideDisplay.ElementColor:\r\n      return display;\r\n    default:\r\n      return SpatialClassifierInsideDisplay.ElementColor;\r\n  }\r\n}\r\n\r\nfunction outsideDisplay(display: number): SpatialClassifierOutsideDisplay {\r\n  switch (display) {\r\n    case SpatialClassifierOutsideDisplay.Off:\r\n    case SpatialClassifierOutsideDisplay.On:\r\n    case SpatialClassifierOutsideDisplay.Dimmed:\r\n      return display;\r\n    default:\r\n      return SpatialClassifierOutsideDisplay.Dimmed;\r\n  }\r\n}\r\n"]}

package/lib/cjs/TerrainSettings.js

@@ -49,10 +49,9 @@ class TerrainSettings {
         return this._nonLocatable;
     }
     static fromJSON(json) {
-        var _a;
         if (undefined === json)
             return new TerrainSettings();
-        const providerName = (_a = json === null || json === void 0 ? void 0 : json.providerName) !== null && _a !== void 0 ? _a : "CesiumWorldTerrain";
+        const providerName = json?.providerName ?? "CesiumWorldTerrain";
         const settings = new TerrainSettings(providerName, json.exaggeration, json.applyLighting, json.heightOrigin, json.heightOriginMode);
         if (true === json.nonLocatable)
             settings._nonLocatable = true;
@@ -85,16 +84,15 @@ class TerrainSettings {
      * @returns A TerrainSettings with all of its properties set to match those of`this`, except those explicitly defined in `changedProps`.
      */
     clone(changedProps) {
-        var _a, _b, _c, _d, _e, _f;
         if (undefined === changedProps)
             return this;
         const props = {
-            providerName: (_a = changedProps.providerName) !== null && _a !== void 0 ? _a : this.providerName,
-            exaggeration: (_b = changedProps.exaggeration) !== null && _b !== void 0 ? _b : this.exaggeration,
-            nonLocatable: (_c = changedProps.nonLocatable) !== null && _c !== void 0 ? _c : this.nonLocatable,
-            applyLighting: (_d = changedProps.applyLighting) !== null && _d !== void 0 ? _d : this.applyLighting,
-            heightOrigin: (_e = changedProps.heightOrigin) !== null && _e !== void 0 ? _e : this.heightOrigin,
-            heightOriginMode: (_f = changedProps.heightOriginMode) !== null && _f !== void 0 ? _f : this.heightOriginMode,
+            providerName: changedProps.providerName ?? this.providerName,
+            exaggeration: changedProps.exaggeration ?? this.exaggeration,
+            nonLocatable: changedProps.nonLocatable ?? this.nonLocatable,
+            applyLighting: changedProps.applyLighting ?? this.applyLighting,
+            heightOrigin: changedProps.heightOrigin ?? this.heightOrigin,
+            heightOriginMode: changedProps.heightOriginMode ?? this.heightOriginMode,
         };
         return TerrainSettings.fromJSON(props);
     }

package/lib/cjs/TerrainSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSettings.js","sourceRoot":"","sources":["../../src/TerrainSettings.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { BackgroundMapProps } from \"./BackgroundMapSettings\";\r\n\r\n/** Identifies a [TerrainProvider]($frontend).\r\n * @see [[TerrainSettings.providerName]] and [[TerrainProps.providerName]].\r\n * @public\r\n * @extensions\r\n * @deprecated in 3.x. Use string instead.\r\n */\r\nexport type TerrainProviderName = string;\r\n\r\n/**  JSON representation of the settings of the terrain applied to background map display by a [[DisplayStyle]].\r\n * @see [[DisplayStyleSettingsProps]]\r\n * @see [[BackgroundMapProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport interface TerrainProps {\r\n  /** Identifies the [TerrainProvider]($frontend) that will supply terrain meshes.\r\n   * If omitted, it defaults to \"CesiumWorldTerrain\".\r\n   */\r\n  providerName?: string;\r\n  /** A value greater than one will cause terrain height to be exaggerated/scaled.false (or 1.0) indicate no exaggeration. Default value: 1.0 */\r\n  exaggeration?: number;\r\n  /**  Applying lighting can help to visualize subtle terrain variation.  Default value: true */\r\n  applyLighting?: boolean;\r\n  /** Origin value - height of the IModel origin at the project center as defined by heightOriginMode. Default value: 0.0 */\r\n  heightOrigin?: number;\r\n  /** Determines how/if the heightOrigin is applied to the terrain height. Default value: Geodetic */\r\n  heightOriginMode?: TerrainHeightOriginMode;\r\n  /** If true, the terrain will not be locatable. Otherwise, [[BackgroundMapProps.nonLocatable]] will determine whether terrain is locatable.\r\n   * @internal use [[BackgroundMapProps.nonLocatable]]. Retained for backwards compatibility only.\r\n   */\r\n  nonLocatable?: boolean;\r\n}\r\n\r\n/** Correction modes for terrain height\r\n * @see [[TerrainProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport enum TerrainHeightOriginMode {\r\n  /** Height value indicates the geodetic height of the IModel origin (also referred to as ellipsoidal or GPS height) */\r\n  Geodetic = 0,\r\n  /** Height value indicates the geoidal height of the IModel origin (commonly referred to as sea level). */\r\n  Geoid = 1,\r\n  /** Height value indicates the height of the IModel origin relative to ground level at project center. */\r\n  Ground = 2,\r\n}\r\n\r\n/** Normalized version of [[TerrainProps]] for which provider has been validated and default values of all members are used.\r\n * @public\r\n */\r\nexport class TerrainSettings {\r\n  private _nonLocatable: true | undefined;\r\n  /** Identifies the [TerrainProvider]($frontend) that will supply terrain meshes.\r\n   * Defaults to \"CesiumWorldTerrain\".\r\n   */\r\n  public readonly providerName: string;\r\n  /** A value greater than one will cause terrain height to be exaggerated/scaled. 1.0 indicates no exaggeration. Default value: 1.0 */\r\n  public readonly exaggeration: number;\r\n  /**  Applying lighting can help to visualize subtle terrain variations. Default value: false */\r\n  public readonly applyLighting: boolean;\r\n  /** Origin value - height of the IModel origin at the project center as defined by heightOriginMode. Default value 0.0 */\r\n  public readonly heightOrigin: number;\r\n  /** Determines how/if the heightOrigin is applied to the terrain height. Default value: Geodetic */\r\n  public readonly heightOriginMode: TerrainHeightOriginMode;\r\n  /** Optionally overrides [[BackgroundMapSettings.locatable]]. For backwards compatibility only.\r\n   * @see [[TerrainProps.nonLocatable]].\r\n   * @internal\r\n   */\r\n  public get nonLocatable(): true | undefined {\r\n    return this._nonLocatable;\r\n  }\r\n\r\n  constructor(providerName: string = \"CesiumWorldTerrain\", exaggeration: number = 1.0, applyLighting = false, heightOrigin = 0.0, heightOriginMode = TerrainHeightOriginMode.Geodetic) {\r\n    this.providerName = providerName;\r\n    this.exaggeration = Math.min(100, Math.max(0.1, exaggeration));\r\n    this.applyLighting = applyLighting;\r\n    this.heightOrigin = heightOrigin;\r\n    switch (heightOriginMode) {\r\n      case TerrainHeightOriginMode.Ground:\r\n      case TerrainHeightOriginMode.Geoid:\r\n        this.heightOriginMode = heightOriginMode;\r\n        break;\r\n      default:\r\n        this.heightOriginMode = TerrainHeightOriginMode.Geodetic;\r\n        break;\r\n    }\r\n  }\r\n\r\n  public static fromJSON(json?: TerrainProps) {\r\n    if (undefined === json)\r\n      return new TerrainSettings();\r\n\r\n    const providerName = json?.providerName ?? \"CesiumWorldTerrain\";\r\n    const settings = new TerrainSettings(providerName, json.exaggeration, json.applyLighting, json.heightOrigin, json.heightOriginMode);\r\n    if (true === json.nonLocatable)\r\n      settings._nonLocatable = true;\r\n\r\n    return settings;\r\n  }\r\n\r\n  public toJSON(): TerrainProps {\r\n    const props: TerrainProps = { heightOriginMode: this.heightOriginMode };\r\n    if (\"CesiumWorldTerrain\" !== this.providerName)\r\n      props.providerName = this.providerName;\r\n    if (1 !== this.exaggeration)\r\n      props.exaggeration = this.exaggeration;\r\n    if (this.nonLocatable)\r\n      props.nonLocatable = true;\r\n    if (this.applyLighting)\r\n      props.applyLighting = true;\r\n    if (0 !== this.heightOrigin)\r\n      props.heightOrigin = this.heightOrigin;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(other: TerrainSettings): boolean {\r\n    return this.providerName === other.providerName && this.exaggeration === other.exaggeration && this.applyLighting === other.applyLighting\r\n      && this.heightOrigin === other.heightOrigin && this.heightOriginMode === other.heightOriginMode && this.nonLocatable === other.nonLocatable;\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to the supplied JSON settings. */\r\n  public equalsJSON(json?: BackgroundMapProps): boolean {\r\n    return this.equals(TerrainSettings.fromJSON(json));\r\n  }\r\n\r\n  /** Create a copy of this TerrainSettings, optionally modifying some of its properties.\r\n   * @param changedProps JSON representation of the properties to change.\r\n   * @returns A TerrainSettings with all of its properties set to match those of`this`, except those explicitly defined in `changedProps`.\r\n   */\r\n  public clone(changedProps?: TerrainProps): TerrainSettings {\r\n    if (undefined === changedProps)\r\n      return this;\r\n\r\n    const props = {\r\n      providerName: changedProps.providerName ?? this.providerName,\r\n      exaggeration: changedProps.exaggeration ?? this.exaggeration,\r\n      nonLocatable: changedProps.nonLocatable ?? this.nonLocatable,\r\n      applyLighting: changedProps.applyLighting ?? this.applyLighting,\r\n      heightOrigin: changedProps.heightOrigin ?? this.heightOrigin,\r\n      heightOriginMode: changedProps.heightOriginMode ?? this.heightOriginMode,\r\n    };\r\n\r\n    return TerrainSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"TerrainSettings.js","sourceRoot":"","sources":["../../src/TerrainSettings.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module DisplayStyles\r\n */\r\n\r\nimport { BackgroundMapProps } from \"./BackgroundMapSettings\";\r\n\r\n/** Identifies a [TerrainProvider]($frontend).\r\n * @see [[TerrainSettings.providerName]] and [[TerrainProps.providerName]].\r\n * @public\r\n * @extensions\r\n * @deprecated in 3.x. Use string instead.\r\n */\r\nexport type TerrainProviderName = string;\r\n\r\n/**  JSON representation of the settings of the terrain applied to background map display by a [[DisplayStyle]].\r\n * @see [[DisplayStyleSettingsProps]]\r\n * @see [[BackgroundMapProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport interface TerrainProps {\r\n  /** Identifies the [TerrainProvider]($frontend) that will supply terrain meshes.\r\n   * If omitted, it defaults to \"CesiumWorldTerrain\".\r\n   */\r\n  providerName?: string;\r\n  /** A value greater than one will cause terrain height to be exaggerated/scaled.false (or 1.0) indicate no exaggeration. Default value: 1.0 */\r\n  exaggeration?: number;\r\n  /**  Applying lighting can help to visualize subtle terrain variation.  Default value: true */\r\n  applyLighting?: boolean;\r\n  /** Origin value - height of the IModel origin at the project center as defined by heightOriginMode. Default value: 0.0 */\r\n  heightOrigin?: number;\r\n  /** Determines how/if the heightOrigin is applied to the terrain height. Default value: Geodetic */\r\n  heightOriginMode?: TerrainHeightOriginMode;\r\n  /** If true, the terrain will not be locatable. Otherwise, [[BackgroundMapProps.nonLocatable]] will determine whether terrain is locatable.\r\n   * @internal use [[BackgroundMapProps.nonLocatable]]. Retained for backwards compatibility only.\r\n   */\r\n  nonLocatable?: boolean;\r\n}\r\n\r\n/** Correction modes for terrain height\r\n * @see [[TerrainProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport enum TerrainHeightOriginMode {\r\n  /** Height value indicates the geodetic height of the IModel origin (also referred to as ellipsoidal or GPS height) */\r\n  Geodetic = 0,\r\n  /** Height value indicates the geoidal height of the IModel origin (commonly referred to as sea level). */\r\n  Geoid = 1,\r\n  /** Height value indicates the height of the IModel origin relative to ground level at project center. */\r\n  Ground = 2,\r\n}\r\n\r\n/** Normalized version of [[TerrainProps]] for which provider has been validated and default values of all members are used.\r\n * @public\r\n */\r\nexport class TerrainSettings {\r\n  private _nonLocatable: true | undefined;\r\n  /** Identifies the [TerrainProvider]($frontend) that will supply terrain meshes.\r\n   * Defaults to \"CesiumWorldTerrain\".\r\n   */\r\n  public readonly providerName: string;\r\n  /** A value greater than one will cause terrain height to be exaggerated/scaled. 1.0 indicates no exaggeration. Default value: 1.0 */\r\n  public readonly exaggeration: number;\r\n  /**  Applying lighting can help to visualize subtle terrain variations. Default value: false */\r\n  public readonly applyLighting: boolean;\r\n  /** Origin value - height of the IModel origin at the project center as defined by heightOriginMode. Default value 0.0 */\r\n  public readonly heightOrigin: number;\r\n  /** Determines how/if the heightOrigin is applied to the terrain height. Default value: Geodetic */\r\n  public readonly heightOriginMode: TerrainHeightOriginMode;\r\n  /** Optionally overrides [[BackgroundMapSettings.locatable]]. For backwards compatibility only.\r\n   * @see [[TerrainProps.nonLocatable]].\r\n   * @internal\r\n   */\r\n  public get nonLocatable(): true | undefined {\r\n    return this._nonLocatable;\r\n  }\r\n\r\n  constructor(providerName: string = \"CesiumWorldTerrain\", exaggeration: number = 1.0, applyLighting = false, heightOrigin = 0.0, heightOriginMode = TerrainHeightOriginMode.Geodetic) {\r\n    this.providerName = providerName;\r\n    this.exaggeration = Math.min(100, Math.max(0.1, exaggeration));\r\n    this.applyLighting = applyLighting;\r\n    this.heightOrigin = heightOrigin;\r\n    switch (heightOriginMode) {\r\n      case TerrainHeightOriginMode.Ground:\r\n      case TerrainHeightOriginMode.Geoid:\r\n        this.heightOriginMode = heightOriginMode;\r\n        break;\r\n      default:\r\n        this.heightOriginMode = TerrainHeightOriginMode.Geodetic;\r\n        break;\r\n    }\r\n  }\r\n\r\n  public static fromJSON(json?: TerrainProps) {\r\n    if (undefined === json)\r\n      return new TerrainSettings();\r\n\r\n    const providerName = json?.providerName ?? \"CesiumWorldTerrain\";\r\n    const settings = new TerrainSettings(providerName, json.exaggeration, json.applyLighting, json.heightOrigin, json.heightOriginMode);\r\n    if (true === json.nonLocatable)\r\n      settings._nonLocatable = true;\r\n\r\n    return settings;\r\n  }\r\n\r\n  public toJSON(): TerrainProps {\r\n    const props: TerrainProps = { heightOriginMode: this.heightOriginMode };\r\n    if (\"CesiumWorldTerrain\" !== this.providerName)\r\n      props.providerName = this.providerName;\r\n    if (1 !== this.exaggeration)\r\n      props.exaggeration = this.exaggeration;\r\n    if (this.nonLocatable)\r\n      props.nonLocatable = true;\r\n    if (this.applyLighting)\r\n      props.applyLighting = true;\r\n    if (0 !== this.heightOrigin)\r\n      props.heightOrigin = this.heightOrigin;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(other: TerrainSettings): boolean {\r\n    return this.providerName === other.providerName && this.exaggeration === other.exaggeration && this.applyLighting === other.applyLighting\r\n      && this.heightOrigin === other.heightOrigin && this.heightOriginMode === other.heightOriginMode && this.nonLocatable === other.nonLocatable;\r\n  }\r\n\r\n  /** Returns true if these settings are equivalent to the supplied JSON settings. */\r\n  public equalsJSON(json?: BackgroundMapProps): boolean {\r\n    return this.equals(TerrainSettings.fromJSON(json));\r\n  }\r\n\r\n  /** Create a copy of this TerrainSettings, optionally modifying some of its properties.\r\n   * @param changedProps JSON representation of the properties to change.\r\n   * @returns A TerrainSettings with all of its properties set to match those of`this`, except those explicitly defined in `changedProps`.\r\n   */\r\n  public clone(changedProps?: TerrainProps): TerrainSettings {\r\n    if (undefined === changedProps)\r\n      return this;\r\n\r\n    const props = {\r\n      providerName: changedProps.providerName ?? this.providerName,\r\n      exaggeration: changedProps.exaggeration ?? this.exaggeration,\r\n      nonLocatable: changedProps.nonLocatable ?? this.nonLocatable,\r\n      applyLighting: changedProps.applyLighting ?? this.applyLighting,\r\n      heightOrigin: changedProps.heightOrigin ?? this.heightOrigin,\r\n      heightOriginMode: changedProps.heightOriginMode ?? this.heightOriginMode,\r\n    };\r\n\r\n    return TerrainSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}

package/lib/cjs/TextureMapping.js

@@ -71,11 +71,10 @@ exports.TextureMapping = TextureMapping;
     /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */
     class Params {
         constructor(props) {
-            var _a, _b, _c, _d;
-            this.textureMatrix = (_a = props === null || props === void 0 ? void 0 : props.textureMat2x3) !== null && _a !== void 0 ? _a : Trans2x3.identity;
-            this.weight = (_b = props === null || props === void 0 ? void 0 : props.textureWeight) !== null && _b !== void 0 ? _b : 1;
-            this.mode = (_c = props === null || props === void 0 ? void 0 : props.mapMode) !== null && _c !== void 0 ? _c : Mode.Parametric;
-            this.worldMapping = (_d = props === null || props === void 0 ? void 0 : props.worldMapping) !== null && _d !== void 0 ? _d : false;
+            this.textureMatrix = props?.textureMat2x3 ?? Trans2x3.identity;
+            this.weight = props?.textureWeight ?? 1;
+            this.mode = props?.mapMode ?? Mode.Parametric;
+            this.worldMapping = props?.worldMapping ?? false;
         }
         /**
          * Generates UV parameters for textured surfaces. Returns undefined on failure.

package/lib/cjs/TextureMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextureMapping.js","sourceRoot":"","sources":["../../src/TextureMapping.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 { IndexedPolyfaceVisitor, Matrix3d, Point2d, Point3d, PolyfaceVisitor, Transform, Vector3d } from \"@itwin/core-geometry\";\r\nimport { RenderTexture } from \"./RenderTexture\";\r\n\r\n/** Defines normal map parameters.\r\n * @beta\r\n */\r\nexport interface NormalMapParams {\r\n  /** The texture to use as a normal map. If not present then the pattern map texture will be used as a normal map. */\r\n  normalMap?: RenderTexture;\r\n  /** True if the Y component stored in the green channel should be negated. By default, positive Y points downward, but some\r\n   * normal maps are created with positive Y pointing upward.\r\n   */\r\n  greenUp?: boolean;\r\n  /** Scale factor by which to multiply the components of the normal extracted from [[normalMap]]. */\r\n  scale?: number;\r\n}\r\n\r\n/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].\r\n * @public\r\n */\r\nexport class TextureMapping {\r\n  /** The texture to be mapped to the surface. If normalMapParams is present but does not contain a normal map, then texture is used as a normal map rather than a pattern map. */\r\n  public readonly texture: RenderTexture;\r\n  /** The parameters for normal mapping.\r\n   * @beta\r\n   */\r\n  public normalMapParams?: NormalMapParams;\r\n  /** The parameters describing how the textures are mapped to the surface. */\r\n  public readonly params: TextureMapping.Params;\r\n\r\n  public constructor(tx: RenderTexture, params: TextureMapping.Params) {\r\n    this.texture = tx;\r\n    this.params = params;\r\n  }\r\n\r\n  /** @internal */\r\n  public computeUVParams(visitor: PolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined {\r\n    return this.params.computeUVParams(visitor as IndexedPolyfaceVisitor, transformToImodel);\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace TextureMapping { // eslint-disable-line no-redeclare\r\n  /** Enumerates the possible texture mapping modes. */\r\n  export enum Mode {\r\n    None = -1,\r\n    Parametric = 0,\r\n    ElevationDrape = 1,\r\n    Planar = 2,\r\n    /** @internal */\r\n    DirectionalDrape = 3,\r\n    /** @internal */\r\n    Cubic = 4,\r\n    /** @internal */\r\n    Spherical = 5,\r\n    /** @internal */\r\n    Cylindrical = 6,\r\n    /** @internal */\r\n    Solid = 7,\r\n    /** @internal Only valid for lights */\r\n    FrontProject = 8,\r\n  }\r\n\r\n  /** A 2x3 matrix for mapping a texture image to a surface. */\r\n  export class Trans2x3 {\r\n    /** The 3x4 transform produced from the 2x3 matrix. */\r\n    public readonly transform: Transform;\r\n\r\n    /** Construct from the two rows of the matrix:\r\n     * ```\r\n     *  | m00 m01 originX |\r\n     *  | m10 m11 originY |\r\n     * ```\r\n     * Producing the [Transform]($core-geometry):\r\n     * ```\r\n     *  | m00 m01 0 originX |\r\n     *  | m10 m11 0 originY |\r\n     *  | 0   0   1 0       |\r\n     * ```\r\n     */\r\n    public constructor(m00 = 1, m01 = 0, originX = 0, m10 = 0, m11 = 1, originY = 0) {\r\n      const origin = new Point3d(originX, originY, 0);\r\n      const matrix = Matrix3d.createRowValues(m00, m01, 0, m10, m11, 0, 0, 0, 1);\r\n      this.transform = Transform.createRefs(origin, matrix);\r\n    }\r\n\r\n    /** An immutable 2x3 identity matrix. */\r\n    public static readonly identity = new Trans2x3();\r\n  }\r\n\r\n  /** Properties used to construct a [[TextureMapping.Params]]. */\r\n  export interface ParamProps {\r\n    /** The matrix used to map the image to a surface. */\r\n    textureMat2x3?: TextureMapping.Trans2x3;\r\n    /** The ratio in [0, 1] with which to mix the color sampled from the texture with the surface's color.\r\n     * A value of 0.0 uses only the surface color. A value of 1.0 uses only the texture color. A value of 0.5 uses an even mix of both.\r\n     * @note This affects only the red, green, and blue components of the color. The alpha sampled from the texture is always multiplied by the surface color's alpha.\r\n     * @note Defaults to 1.0\r\n     */\r\n    textureWeight?: number;\r\n    /** The mode by which to map the image to a surface.\r\n     * @note Defaults to [[TextureMapping.Mode.Parametric]].\r\n     */\r\n    mapMode?: TextureMapping.Mode;\r\n    /** @internal */\r\n    worldMapping?: boolean;\r\n  }\r\n\r\n  /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */\r\n  export class Params {\r\n    /** The matrix used to map the image to a surface. */\r\n    public textureMatrix: TextureMapping.Trans2x3;\r\n    /** The ratio in [0, 1] with which to mix the color sampled from the texture with the element's color.\r\n     * A value of 0.0 uses only the element color. A value of 1.0 uses only the texture color.\r\n     */\r\n    public weight: number;\r\n    /** The mode by which to map the image to a surface. */\r\n    public mode: TextureMapping.Mode;\r\n    /** @internal */\r\n    public worldMapping: boolean;\r\n\r\n    public constructor(props?: TextureMapping.ParamProps) {\r\n      this.textureMatrix = props?.textureMat2x3 ?? Trans2x3.identity;\r\n      this.weight = props?.textureWeight ?? 1;\r\n      this.mode = props?.mapMode ?? Mode.Parametric;\r\n      this.worldMapping = props?.worldMapping ?? false;\r\n    }\r\n\r\n    /**\r\n     * Generates UV parameters for textured surfaces. Returns undefined on failure.\r\n     * @internal\r\n     */\r\n    public computeUVParams(visitor: IndexedPolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined {\r\n      switch (this.mode) {\r\n        default:  // Fall through to parametric in default case\r\n        case TextureMapping.Mode.Parametric: {\r\n          return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);\r\n        }\r\n        case TextureMapping.Mode.Planar: {\r\n          const normalIndices = visitor.normalIndex;\r\n          if (!normalIndices)\r\n            return undefined;\r\n\r\n          // Ignore planar mode unless master or sub units for scaleMode and facet is planar\r\n          if (!this.worldMapping || (visitor.normalIndex !== undefined && (normalIndices[0] !== normalIndices[1] || normalIndices[0] !== normalIndices[2]))) {\r\n            return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);\r\n          } else {\r\n            return this.computePlanarUVParams(visitor, this.textureMatrix.transform);\r\n          }\r\n        }\r\n        case TextureMapping.Mode.ElevationDrape: {\r\n          return this.computeElevationDrapeUVParams(visitor, this.textureMatrix.transform, transformToImodel);\r\n        }\r\n      }\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of parametric. */\r\n    private computeParametricUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform, isRelativeUnits: boolean): Point2d[] {\r\n      const params: Point2d[] = [];\r\n      for (let i = 0; i < visitor.numEdgesThisFacet; i++) {\r\n        let param = Point2d.create();\r\n\r\n        if (isRelativeUnits || !visitor.tryGetDistanceParameter(i, param)) {\r\n          if (!visitor.tryGetNormalizedParameter(i, param)) {\r\n            // If mesh does not have facetFaceData, we still want to use the texture coordinates if they are present\r\n            param = visitor.getParam(i)!;\r\n          }\r\n        }\r\n\r\n        params.push(uvTransform.multiplyPoint2d(param));\r\n      }\r\n      return params;\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */\r\n    private computePlanarUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform): Point2d[] | undefined {\r\n      const params: Point2d[] = [];\r\n      const points = visitor.point;\r\n      let normal: Vector3d;\r\n\r\n      if (visitor.normal === undefined)\r\n        normal = points.getPoint3dAtUncheckedPointIndex(0).crossProductToPoints(points.getPoint3dAtUncheckedPointIndex(1), points.getPoint3dAtUncheckedPointIndex(2));\r\n      else\r\n        normal = visitor.normal.getVector3dAtCheckedVectorIndex(0)!;\r\n\r\n      if (!normal.normalize(normal))\r\n        return undefined;\r\n\r\n      // adjust U texture coordinate to be a continuous length starting at the\r\n      // origin. V coordinate stays the same. This mode assumes Z is up vector\r\n\r\n      // Flipping normal puts us in a planar coordinate system consistent with MicroStation's display system\r\n      normal.scale(-1.0, normal);\r\n\r\n      // pick the first vertex normal\r\n      const sideVector = Vector3d.create(normal.y, -normal.x, 0.0);\r\n\r\n      // if the magnitude of the normal is near zero, the real normal points\r\n      // almost straighten up.. In this case, use Y as the up vector to match QV\r\n\r\n      const magnitude = sideVector.magnitude();\r\n      sideVector.normalize(sideVector); // won't remain undefined if failed due to following check..\r\n\r\n      if (magnitude < 1e-3) {\r\n        normal.set(0, 0, -1);\r\n        sideVector.set(1, 0, 0);\r\n      }\r\n\r\n      const upVector = sideVector.crossProduct(normal).normalize();\r\n      if (!upVector)\r\n        return undefined;\r\n\r\n      const numEdges = visitor.numEdgesThisFacet;\r\n      for (let i = 0; i < numEdges; i++) {\r\n        const vector = Vector3d.createFrom(points.getPoint3dAtUncheckedPointIndex(i));\r\n\r\n        params.push(Point2d.create(vector.dotProduct(sideVector), vector.dotProduct(upVector)));\r\n        uvTransform.multiplyPoint2d(params[i], params[i]);\r\n      }\r\n      return params;\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */\r\n    private computeElevationDrapeUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform, transformToIModel?: Transform): Point2d[] {\r\n      const params: Point2d[] = [];\r\n      const numEdges = visitor.numEdgesThisFacet;\r\n      for (let i = 0; i < numEdges; i++) {\r\n        const point = visitor.point.getPoint3dAtUncheckedPointIndex(i);\r\n\r\n        if (transformToIModel !== undefined)\r\n          transformToIModel.multiplyPoint3d(point, point);\r\n\r\n        params.push(Point2d.createFrom(point));\r\n        uvTransform.multiplyPoint2d(params[i], params[i]);\r\n      }\r\n      return params;\r\n    }\r\n  }\r\n}\r\n\r\nObject.freeze(TextureMapping.Trans2x3.identity);\r\n"]}
+{"version":3,"file":"TextureMapping.js","sourceRoot":"","sources":["../../src/TextureMapping.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 { IndexedPolyfaceVisitor, Matrix3d, Point2d, Point3d, PolyfaceVisitor, Transform, Vector3d } from \"@itwin/core-geometry\";\r\nimport { RenderTexture } from \"./RenderTexture\";\r\n\r\n/** Defines normal map parameters.\r\n * @beta\r\n */\r\nexport interface NormalMapParams {\r\n  /** The texture to use as a normal map. If not present then the pattern map texture will be used as a normal map. */\r\n  normalMap?: RenderTexture;\r\n  /** True if the Y component stored in the green channel should be negated. By default, positive Y points downward, but some\r\n   * normal maps are created with positive Y pointing upward.\r\n   */\r\n  greenUp?: boolean;\r\n  /** Scale factor by which to multiply the components of the normal extracted from [[normalMap]]. */\r\n  scale?: number;\r\n}\r\n\r\n/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].\r\n * @public\r\n */\r\nexport class TextureMapping {\r\n  /** The texture to be mapped to the surface. If normalMapParams is present but does not contain a normal map, then texture is used as a normal map rather than a pattern map. */\r\n  public readonly texture: RenderTexture;\r\n  /** The parameters for normal mapping.\r\n   * @beta\r\n   */\r\n  public normalMapParams?: NormalMapParams;\r\n  /** The parameters describing how the textures are mapped to the surface. */\r\n  public readonly params: TextureMapping.Params;\r\n\r\n  public constructor(tx: RenderTexture, params: TextureMapping.Params) {\r\n    this.texture = tx;\r\n    this.params = params;\r\n  }\r\n\r\n  /** @internal */\r\n  public computeUVParams(visitor: PolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined {\r\n    return this.params.computeUVParams(visitor as IndexedPolyfaceVisitor, transformToImodel);\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace TextureMapping { // eslint-disable-line no-redeclare\r\n  /** Enumerates the possible texture mapping modes. */\r\n  export enum Mode {\r\n    None = -1,\r\n    Parametric = 0,\r\n    ElevationDrape = 1,\r\n    Planar = 2,\r\n    /** @internal */\r\n    DirectionalDrape = 3,\r\n    /** @internal */\r\n    Cubic = 4,\r\n    /** @internal */\r\n    Spherical = 5,\r\n    /** @internal */\r\n    Cylindrical = 6,\r\n    /** @internal */\r\n    Solid = 7,\r\n    /** @internal Only valid for lights */\r\n    FrontProject = 8,\r\n  }\r\n\r\n  /** A 2x3 matrix for mapping a texture image to a surface. */\r\n  export class Trans2x3 {\r\n    /** The 3x4 transform produced from the 2x3 matrix. */\r\n    public readonly transform: Transform;\r\n\r\n    /** Construct from the two rows of the matrix:\r\n     * ```\r\n     *  | m00 m01 originX |\r\n     *  | m10 m11 originY |\r\n     * ```\r\n     * Producing the [Transform]($core-geometry):\r\n     * ```\r\n     *  | m00 m01 0 originX |\r\n     *  | m10 m11 0 originY |\r\n     *  | 0   0   1 0       |\r\n     * ```\r\n     */\r\n    public constructor(m00 = 1, m01 = 0, originX = 0, m10 = 0, m11 = 1, originY = 0) {\r\n      const origin = new Point3d(originX, originY, 0);\r\n      const matrix = Matrix3d.createRowValues(m00, m01, 0, m10, m11, 0, 0, 0, 1);\r\n      this.transform = Transform.createRefs(origin, matrix);\r\n    }\r\n\r\n    /** An immutable 2x3 identity matrix. */\r\n    public static readonly identity = new Trans2x3();\r\n  }\r\n\r\n  /** Properties used to construct a [[TextureMapping.Params]]. */\r\n  export interface ParamProps {\r\n    /** The matrix used to map the image to a surface. */\r\n    textureMat2x3?: TextureMapping.Trans2x3;\r\n    /** The ratio in [0, 1] with which to mix the color sampled from the texture with the surface's color.\r\n     * A value of 0.0 uses only the surface color. A value of 1.0 uses only the texture color. A value of 0.5 uses an even mix of both.\r\n     * @note This affects only the red, green, and blue components of the color. The alpha sampled from the texture is always multiplied by the surface color's alpha.\r\n     * @note Defaults to 1.0\r\n     */\r\n    textureWeight?: number;\r\n    /** The mode by which to map the image to a surface.\r\n     * @note Defaults to [[TextureMapping.Mode.Parametric]].\r\n     */\r\n    mapMode?: TextureMapping.Mode;\r\n    /** @internal */\r\n    worldMapping?: boolean;\r\n  }\r\n\r\n  /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */\r\n  export class Params {\r\n    /** The matrix used to map the image to a surface. */\r\n    public textureMatrix: TextureMapping.Trans2x3;\r\n    /** The ratio in [0, 1] with which to mix the color sampled from the texture with the element's color.\r\n     * A value of 0.0 uses only the element color. A value of 1.0 uses only the texture color.\r\n     */\r\n    public weight: number;\r\n    /** The mode by which to map the image to a surface. */\r\n    public mode: TextureMapping.Mode;\r\n    /** @internal */\r\n    public worldMapping: boolean;\r\n\r\n    public constructor(props?: TextureMapping.ParamProps) {\r\n      this.textureMatrix = props?.textureMat2x3 ?? Trans2x3.identity;\r\n      this.weight = props?.textureWeight ?? 1;\r\n      this.mode = props?.mapMode ?? Mode.Parametric;\r\n      this.worldMapping = props?.worldMapping ?? false;\r\n    }\r\n\r\n    /**\r\n     * Generates UV parameters for textured surfaces. Returns undefined on failure.\r\n     * @internal\r\n     */\r\n    public computeUVParams(visitor: IndexedPolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined {\r\n      switch (this.mode) {\r\n        default:  // Fall through to parametric in default case\r\n        case TextureMapping.Mode.Parametric: {\r\n          return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);\r\n        }\r\n        case TextureMapping.Mode.Planar: {\r\n          const normalIndices = visitor.normalIndex;\r\n          if (!normalIndices)\r\n            return undefined;\r\n\r\n          // Ignore planar mode unless master or sub units for scaleMode and facet is planar\r\n          if (!this.worldMapping || (visitor.normalIndex !== undefined && (normalIndices[0] !== normalIndices[1] || normalIndices[0] !== normalIndices[2]))) {\r\n            return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);\r\n          } else {\r\n            return this.computePlanarUVParams(visitor, this.textureMatrix.transform);\r\n          }\r\n        }\r\n        case TextureMapping.Mode.ElevationDrape: {\r\n          return this.computeElevationDrapeUVParams(visitor, this.textureMatrix.transform, transformToImodel);\r\n        }\r\n      }\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of parametric. */\r\n    private computeParametricUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform, isRelativeUnits: boolean): Point2d[] {\r\n      const params: Point2d[] = [];\r\n      for (let i = 0; i < visitor.numEdgesThisFacet; i++) {\r\n        let param = Point2d.create();\r\n\r\n        if (isRelativeUnits || !visitor.tryGetDistanceParameter(i, param)) {\r\n          if (!visitor.tryGetNormalizedParameter(i, param)) {\r\n            // If mesh does not have facetFaceData, we still want to use the texture coordinates if they are present\r\n            param = visitor.getParam(i)!;\r\n          }\r\n        }\r\n\r\n        params.push(uvTransform.multiplyPoint2d(param));\r\n      }\r\n      return params;\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */\r\n    private computePlanarUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform): Point2d[] | undefined {\r\n      const params: Point2d[] = [];\r\n      const points = visitor.point;\r\n      let normal: Vector3d;\r\n\r\n      if (visitor.normal === undefined)\r\n        normal = points.getPoint3dAtUncheckedPointIndex(0).crossProductToPoints(points.getPoint3dAtUncheckedPointIndex(1), points.getPoint3dAtUncheckedPointIndex(2));\r\n      else\r\n        normal = visitor.normal.getVector3dAtCheckedVectorIndex(0)!;\r\n\r\n      if (!normal.normalize(normal))\r\n        return undefined;\r\n\r\n      // adjust U texture coordinate to be a continuous length starting at the\r\n      // origin. V coordinate stays the same. This mode assumes Z is up vector\r\n\r\n      // Flipping normal puts us in a planar coordinate system consistent with MicroStation's display system\r\n      normal.scale(-1.0, normal);\r\n\r\n      // pick the first vertex normal\r\n      const sideVector = Vector3d.create(normal.y, -normal.x, 0.0);\r\n\r\n      // if the magnitude of the normal is near zero, the real normal points\r\n      // almost straighten up.. In this case, use Y as the up vector to match QV\r\n\r\n      const magnitude = sideVector.magnitude();\r\n      sideVector.normalize(sideVector); // won't remain undefined if failed due to following check..\r\n\r\n      if (magnitude < 1e-3) {\r\n        normal.set(0, 0, -1);\r\n        sideVector.set(1, 0, 0);\r\n      }\r\n\r\n      const upVector = sideVector.crossProduct(normal).normalize();\r\n      if (!upVector)\r\n        return undefined;\r\n\r\n      const numEdges = visitor.numEdgesThisFacet;\r\n      for (let i = 0; i < numEdges; i++) {\r\n        const vector = Vector3d.createFrom(points.getPoint3dAtUncheckedPointIndex(i));\r\n\r\n        params.push(Point2d.create(vector.dotProduct(sideVector), vector.dotProduct(upVector)));\r\n        uvTransform.multiplyPoint2d(params[i], params[i]);\r\n      }\r\n      return params;\r\n    }\r\n\r\n    /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */\r\n    private computeElevationDrapeUVParams(visitor: IndexedPolyfaceVisitor, uvTransform: Transform, transformToIModel?: Transform): Point2d[] {\r\n      const params: Point2d[] = [];\r\n      const numEdges = visitor.numEdgesThisFacet;\r\n      for (let i = 0; i < numEdges; i++) {\r\n        const point = visitor.point.getPoint3dAtUncheckedPointIndex(i);\r\n\r\n        if (transformToIModel !== undefined)\r\n          transformToIModel.multiplyPoint3d(point, point);\r\n\r\n        params.push(Point2d.createFrom(point));\r\n        uvTransform.multiplyPoint2d(params[i], params[i]);\r\n      }\r\n      return params;\r\n    }\r\n  }\r\n}\r\n\r\nObject.freeze(TextureMapping.Trans2x3.identity);\r\n"]}

package/lib/cjs/ThematicDisplay.js

@@ -56,7 +56,6 @@ var ThematicGradientColorScheme;
  */
 class ThematicGradientSettings {
     constructor(json) {
-        var _a;
         this.customKeys = [];
         if (undefined === json) {
             this.mode = ThematicGradientMode.Smooth;
@@ -84,7 +83,7 @@ class ThematicGradientSettings {
                 for (const keyValue of ThematicGradientSettings._defaultCustomKeys)
                     this.customKeys.push(new Gradient_1.Gradient.KeyColor({ value: keyValue[0], color: ColorDef_1.ColorDef.computeTbgrFromComponents(keyValue[1], keyValue[3], keyValue[2]) }));
             }
-            this.colorMix = (_a = json.colorMix) !== null && _a !== void 0 ? _a : 0.0;
+            this.colorMix = json.colorMix ?? 0.0;
         }
     }
     static get margin() { return .001; } // A fixed portion of the gradient for out of range values.