@itwin/core-common 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/esm/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/esm/TextureMapping.d.ts

@@ -1,119 +1,119 @@
-/** @packageDocumentation
- * @module Rendering
- */
-import { IndexedPolyfaceVisitor, Point2d, PolyfaceVisitor, Transform } from "@itwin/core-geometry";
-import { RenderTexture } from "./RenderTexture";
-/** Defines normal map parameters.
- * @beta
- */
-export interface NormalMapParams {
-    /** The texture to use as a normal map. If not present then the pattern map texture will be used as a normal map. */
-    normalMap?: RenderTexture;
-    /** True if the Y component stored in the green channel should be negated. By default, positive Y points downward, but some
-     * normal maps are created with positive Y pointing upward.
-     */
-    greenUp?: boolean;
-    /** Scale factor by which to multiply the components of the normal extracted from [[normalMap]]. */
-    scale?: number;
-}
-/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].
- * @public
- */
-export declare class TextureMapping {
-    /** 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. */
-    readonly texture: RenderTexture;
-    /** The parameters for normal mapping.
-     * @beta
-     */
-    normalMapParams?: NormalMapParams;
-    /** The parameters describing how the textures are mapped to the surface. */
-    readonly params: TextureMapping.Params;
-    constructor(tx: RenderTexture, params: TextureMapping.Params);
-    /** @internal */
-    computeUVParams(visitor: PolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined;
-}
-/** @public */
-export declare namespace TextureMapping {
-    /** Enumerates the possible texture mapping modes. */
-    enum Mode {
-        None = -1,
-        Parametric = 0,
-        ElevationDrape = 1,
-        Planar = 2,
-        /** @internal */
-        DirectionalDrape = 3,
-        /** @internal */
-        Cubic = 4,
-        /** @internal */
-        Spherical = 5,
-        /** @internal */
-        Cylindrical = 6,
-        /** @internal */
-        Solid = 7,
-        /** @internal Only valid for lights */
-        FrontProject = 8
-    }
-    /** A 2x3 matrix for mapping a texture image to a surface. */
-    class Trans2x3 {
-        /** The 3x4 transform produced from the 2x3 matrix. */
-        readonly transform: Transform;
-        /** Construct from the two rows of the matrix:
-         * ```
-         *  | m00 m01 originX |
-         *  | m10 m11 originY |
-         * ```
-         * Producing the [Transform]($core-geometry):
-         * ```
-         *  | m00 m01 0 originX |
-         *  | m10 m11 0 originY |
-         *  | 0   0   1 0       |
-         * ```
-         */
-        constructor(m00?: number, m01?: number, originX?: number, m10?: number, m11?: number, originY?: number);
-        /** An immutable 2x3 identity matrix. */
-        static readonly identity: Trans2x3;
-    }
-    /** Properties used to construct a [[TextureMapping.Params]]. */
-    interface ParamProps {
-        /** The matrix used to map the image to a surface. */
-        textureMat2x3?: TextureMapping.Trans2x3;
-        /** The ratio in [0, 1] with which to mix the color sampled from the texture with the surface's color.
-         * 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.
-         * @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.
-         * @note Defaults to 1.0
-         */
-        textureWeight?: number;
-        /** The mode by which to map the image to a surface.
-         * @note Defaults to [[TextureMapping.Mode.Parametric]].
-         */
-        mapMode?: TextureMapping.Mode;
-        /** @internal */
-        worldMapping?: boolean;
-    }
-    /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */
-    class Params {
-        /** The matrix used to map the image to a surface. */
-        textureMatrix: TextureMapping.Trans2x3;
-        /** The ratio in [0, 1] with which to mix the color sampled from the texture with the element's color.
-         * A value of 0.0 uses only the element color. A value of 1.0 uses only the texture color.
-         */
-        weight: number;
-        /** The mode by which to map the image to a surface. */
-        mode: TextureMapping.Mode;
-        /** @internal */
-        worldMapping: boolean;
-        constructor(props?: TextureMapping.ParamProps);
-        /**
-         * Generates UV parameters for textured surfaces. Returns undefined on failure.
-         * @internal
-         */
-        computeUVParams(visitor: IndexedPolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined;
-        /** Computes UV parameters given a texture mapping mode of parametric. */
-        private computeParametricUVParams;
-        /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */
-        private computePlanarUVParams;
-        /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */
-        private computeElevationDrapeUVParams;
-    }
-}
+/** @packageDocumentation
+ * @module Rendering
+ */
+import { IndexedPolyfaceVisitor, Point2d, PolyfaceVisitor, Transform } from "@itwin/core-geometry";
+import { RenderTexture } from "./RenderTexture";
+/** Defines normal map parameters.
+ * @beta
+ */
+export interface NormalMapParams {
+    /** The texture to use as a normal map. If not present then the pattern map texture will be used as a normal map. */
+    normalMap?: RenderTexture;
+    /** True if the Y component stored in the green channel should be negated. By default, positive Y points downward, but some
+     * normal maps are created with positive Y pointing upward.
+     */
+    greenUp?: boolean;
+    /** Scale factor by which to multiply the components of the normal extracted from [[normalMap]]. */
+    scale?: number;
+}
+/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].
+ * @public
+ */
+export declare class TextureMapping {
+    /** 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. */
+    readonly texture: RenderTexture;
+    /** The parameters for normal mapping.
+     * @beta
+     */
+    normalMapParams?: NormalMapParams;
+    /** The parameters describing how the textures are mapped to the surface. */
+    readonly params: TextureMapping.Params;
+    constructor(tx: RenderTexture, params: TextureMapping.Params);
+    /** @internal */
+    computeUVParams(visitor: PolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined;
+}
+/** @public */
+export declare namespace TextureMapping {
+    /** Enumerates the possible texture mapping modes. */
+    enum Mode {
+        None = -1,
+        Parametric = 0,
+        ElevationDrape = 1,
+        Planar = 2,
+        /** @internal */
+        DirectionalDrape = 3,
+        /** @internal */
+        Cubic = 4,
+        /** @internal */
+        Spherical = 5,
+        /** @internal */
+        Cylindrical = 6,
+        /** @internal */
+        Solid = 7,
+        /** @internal Only valid for lights */
+        FrontProject = 8
+    }
+    /** A 2x3 matrix for mapping a texture image to a surface. */
+    class Trans2x3 {
+        /** The 3x4 transform produced from the 2x3 matrix. */
+        readonly transform: Transform;
+        /** Construct from the two rows of the matrix:
+         * ```
+         *  | m00 m01 originX |
+         *  | m10 m11 originY |
+         * ```
+         * Producing the [Transform]($core-geometry):
+         * ```
+         *  | m00 m01 0 originX |
+         *  | m10 m11 0 originY |
+         *  | 0   0   1 0       |
+         * ```
+         */
+        constructor(m00?: number, m01?: number, originX?: number, m10?: number, m11?: number, originY?: number);
+        /** An immutable 2x3 identity matrix. */
+        static readonly identity: Trans2x3;
+    }
+    /** Properties used to construct a [[TextureMapping.Params]]. */
+    interface ParamProps {
+        /** The matrix used to map the image to a surface. */
+        textureMat2x3?: TextureMapping.Trans2x3;
+        /** The ratio in [0, 1] with which to mix the color sampled from the texture with the surface's color.
+         * 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.
+         * @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.
+         * @note Defaults to 1.0
+         */
+        textureWeight?: number;
+        /** The mode by which to map the image to a surface.
+         * @note Defaults to [[TextureMapping.Mode.Parametric]].
+         */
+        mapMode?: TextureMapping.Mode;
+        /** @internal */
+        worldMapping?: boolean;
+    }
+    /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */
+    class Params {
+        /** The matrix used to map the image to a surface. */
+        textureMatrix: TextureMapping.Trans2x3;
+        /** The ratio in [0, 1] with which to mix the color sampled from the texture with the element's color.
+         * A value of 0.0 uses only the element color. A value of 1.0 uses only the texture color.
+         */
+        weight: number;
+        /** The mode by which to map the image to a surface. */
+        mode: TextureMapping.Mode;
+        /** @internal */
+        worldMapping: boolean;
+        constructor(props?: TextureMapping.ParamProps);
+        /**
+         * Generates UV parameters for textured surfaces. Returns undefined on failure.
+         * @internal
+         */
+        computeUVParams(visitor: IndexedPolyfaceVisitor, transformToImodel: Transform): Point2d[] | undefined;
+        /** Computes UV parameters given a texture mapping mode of parametric. */
+        private computeParametricUVParams;
+        /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */
+        private computePlanarUVParams;
+        /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */
+        private computeElevationDrapeUVParams;
+    }
+}
 //# sourceMappingURL=TextureMapping.d.ts.map

package/lib/esm/TextureMapping.js

@@ -1,170 +1,170 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Rendering
- */
-import { Matrix3d, Point2d, Point3d, Transform, Vector3d } from "@itwin/core-geometry";
-/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].
- * @public
- */
-export class TextureMapping {
-    constructor(tx, params) {
-        this.texture = tx;
-        this.params = params;
-    }
-    /** @internal */
-    computeUVParams(visitor, transformToImodel) {
-        return this.params.computeUVParams(visitor, transformToImodel);
-    }
-}
-/** @public */
-(function (TextureMapping) {
-    /** Enumerates the possible texture mapping modes. */
-    let Mode;
-    (function (Mode) {
-        Mode[Mode["None"] = -1] = "None";
-        Mode[Mode["Parametric"] = 0] = "Parametric";
-        Mode[Mode["ElevationDrape"] = 1] = "ElevationDrape";
-        Mode[Mode["Planar"] = 2] = "Planar";
-        /** @internal */
-        Mode[Mode["DirectionalDrape"] = 3] = "DirectionalDrape";
-        /** @internal */
-        Mode[Mode["Cubic"] = 4] = "Cubic";
-        /** @internal */
-        Mode[Mode["Spherical"] = 5] = "Spherical";
-        /** @internal */
-        Mode[Mode["Cylindrical"] = 6] = "Cylindrical";
-        /** @internal */
-        Mode[Mode["Solid"] = 7] = "Solid";
-        /** @internal Only valid for lights */
-        Mode[Mode["FrontProject"] = 8] = "FrontProject";
-    })(Mode = TextureMapping.Mode || (TextureMapping.Mode = {}));
-    /** A 2x3 matrix for mapping a texture image to a surface. */
-    class Trans2x3 {
-        /** Construct from the two rows of the matrix:
-         * ```
-         *  | m00 m01 originX |
-         *  | m10 m11 originY |
-         * ```
-         * Producing the [Transform]($core-geometry):
-         * ```
-         *  | m00 m01 0 originX |
-         *  | m10 m11 0 originY |
-         *  | 0   0   1 0       |
-         * ```
-         */
-        constructor(m00 = 1, m01 = 0, originX = 0, m10 = 0, m11 = 1, originY = 0) {
-            const origin = new Point3d(originX, originY, 0);
-            const matrix = Matrix3d.createRowValues(m00, m01, 0, m10, m11, 0, 0, 0, 1);
-            this.transform = Transform.createRefs(origin, matrix);
-        }
-    }
-    /** An immutable 2x3 identity matrix. */
-    Trans2x3.identity = new Trans2x3();
-    TextureMapping.Trans2x3 = Trans2x3;
-    /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */
-    class Params {
-        constructor(props) {
-            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.
-         * @internal
-         */
-        computeUVParams(visitor, transformToImodel) {
-            switch (this.mode) {
-                default: // Fall through to parametric in default case
-                case TextureMapping.Mode.Parametric: {
-                    return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);
-                }
-                case TextureMapping.Mode.Planar: {
-                    const normalIndices = visitor.normalIndex;
-                    if (!normalIndices)
-                        return undefined;
-                    // Ignore planar mode unless master or sub units for scaleMode and facet is planar
-                    if (!this.worldMapping || (visitor.normalIndex !== undefined && (normalIndices[0] !== normalIndices[1] || normalIndices[0] !== normalIndices[2]))) {
-                        return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);
-                    }
-                    else {
-                        return this.computePlanarUVParams(visitor, this.textureMatrix.transform);
-                    }
-                }
-                case TextureMapping.Mode.ElevationDrape: {
-                    return this.computeElevationDrapeUVParams(visitor, this.textureMatrix.transform, transformToImodel);
-                }
-            }
-        }
-        /** Computes UV parameters given a texture mapping mode of parametric. */
-        computeParametricUVParams(visitor, uvTransform, isRelativeUnits) {
-            const params = [];
-            for (let i = 0; i < visitor.numEdgesThisFacet; i++) {
-                let param = Point2d.create();
-                if (isRelativeUnits || !visitor.tryGetDistanceParameter(i, param)) {
-                    if (!visitor.tryGetNormalizedParameter(i, param)) {
-                        // If mesh does not have facetFaceData, we still want to use the texture coordinates if they are present
-                        param = visitor.getParam(i);
-                    }
-                }
-                params.push(uvTransform.multiplyPoint2d(param));
-            }
-            return params;
-        }
-        /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */
-        computePlanarUVParams(visitor, uvTransform) {
-            const params = [];
-            const points = visitor.point;
-            let normal;
-            if (visitor.normal === undefined)
-                normal = points.getPoint3dAtUncheckedPointIndex(0).crossProductToPoints(points.getPoint3dAtUncheckedPointIndex(1), points.getPoint3dAtUncheckedPointIndex(2));
-            else
-                normal = visitor.normal.getVector3dAtCheckedVectorIndex(0);
-            if (!normal.normalize(normal))
-                return undefined;
-            // adjust U texture coordinate to be a continuous length starting at the
-            // origin. V coordinate stays the same. This mode assumes Z is up vector
-            // Flipping normal puts us in a planar coordinate system consistent with MicroStation's display system
-            normal.scale(-1.0, normal);
-            // pick the first vertex normal
-            const sideVector = Vector3d.create(normal.y, -normal.x, 0.0);
-            // if the magnitude of the normal is near zero, the real normal points
-            // almost straighten up.. In this case, use Y as the up vector to match QV
-            const magnitude = sideVector.magnitude();
-            sideVector.normalize(sideVector); // won't remain undefined if failed due to following check..
-            if (magnitude < 1e-3) {
-                normal.set(0, 0, -1);
-                sideVector.set(1, 0, 0);
-            }
-            const upVector = sideVector.crossProduct(normal).normalize();
-            if (!upVector)
-                return undefined;
-            const numEdges = visitor.numEdgesThisFacet;
-            for (let i = 0; i < numEdges; i++) {
-                const vector = Vector3d.createFrom(points.getPoint3dAtUncheckedPointIndex(i));
-                params.push(Point2d.create(vector.dotProduct(sideVector), vector.dotProduct(upVector)));
-                uvTransform.multiplyPoint2d(params[i], params[i]);
-            }
-            return params;
-        }
-        /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */
-        computeElevationDrapeUVParams(visitor, uvTransform, transformToIModel) {
-            const params = [];
-            const numEdges = visitor.numEdgesThisFacet;
-            for (let i = 0; i < numEdges; i++) {
-                const point = visitor.point.getPoint3dAtUncheckedPointIndex(i);
-                if (transformToIModel !== undefined)
-                    transformToIModel.multiplyPoint3d(point, point);
-                params.push(Point2d.createFrom(point));
-                uvTransform.multiplyPoint2d(params[i], params[i]);
-            }
-            return params;
-        }
-    }
-    TextureMapping.Params = Params;
-})(TextureMapping || (TextureMapping = {}));
-Object.freeze(TextureMapping.Trans2x3.identity);
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Rendering
+ */
+import { Matrix3d, Point2d, Point3d, Transform, Vector3d } from "@itwin/core-geometry";
+/** Describes how to map a [[RenderTexture]]'s image onto a surface as part of a [[RenderMaterial]].
+ * @public
+ */
+export class TextureMapping {
+    constructor(tx, params) {
+        this.texture = tx;
+        this.params = params;
+    }
+    /** @internal */
+    computeUVParams(visitor, transformToImodel) {
+        return this.params.computeUVParams(visitor, transformToImodel);
+    }
+}
+/** @public */
+(function (TextureMapping) {
+    /** Enumerates the possible texture mapping modes. */
+    let Mode;
+    (function (Mode) {
+        Mode[Mode["None"] = -1] = "None";
+        Mode[Mode["Parametric"] = 0] = "Parametric";
+        Mode[Mode["ElevationDrape"] = 1] = "ElevationDrape";
+        Mode[Mode["Planar"] = 2] = "Planar";
+        /** @internal */
+        Mode[Mode["DirectionalDrape"] = 3] = "DirectionalDrape";
+        /** @internal */
+        Mode[Mode["Cubic"] = 4] = "Cubic";
+        /** @internal */
+        Mode[Mode["Spherical"] = 5] = "Spherical";
+        /** @internal */
+        Mode[Mode["Cylindrical"] = 6] = "Cylindrical";
+        /** @internal */
+        Mode[Mode["Solid"] = 7] = "Solid";
+        /** @internal Only valid for lights */
+        Mode[Mode["FrontProject"] = 8] = "FrontProject";
+    })(Mode = TextureMapping.Mode || (TextureMapping.Mode = {}));
+    /** A 2x3 matrix for mapping a texture image to a surface. */
+    class Trans2x3 {
+        /** Construct from the two rows of the matrix:
+         * ```
+         *  | m00 m01 originX |
+         *  | m10 m11 originY |
+         * ```
+         * Producing the [Transform]($core-geometry):
+         * ```
+         *  | m00 m01 0 originX |
+         *  | m10 m11 0 originY |
+         *  | 0   0   1 0       |
+         * ```
+         */
+        constructor(m00 = 1, m01 = 0, originX = 0, m10 = 0, m11 = 1, originY = 0) {
+            const origin = new Point3d(originX, originY, 0);
+            const matrix = Matrix3d.createRowValues(m00, m01, 0, m10, m11, 0, 0, 0, 1);
+            this.transform = Transform.createRefs(origin, matrix);
+        }
+    }
+    /** An immutable 2x3 identity matrix. */
+    Trans2x3.identity = new Trans2x3();
+    TextureMapping.Trans2x3 = Trans2x3;
+    /** Parameters describing how a [[RenderTexture]]'s image is mapped to a surface. */
+    class Params {
+        constructor(props) {
+            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.
+         * @internal
+         */
+        computeUVParams(visitor, transformToImodel) {
+            switch (this.mode) {
+                default: // Fall through to parametric in default case
+                case TextureMapping.Mode.Parametric: {
+                    return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);
+                }
+                case TextureMapping.Mode.Planar: {
+                    const normalIndices = visitor.normalIndex;
+                    if (!normalIndices)
+                        return undefined;
+                    // Ignore planar mode unless master or sub units for scaleMode and facet is planar
+                    if (!this.worldMapping || (visitor.normalIndex !== undefined && (normalIndices[0] !== normalIndices[1] || normalIndices[0] !== normalIndices[2]))) {
+                        return this.computeParametricUVParams(visitor, this.textureMatrix.transform, !this.worldMapping);
+                    }
+                    else {
+                        return this.computePlanarUVParams(visitor, this.textureMatrix.transform);
+                    }
+                }
+                case TextureMapping.Mode.ElevationDrape: {
+                    return this.computeElevationDrapeUVParams(visitor, this.textureMatrix.transform, transformToImodel);
+                }
+            }
+        }
+        /** Computes UV parameters given a texture mapping mode of parametric. */
+        computeParametricUVParams(visitor, uvTransform, isRelativeUnits) {
+            const params = [];
+            for (let i = 0; i < visitor.numEdgesThisFacet; i++) {
+                let param = Point2d.create();
+                if (isRelativeUnits || !visitor.tryGetDistanceParameter(i, param)) {
+                    if (!visitor.tryGetNormalizedParameter(i, param)) {
+                        // If mesh does not have facetFaceData, we still want to use the texture coordinates if they are present
+                        param = visitor.getParam(i);
+                    }
+                }
+                params.push(uvTransform.multiplyPoint2d(param));
+            }
+            return params;
+        }
+        /** Computes UV parameters given a texture mapping mode of planar. The result is stored in the Point2d array given. */
+        computePlanarUVParams(visitor, uvTransform) {
+            const params = [];
+            const points = visitor.point;
+            let normal;
+            if (visitor.normal === undefined)
+                normal = points.getPoint3dAtUncheckedPointIndex(0).crossProductToPoints(points.getPoint3dAtUncheckedPointIndex(1), points.getPoint3dAtUncheckedPointIndex(2));
+            else
+                normal = visitor.normal.getVector3dAtCheckedVectorIndex(0);
+            if (!normal.normalize(normal))
+                return undefined;
+            // adjust U texture coordinate to be a continuous length starting at the
+            // origin. V coordinate stays the same. This mode assumes Z is up vector
+            // Flipping normal puts us in a planar coordinate system consistent with MicroStation's display system
+            normal.scale(-1.0, normal);
+            // pick the first vertex normal
+            const sideVector = Vector3d.create(normal.y, -normal.x, 0.0);
+            // if the magnitude of the normal is near zero, the real normal points
+            // almost straighten up.. In this case, use Y as the up vector to match QV
+            const magnitude = sideVector.magnitude();
+            sideVector.normalize(sideVector); // won't remain undefined if failed due to following check..
+            if (magnitude < 1e-3) {
+                normal.set(0, 0, -1);
+                sideVector.set(1, 0, 0);
+            }
+            const upVector = sideVector.crossProduct(normal).normalize();
+            if (!upVector)
+                return undefined;
+            const numEdges = visitor.numEdgesThisFacet;
+            for (let i = 0; i < numEdges; i++) {
+                const vector = Vector3d.createFrom(points.getPoint3dAtUncheckedPointIndex(i));
+                params.push(Point2d.create(vector.dotProduct(sideVector), vector.dotProduct(upVector)));
+                uvTransform.multiplyPoint2d(params[i], params[i]);
+            }
+            return params;
+        }
+        /** Computes UV parameters given a texture mapping mode of elevation drape. The result is stored in the Point2d array given. */
+        computeElevationDrapeUVParams(visitor, uvTransform, transformToIModel) {
+            const params = [];
+            const numEdges = visitor.numEdgesThisFacet;
+            for (let i = 0; i < numEdges; i++) {
+                const point = visitor.point.getPoint3dAtUncheckedPointIndex(i);
+                if (transformToIModel !== undefined)
+                    transformToIModel.multiplyPoint3d(point, point);
+                params.push(Point2d.createFrom(point));
+                uvTransform.multiplyPoint2d(params[i], params[i]);
+            }
+            return params;
+        }
+    }
+    TextureMapping.Params = Params;
+})(TextureMapping || (TextureMapping = {}));
+Object.freeze(TextureMapping.Trans2x3.identity);
 //# sourceMappingURL=TextureMapping.js.map