@itwin/core-frontend 4.1.0-dev.7 → 4.1.0-dev.70

package/lib/cjs/common/render/AnimationNodeId.d.ts

@@ -0,0 +1,11 @@
+/** @packageDocumentation
+ * @module Rendering
+ */
+/** Special values of [[GraphicBranch.animationNodeId]].
+ * All other values refer to an [ElementTimeline.batchId]($common) that applies a transform to the graphics in the branch.
+ * @internal
+ */
+export declare enum AnimationNodeId {
+    Untransformed = 4294967295
+}
+//# sourceMappingURL=AnimationNodeId.d.ts.map

package/lib/cjs/common/render/AnimationNodeId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationNodeId.d.ts","sourceRoot":"","sources":["../../../../src/common/render/AnimationNodeId.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;GAGG;AACH,oBAAY,eAAe;IACzB,aAAa,aAAa;CAC3B"}

package/lib/cjs/common/render/AnimationNodeId.js

@@ -0,0 +1,19 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnimationNodeId = void 0;
+/** Special values of [[GraphicBranch.animationNodeId]].
+ * All other values refer to an [ElementTimeline.batchId]($common) that applies a transform to the graphics in the branch.
+ * @internal
+ */
+var AnimationNodeId;
+(function (AnimationNodeId) {
+    AnimationNodeId[AnimationNodeId["Untransformed"] = 4294967295] = "Untransformed";
+})(AnimationNodeId = exports.AnimationNodeId || (exports.AnimationNodeId = {}));
+//# sourceMappingURL=AnimationNodeId.js.map

package/lib/cjs/common/render/AnimationNodeId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationNodeId.js","sourceRoot":"","sources":["../../../../src/common/render/AnimationNodeId.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH;;;GAGG;AACH,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,gFAA0B,CAAA;AAC5B,CAAC,EAFW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAE1B","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\n/** Special values of [[GraphicBranch.animationNodeId]].\r\n * All other values refer to an [ElementTimeline.batchId]($common) that applies a transform to the graphics in the branch.\r\n * @internal\r\n */\r\nexport enum AnimationNodeId {\r\n  Untransformed = 0xffffffff,\r\n}\r\n"]}

package/lib/{esm/render/RenderMaterial.d.ts → cjs/common/render/MaterialParams.d.ts}

@@ -1,19 +1,9 @@
 /** @packageDocumentation
  * @module Rendering
  */
-import { Id64String } from "@itwin/core-bentley";
 import { ColorDef, NormalMapParams, RenderTexture, RgbColorProps, TextureMapping } from "@itwin/core-common";
-import { IModelConnection } from "../IModelConnection";
-/** Specifies the provenance of a [RenderMaterial]($common) created for a persistent material element.
- * @see [[CreateRenderMaterialArgs.source]].
- * @internal
- */
-export interface RenderMaterialSource {
-    iModel: IModelConnection;
-    id: Id64String;
-}
 /** Describes the [diffuse](https://en.wikipedia.org/wiki/Diffuse_reflection) properties of a [RenderMaterial]($common).
- * @see [[CreateRenderMaterialArgs.diffuse]].
+ * @see [[MaterialParams.diffuse]].
  * @public
  */
 export interface MaterialDiffuseProps {
@@ -25,7 +15,7 @@ export interface MaterialDiffuseProps {
     weight?: number;
 }
 /** Describes the [specular](https://en.wikipedia.org/wiki/Specular_highlight) properties of a material.
- * @see [[CreateRenderMaterialArgs.specular]].
+ * @see [[MaterialParams.specular]].
  * @public
  */
 export interface MaterialSpecularProps {
@@ -43,7 +33,7 @@ export interface MaterialSpecularProps {
     exponent?: number;
 }
 /** Describes how to map a [RenderTexture]($common)'s image to the surfaces to which a [RenderMaterial]($common) is applied.
- * @see [[CreateRenderMaterialArgs.textureMapping]].
+ * @see [[MaterialParams.textureMapping]].
  * @public
  */
 export interface MaterialTextureMappingProps {
@@ -75,14 +65,11 @@ export interface MaterialTextureMappingProps {
      */
     constantLodProps?: TextureMapping.ConstantLodParamProps;
 }
-/** Arguments supplied to [[RenderSystem.createRenderMaterial]].
+/** Describes a [RenderMaterial]($common).
+ * @see [[RenderSystem.createRenderMaterial]] to create a material.
  * @public
  */
-export interface CreateRenderMaterialArgs {
-    /** If supplied, the material will be cached on the iModel by its element Id for subsequent reuse.
-     * @internal
-     */
-    source?: RenderMaterialSource;
+export interface MaterialParams {
     /** Specifies the transparency of the material from 0.0 (fully transparent) to 1.0 (fully opaque).
      * If defined, this overrides the transparency of any surface to which the material is applied, and is multiplied with the
      * transparency of the material's [[textureMapping]] when sampling the texture.
@@ -95,4 +82,4 @@ export interface CreateRenderMaterialArgs {
     /** Maps [RenderTexture]($common) images to the surfaces to which the material is applied to customize their appearance. */
     textureMapping?: MaterialTextureMappingProps;
 }
-//# sourceMappingURL=RenderMaterial.d.ts.map
+//# sourceMappingURL=MaterialParams.d.ts.map

package/lib/cjs/common/render/MaterialParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialParams.d.ts","sourceRoot":"","sources":["../../../../src/common/render/MaterialParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+GAA+G;IAC/G,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,oDAAoD;IACpD,OAAO,EAAE,aAAa,CAAC;IAEvB,sGAAsG;IACtG,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC;IAEpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,cAAc,CAAC,qBAAqB,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kGAAkG;IAClG,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAE/B,mGAAmG;IACnG,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAEjC,2HAA2H;IAC3H,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C"}

package/lib/cjs/{render/RenderMaterial.js → common/render/MaterialParams.js}

@@ -7,4 +7,4 @@
  * @module Rendering
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=RenderMaterial.js.map
+//# sourceMappingURL=MaterialParams.js.map

package/lib/cjs/common/render/MaterialParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialParams.js","sourceRoot":"","sources":["../../../../src/common/render/MaterialParams.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 { ColorDef, NormalMapParams, RenderTexture, RgbColorProps, TextureMapping } from \"@itwin/core-common\";\r\n\r\n/** Describes the [diffuse](https://en.wikipedia.org/wiki/Diffuse_reflection) properties of a [RenderMaterial]($common).\r\n * @see [[MaterialParams.diffuse]].\r\n * @public\r\n */\r\nexport interface MaterialDiffuseProps {\r\n  /** The diffuse color. If defined, this overrides the color of any surface to which the material is applied. */\r\n  color?: ColorDef | RgbColorProps;\r\n\r\n  /** A multiplier in [0..1] specifying how strongly the diffuse color reflects light.\r\n   * Default: 0.6\r\n   */\r\n  weight?: number;\r\n}\r\n\r\n/** Describes the [specular](https://en.wikipedia.org/wiki/Specular_highlight) properties of a material.\r\n * @see [[MaterialParams.specular]].\r\n * @public\r\n */\r\nexport interface MaterialSpecularProps {\r\n  /** The color of the specular reflections.\r\n   * Default: white.\r\n   */\r\n  color?: ColorDef | RgbColorProps;\r\n\r\n  /** A multiplier in [0..1] specifying the strength of the specular reflections.\r\n   * Default: 0.4\r\n   */\r\n  weight?: number;\r\n\r\n  /** An exponent in [0..infinity] describing the shininess of the surface.\r\n   * Default: 13.5\r\n   */\r\n  exponent?: number;\r\n}\r\n\r\n/** Describes how to map a [RenderTexture]($common)'s image to the surfaces to which a [RenderMaterial]($common) is applied.\r\n * @see [[MaterialParams.textureMapping]].\r\n * @public\r\n */\r\nexport interface MaterialTextureMappingProps {\r\n  /** The texture from which the image is obtained. */\r\n  texture: RenderTexture;\r\n\r\n  /** The parameters describing a normal map to use either in place of or in addition to the texture. */\r\n  normalMapParams?: NormalMapParams;\r\n\r\n  /** The mode controlling how the image is mapped onto the surface.\r\n   * Default: [TextureMapping.Mode.Parametric]($common).\r\n   */\r\n  mode?: TextureMapping.Mode;\r\n\r\n  /** A 2x3 matrix for computing the UV coordinates.\r\n   * Default: [TextureMapping.Trans2x3.identity]($common).\r\n   */\r\n  transform?: TextureMapping.Trans2x3;\r\n\r\n  /** The ratio by which the color sampled from the texture image is mixed with the surface's or material's diffuse color.\r\n   * A ratio of 1 selects only the texture sample; a ratio of 0 selects only the diffuse color; a ratio of 0.5 mixes them evenly.\r\n   * Default: 1.\r\n   */\r\n  weight?: number;\r\n\r\n  /** @internal */\r\n  worldMapping?: boolean;\r\n\r\n  /** True if want to use constant LOD texture mapping for the surface texture.\r\n   * Default: false.\r\n   */\r\n  useConstantLod?: boolean;\r\n\r\n  /** Parameters for constant LOD mapping mode.\r\n   * See [[TextureMapping.ConstantLodParamProps]] for defaults.\r\n   */\r\n  constantLodProps?: TextureMapping.ConstantLodParamProps;\r\n}\r\n\r\n/** Describes a [RenderMaterial]($common).\r\n * @see [[RenderSystem.createRenderMaterial]] to create a material.\r\n * @public\r\n */\r\nexport interface MaterialParams {\r\n  /** Specifies the transparency of the material from 0.0 (fully transparent) to 1.0 (fully opaque).\r\n   * If defined, this overrides the transparency of any surface to which the material is applied, and is multiplied with the\r\n   * transparency of the material's [[textureMapping]] when sampling the texture.\r\n   */\r\n  alpha?: number;\r\n\r\n  /** The [diffuse](https://en.wikipedia.org/wiki/Diffuse_reflection) properties of the material. */\r\n  diffuse?: MaterialDiffuseProps;\r\n\r\n  /** The [specular](https://en.wikipedia.org/wiki/Specular_highlight) properties of the material. */\r\n  specular?: MaterialSpecularProps;\r\n\r\n  /** Maps [RenderTexture]($common) images to the surfaces to which the material is applied to customize their appearance. */\r\n  textureMapping?: MaterialTextureMappingProps;\r\n}\r\n\r\n"]}

package/lib/cjs/common/render/TextureParams.d.ts

@@ -0,0 +1,30 @@
+/** @packageDocumentation
+ * @module Rendering
+ */
+import { Gradient, ImageBuffer, TextureTransparency } from "@itwin/core-common";
+/** An object from which a [RenderTexture]($common) can be created.
+ * @see [[TextureImage.source]]
+ * @public
+ * @extensions
+ */
+export type TextureImageSource = HTMLImageElement | ImageBuffer | ImageBitmap;
+/** Describes the image from which to create a [RenderTexture]($common).
+ * @see [[CreateTextureArgs.image]]
+ * @public
+ * @extensions
+ */
+export interface TextureImage {
+    /** The object that supplies the texture image. */
+    source: TextureImageSource;
+    /** Describes the transparency of the image. If this information can be supplied, it can improve performance.
+     * If this information is not available at the call site, omit it - it defaults to "mixed" if it cannot be inferred from the source.
+     */
+    transparency?: TextureTransparency;
+}
+/** A key that uniquely identifies a [RenderTexture]($common) in the context of an [[IModelConnection]], used for caching.
+ * @see [[TextureCacheOwnership]].
+ * @public
+ * @extensions
+ */
+export type TextureCacheKey = string | Gradient.Symb;
+//# sourceMappingURL=TextureParams.d.ts.map

package/lib/cjs/common/render/TextureParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureParams.d.ts","sourceRoot":"","sources":["../../../../src/common/render/TextureParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC"}

package/lib/cjs/{render/RenderTexture.js → common/render/TextureParams.js}

@@ -7,4 +7,4 @@
  * @module Rendering
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=RenderTexture.js.map
+//# sourceMappingURL=TextureParams.js.map

package/lib/cjs/common/render/TextureParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureParams.js","sourceRoot":"","sources":["../../../../src/common/render/TextureParams.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 { Gradient, ImageBuffer, TextureTransparency } from \"@itwin/core-common\";\r\n\r\n/** An object from which a [RenderTexture]($common) can be created.\r\n * @see [[TextureImage.source]]\r\n * @public\r\n * @extensions\r\n */\r\nexport type TextureImageSource = HTMLImageElement | ImageBuffer | ImageBitmap; // ###TODO | HTMLCanvasElement etc\r\n\r\n/** Describes the image from which to create a [RenderTexture]($common).\r\n * @see [[CreateTextureArgs.image]]\r\n * @public\r\n * @extensions\r\n */\r\nexport interface TextureImage {\r\n  /** The object that supplies the texture image. */\r\n  source: TextureImageSource;\r\n  /** Describes the transparency of the image. If this information can be supplied, it can improve performance.\r\n   * If this information is not available at the call site, omit it - it defaults to \"mixed\" if it cannot be inferred from the source.\r\n   */\r\n  transparency?: TextureTransparency;\r\n}\r\n\r\n/** A key that uniquely identifies a [RenderTexture]($common) in the context of an [[IModelConnection]], used for caching.\r\n * @see [[TextureCacheOwnership]].\r\n * @public\r\n * @extensions\r\n */\r\nexport type TextureCacheKey = string | Gradient.Symb;\r\n"]}

package/lib/{esm → cjs/common}/render/primitives/AuxChannelTable.d.ts

@@ -2,18 +2,18 @@
  * @module Rendering
  */
 import { AuxChannel as PolyfaceAuxChannel } from "@itwin/core-geometry";
-/** @internal */
+/** @alpha */
 export interface AuxChannelProps {
     readonly name: string;
     readonly inputs: number[];
     readonly indices: number[];
 }
-/** @internal */
+/** @alpha */
 export interface QuantizedAuxChannelProps extends AuxChannelProps {
     readonly qOrigin: number[];
     readonly qScale: number[];
 }
-/** @internal */
+/** @alpha */
 export declare class AuxChannel implements AuxChannelProps {
     readonly name: string;
     readonly inputs: number[];
@@ -21,21 +21,21 @@ export declare class AuxChannel implements AuxChannelProps {
     constructor(props: AuxChannelProps);
     toJSON(): AuxChannelProps;
 }
-/** @internal */
+/** @alpha */
 export declare class AuxDisplacementChannel extends AuxChannel {
     readonly qOrigin: Float32Array;
     readonly qScale: Float32Array;
     constructor(props: QuantizedAuxChannelProps);
     toJSON(): QuantizedAuxChannelProps;
 }
-/** @internal */
+/** @alpha */
 export declare class AuxParamChannel extends AuxChannel {
     readonly qOrigin: number;
     readonly qScale: number;
     constructor(props: QuantizedAuxChannelProps);
     toJSON(): QuantizedAuxChannelProps;
 }
-/** @internal */
+/** @alpha */
 export interface AuxChannelTableProps {
     /** Rectangular array of per-vertex data, of size width * height * numBytesPerVertex bytes. */
     readonly data: Uint8Array;
@@ -60,7 +60,7 @@ export interface AuxChannelTableProps {
  * The channels are interleaved in a rectangular array such that the data for each vertex is stored contiguously; that is, if a displacement and
  * a normal channel exist, then the first vertex's displacement is followed by the first vertex's normal, which is followed by the second
  * vertex's displacement and normal; and so on.
- * @internal
+ * @alpha
  */
 export declare class AuxChannelTable {
     /** Rectangular array of per-vertex data, of size width * height * numBytesPerVertex bytes. */
@@ -82,6 +82,6 @@ export declare class AuxChannelTable {
     private constructor();
     static fromJSON(props: AuxChannelTableProps): AuxChannelTable | undefined;
     toJSON(): AuxChannelTableProps;
-    static fromChannels(channels: ReadonlyArray<PolyfaceAuxChannel>, numVertices: number): AuxChannelTable | undefined;
+    static fromChannels(channels: ReadonlyArray<PolyfaceAuxChannel>, numVertices: number, maxDimension: number): AuxChannelTable | undefined;
 }
 //# sourceMappingURL=AuxChannelTable.d.ts.map

package/lib/cjs/common/render/primitives/AuxChannelTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuxChannelTable.d.ts","sourceRoot":"","sources":["../../../../../src/common/render/primitives/AuxChannelTable.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACwB,UAAU,IAAI,kBAAkB,EAC9D,MAAM,sBAAsB,CAAC;AAI9B,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,aAAa;AACb,qBAAa,UAAW,YAAW,eAAe;IAChD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjC,SAAgB,OAAO,EAAE,MAAM,EAAE,CAAC;gBAEf,KAAK,EAAE,eAAe;IAMlC,MAAM,IAAI,eAAe;CAOjC;AAED,aAAa;AACb,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,MAAM,EAAE,YAAY,CAAC;gBAElB,KAAK,EAAE,wBAAwB;IAMlC,MAAM,IAAI,wBAAwB;CAOnD;AAED,aAAa;AACb,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEZ,KAAK,EAAE,wBAAwB;IAMlC,MAAM,IAAI,wBAAwB;CAOnD;AAED,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpD,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,8FAA8F;IAC9F,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,kEAAkE;IAClE,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,sGAAsG;IACtG,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,gFAAgF;IAChF,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAC1C,yCAAyC;IACzC,SAAgB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzD,mCAAmC;IACnC,SAAgB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvC,yCAAyC;IACzC,SAAgB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAE3C,OAAO;WAWO,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,GAAG,SAAS;IA0BzE,MAAM,IAAI,oBAAoB;WAavB,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;CAGhJ"}

package/lib/cjs/{render → common/render}/primitives/AuxChannelTable.js

@@ -12,7 +12,7 @@ const core_bentley_1 = require("@itwin/core-bentley");
 const core_geometry_1 = require("@itwin/core-geometry");
 const core_common_1 = require("@itwin/core-common");
 const VertexTable_1 = require("./VertexTable");
-/** @internal */
+/** @alpha */
 class AuxChannel {
     constructor(props) {
         this.name = props.name;
@@ -28,7 +28,7 @@ class AuxChannel {
     }
 }
 exports.AuxChannel = AuxChannel;
-/** @internal */
+/** @alpha */
 class AuxDisplacementChannel extends AuxChannel {
     constructor(props) {
         super(props);
@@ -44,7 +44,7 @@ class AuxDisplacementChannel extends AuxChannel {
     }
 }
 exports.AuxDisplacementChannel = AuxDisplacementChannel;
-/** @internal */
+/** @alpha */
 class AuxParamChannel extends AuxChannel {
     constructor(props) {
         super(props);
@@ -66,7 +66,7 @@ exports.AuxParamChannel = AuxParamChannel;
  * The channels are interleaved in a rectangular array such that the data for each vertex is stored contiguously; that is, if a displacement and
  * a normal channel exist, then the first vertex's displacement is followed by the first vertex's normal, which is followed by the second
  * vertex's displacement and normal; and so on.
- * @internal
+ * @alpha
  */
 class AuxChannelTable {
     constructor(props, displacements, normals, params) {
@@ -112,8 +112,8 @@ class AuxChannelTable {
             params: this.params?.map((x) => x.toJSON()),
         };
     }
-    static fromChannels(channels, numVertices) {
-        return AuxChannelTableBuilder.buildAuxChannelTable(channels, numVertices);
+    static fromChannels(channels, numVertices, maxDimension) {
+        return AuxChannelTableBuilder.buildAuxChannelTable(channels, numVertices, maxDimension);
     }
 }
 exports.AuxChannelTable = AuxChannelTable;
@@ -128,7 +128,7 @@ class AuxChannelTableBuilder {
         this._numBytesPerVertex = numBytesPerVertex;
         this._view = new DataView(props.data.buffer);
     }
-    static buildAuxChannelTable(channels, numVertices) {
+    static buildAuxChannelTable(channels, numVertices, maxDimension) {
         const numBytesPerVertex = channels.reduce((accum, channel) => accum + computeNumBytesPerVertex(channel), 0);
         if (!numBytesPerVertex)
             return undefined;
@@ -138,9 +138,9 @@ class AuxChannelTableBuilder {
         // We don't want any unused bytes. If we've got 2 extra, make every other vertex's channel start in the middle of the first texel.
         let dimensions;
         if (0 !== nUnusedBytesPerVertex)
-            dimensions = (0, VertexTable_1.computeDimensions)(Math.floor((numVertices + 1) / 2), numBytesPerVertex / 2, 0); // twice as many RGBA for half as many vertices.
+            dimensions = (0, VertexTable_1.computeDimensions)(Math.floor((numVertices + 1) / 2), numBytesPerVertex / 2, 0, maxDimension); // twice as many RGBA for half as many vertices.
         else
-            dimensions = (0, VertexTable_1.computeDimensions)(numVertices, nRgbaPerVertex, 0);
+            dimensions = (0, VertexTable_1.computeDimensions)(numVertices, nRgbaPerVertex, 0, maxDimension);
         const data = new Uint8Array(dimensions.width * dimensions.height * 4);
         const props = {
             data,

package/lib/cjs/common/render/primitives/AuxChannelTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuxChannelTable.js","sourceRoot":"","sources":["../../../../../src/common/render/primitives/AuxChannelTable.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAsD;AACtD,wDAE8B;AAC9B,oDAAyF;AACzF,+CAAkD;AAelD,aAAa;AACb,MAAa,UAAU;IAKrB,YAAmB,KAAsB;QACvC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAlBD,gCAkBC;AAED,aAAa;AACb,MAAa,sBAAuB,SAAQ,UAAU;IAIpD,YAAmB,KAA+B;QAChD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;SAChC,CAAC;IACJ,CAAC;CACF;AAjBD,wDAiBC;AAED,aAAa;AACb,MAAa,eAAgB,SAAQ,UAAU;IAI7C,YAAmB,KAA+B;QAChD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;SACtB,CAAC;IACJ,CAAC;CACF;AAjBD,0CAiBC;AAsBD;;;;;;;GAOG;AACH,MAAa,eAAe;IAkB1B,YAAoB,KAA2B,EAAE,aAAwC,EAAE,OAAsB,EAAE,MAA0B;QAC3I,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;QACjD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,KAA2B;QAChD,IAAI,aAAmD,CAAC;QACxD,IAAI,OAAiC,CAAC;QACtC,IAAI,MAAqC,CAAC;QAE1C,IAAI,SAAS,KAAK,KAAK,CAAC,aAAa,IAAI,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE;YACvE,aAAa,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,aAAa;gBAC5C,aAAa,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;SAChE;QAED,IAAI,SAAS,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;YAC3D,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO;gBAChC,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;SACxC;QAED,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;YACzD,MAAM,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;SAC3C;QAED,OAAO,SAAS,KAAK,aAAa,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/J,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,WAAW;YACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACzD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,QAA2C,EAAE,WAAmB,EAAE,YAAoB;QAC/G,OAAO,sBAAsB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC1F,CAAC;CACF;AAvED,0CAuEC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,CAAC,KAAK,GAAG;QACX,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAEhB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,sBAAsB;IAK1B,YAAoB,KAAoC,EAAE,iBAAyB;QACjF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEM,MAAM,CAAC,oBAAoB,CAAC,QAA2C,EAAE,WAAmB,EAAE,YAAoB;QACvH,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5G,IAAI,CAAC,iBAAiB;YACpB,OAAO,SAAS,CAAC;QAEnB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,qBAAqB,GAAG,cAAc,GAAG,CAAC,GAAG,iBAAiB,CAAC;QACrE,IAAA,qBAAM,EAAC,CAAC,KAAK,qBAAqB,IAAI,CAAC,KAAK,qBAAqB,CAAC,CAAC;QAEnE,kIAAkI;QAClI,IAAI,UAAU,CAAC;QACf,IAAI,CAAC,KAAK,qBAAqB;YAC7B,UAAU,GAAG,IAAA,+BAAiB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,gDAAgD;;YAE3J,UAAU,GAAG,IAAA,+BAAiB,EAAC,WAAW,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;QAE/E,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtE,MAAM,KAAK,GAAkC;YAC3C,IAAI;YACJ,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,KAAK,EAAE,WAAW;YAClB,iBAAiB;SAClB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,QAA2C;QACvD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;YAC9B,IAAI,kCAAkB,CAAC,MAAM,KAAK,OAAO,CAAC,QAAQ;gBAChD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;iBAClC,IAAI,kCAAkB,CAAC,MAAM,KAAK,OAAO,CAAC,QAAQ;gBACrD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;;gBAE3C,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEtC,UAAU,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;SACjD;IACH,CAAC;IAEO,UAAU,CAAC,OAA2B,EAAE,UAAkB;QAChE,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,MAAM,MAAM,GAAG,IAAI,wBAAQ,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC5C,IAAI,SAAS,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;YACzD,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,sCAAsC;YAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;gBAC9C,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9B,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9B,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAE1B,MAAM,aAAa,GAAG,8BAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;gBACrD,SAAS,IAAI,IAAI,CAAC,kBAAkB,CAAC;aACtC;SACF;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,MAAM;YACN,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,OAA2B,EAAE,UAAkB;QAC/D,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,MAAM,KAAK,GAAG,uBAAO,CAAC,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAChC;QAED,MAAM,MAAM,GAAG,0BAAY,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC5C,IAAI,SAAS,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;YACzD,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,sCAAsC;YAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;gBAC1C,MAAM,SAAS,GAAG,0BAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAClE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;gBACjD,SAAS,IAAI,IAAI,CAAC,kBAAkB,CAAC;aACtC;SACF;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,MAAM;YACN,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;YACpB,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,OAA2B,EAAE,UAAkB;QACtE,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,MAAM,KAAK,GAAG,IAAI,uBAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,uBAAO,CAAC,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;gBAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACrB;SACF;QAED,MAAM,OAAO,GAAG,uBAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,sBAAQ,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC5C,IAAI,SAAS,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,yBAAyB;YAC7D,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,sCAAsC;YAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;gBAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAE5B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACpD,SAAS,IAAI,IAAI,CAAC,kBAAkB,CAAC;aACtC;SACF;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;QACpF,aAAa,CAAC,IAAI,CAAC;YACjB,MAAM;YACN,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;YACjC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,wBAAwB,CAAC,OAA2B;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACrC,QAAQ,OAAO,CAAC,QAAQ,EAAE;QACxB,KAAK,kCAAkB,CAAC,MAAM;YAC5B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,kDAAkD;QACzE,KAAK,kCAAkB,CAAC,MAAM,CAAC;QAC/B,KAAK,kCAAkB,CAAC,QAAQ,CAAC;QACjC,KAAK,kCAAkB,CAAC,MAAM;YAC5B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,sCAAsC;KAC9D;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 Rendering\r\n */\r\n\r\nimport { assert, Mutable } from \"@itwin/core-bentley\";\r\nimport {\r\n  AuxChannelDataType, Point3d, AuxChannel as PolyfaceAuxChannel, Range1d, Range3d, Vector3d,\r\n} from \"@itwin/core-geometry\";\r\nimport { OctEncodedNormal, QParams3d, QPoint3d, Quantization } from \"@itwin/core-common\";\r\nimport { computeDimensions } from \"./VertexTable\";\r\n\r\n/** @alpha */\r\nexport interface AuxChannelProps {\r\n  readonly name: string;\r\n  readonly inputs: number[];\r\n  readonly indices: number[];\r\n}\r\n\r\n/** @alpha */\r\nexport interface QuantizedAuxChannelProps extends AuxChannelProps {\r\n  readonly qOrigin: number[];\r\n  readonly qScale: number[];\r\n}\r\n\r\n/** @alpha */\r\nexport class AuxChannel implements AuxChannelProps {\r\n  public readonly name: string;\r\n  public readonly inputs: number[];\r\n  public readonly indices: number[];\r\n\r\n  public constructor(props: AuxChannelProps) {\r\n    this.name = props.name;\r\n    this.inputs = props.inputs;\r\n    this.indices = props.indices;\r\n  }\r\n\r\n  public toJSON(): AuxChannelProps {\r\n    return {\r\n      name: this.name,\r\n      inputs: this.inputs,\r\n      indices: this.indices,\r\n    };\r\n  }\r\n}\r\n\r\n/** @alpha */\r\nexport class AuxDisplacementChannel extends AuxChannel {\r\n  public readonly qOrigin: Float32Array;\r\n  public readonly qScale: Float32Array;\r\n\r\n  public constructor(props: QuantizedAuxChannelProps) {\r\n    super(props);\r\n    this.qOrigin = Float32Array.from(props.qOrigin);\r\n    this.qScale = Float32Array.from(props.qScale);\r\n  }\r\n\r\n  public override toJSON(): QuantizedAuxChannelProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      qOrigin: Array.from(this.qOrigin),\r\n      qScale: Array.from(this.qScale),\r\n    };\r\n  }\r\n}\r\n\r\n/** @alpha */\r\nexport class AuxParamChannel extends AuxChannel {\r\n  public readonly qOrigin: number;\r\n  public readonly qScale: number;\r\n\r\n  public constructor(props: QuantizedAuxChannelProps) {\r\n    super(props);\r\n    this.qOrigin = props.qOrigin[0];\r\n    this.qScale = props.qScale[0];\r\n  }\r\n\r\n  public override toJSON(): QuantizedAuxChannelProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      qOrigin: [this.qOrigin],\r\n      qScale: [this.qScale],\r\n    };\r\n  }\r\n}\r\n\r\n/** @alpha */\r\nexport interface AuxChannelTableProps {\r\n  /** Rectangular array of per-vertex data, of size width * height * numBytesPerVertex bytes. */\r\n  readonly data: Uint8Array;\r\n  /** The number of 4-byte RGBA columns in each row of the array. */\r\n  readonly width: number;\r\n  /** The number of rows in the array. */\r\n  readonly height: number;\r\n  /** The number of vertices in the array. Must be no more than (width * height) / numBytesPerVertex. */\r\n  readonly count: number;\r\n  /** The number of bytes allocated for each vertex. Must be a multiple of two. */\r\n  readonly numBytesPerVertex: number;\r\n  /** Displacements used for animations. */\r\n  readonly displacements?: QuantizedAuxChannelProps[];\r\n  /** Normals used for animations. */\r\n  readonly normals?: AuxChannelProps[];\r\n  /** Scalar params used for animations. */\r\n  readonly params?: QuantizedAuxChannelProps[];\r\n}\r\n\r\n/**\r\n * Represents one or more channels of auxiliary per-vertex data which can be used to animate and resymbolize a mesh in various ways.\r\n * Each channel holds a fixed number of bytes for each vertex (typically 2 bytes for normals and params, 6 bytes for displacements).\r\n * The channels are interleaved in a rectangular array such that the data for each vertex is stored contiguously; that is, if a displacement and\r\n * a normal channel exist, then the first vertex's displacement is followed by the first vertex's normal, which is followed by the second\r\n * vertex's displacement and normal; and so on.\r\n * @alpha\r\n */\r\nexport class AuxChannelTable {\r\n  /** Rectangular array of per-vertex data, of size width * height * numBytesPerVertex bytes. */\r\n  public readonly data: Uint8Array;\r\n  /** The number of 4-byte RGBA columns in each row of the array. */\r\n  public readonly width: number;\r\n  /** The number of rows in the array. */\r\n  public readonly height: number;\r\n  /** The number of vertices in the array. Must be no more than (width * height) / numBytesPerVertex. */\r\n  public readonly numVertices: number;\r\n  /** The number of bytes allocated for each vertex. Must be a multiple of two. */\r\n  public readonly numBytesPerVertex: number;\r\n  /** Displacements used for animations. */\r\n  public readonly displacements?: AuxDisplacementChannel[];\r\n  /** Normals used for animations. */\r\n  public readonly normals?: AuxChannel[];\r\n  /** Scalar params used for animations. */\r\n  public readonly params?: AuxParamChannel[];\r\n\r\n  private constructor(props: AuxChannelTableProps, displacements?: AuxDisplacementChannel[], normals?: AuxChannel[], params?: AuxParamChannel[]) {\r\n    this.data = props.data;\r\n    this.width = props.width;\r\n    this.height = props.height;\r\n    this.numVertices = props.count;\r\n    this.numBytesPerVertex = props.numBytesPerVertex;\r\n    this.displacements = displacements;\r\n    this.normals = normals;\r\n    this.params = params;\r\n  }\r\n\r\n  public static fromJSON(props: AuxChannelTableProps): AuxChannelTable | undefined {\r\n    let displacements: AuxDisplacementChannel[] | undefined;\r\n    let normals: AuxChannel[] | undefined;\r\n    let params: AuxParamChannel[] | undefined;\r\n\r\n    if (undefined !== props.displacements && 0 < props.displacements.length) {\r\n      displacements = [];\r\n      for (const displacement of props.displacements)\r\n        displacements.push(new AuxDisplacementChannel(displacement));\r\n    }\r\n\r\n    if (undefined !== props.normals && 0 < props.normals.length) {\r\n      normals = [];\r\n      for (const normal of props.normals)\r\n        normals.push(new AuxChannel(normal));\r\n    }\r\n\r\n    if (undefined !== props.params && 0 < props.params.length) {\r\n      params = [];\r\n      for (const param of props.params)\r\n        params.push(new AuxParamChannel(param));\r\n    }\r\n\r\n    return undefined !== displacements || undefined !== normals || undefined !== params ? new AuxChannelTable(props, displacements, normals, params) : undefined;\r\n  }\r\n\r\n  public toJSON(): AuxChannelTableProps {\r\n    return {\r\n      data: this.data,\r\n      width: this.width,\r\n      height: this.height,\r\n      count: this.numVertices,\r\n      numBytesPerVertex: this.numBytesPerVertex,\r\n      displacements: this.displacements?.map((x) => x.toJSON()),\r\n      normals: this.normals?.map((x) => x.toJSON()),\r\n      params: this.params?.map((x) => x.toJSON()),\r\n    };\r\n  }\r\n\r\n  public static fromChannels(channels: ReadonlyArray<PolyfaceAuxChannel>, numVertices: number, maxDimension: number): AuxChannelTable | undefined {\r\n    return AuxChannelTableBuilder.buildAuxChannelTable(channels, numVertices, maxDimension);\r\n  }\r\n}\r\n\r\nfunction invert(num: number): number {\r\n  if (0 !== num)\r\n    num = 1 / num;\r\n\r\n  return num;\r\n}\r\n\r\nclass AuxChannelTableBuilder {\r\n  private readonly _view: DataView;\r\n  private readonly _props: Mutable<AuxChannelTableProps>;\r\n  private readonly _numBytesPerVertex: number;\r\n\r\n  private constructor(props: Mutable<AuxChannelTableProps>, numBytesPerVertex: number) {\r\n    this._props = props;\r\n    this._numBytesPerVertex = numBytesPerVertex;\r\n    this._view = new DataView(props.data.buffer);\r\n  }\r\n\r\n  public static buildAuxChannelTable(channels: ReadonlyArray<PolyfaceAuxChannel>, numVertices: number, maxDimension: number): AuxChannelTable | undefined {\r\n    const numBytesPerVertex = channels.reduce((accum, channel) => accum + computeNumBytesPerVertex(channel), 0);\r\n    if (!numBytesPerVertex)\r\n      return undefined;\r\n\r\n    const nRgbaPerVertex = Math.floor((numBytesPerVertex + 3) / 4);\r\n    const nUnusedBytesPerVertex = nRgbaPerVertex * 4 - numBytesPerVertex;\r\n    assert(0 === nUnusedBytesPerVertex || 2 === nUnusedBytesPerVertex);\r\n\r\n    // We don't want any unused bytes. If we've got 2 extra, make every other vertex's channel start in the middle of the first texel.\r\n    let dimensions;\r\n    if (0 !== nUnusedBytesPerVertex)\r\n      dimensions = computeDimensions(Math.floor((numVertices + 1) / 2), numBytesPerVertex / 2, 0, maxDimension); // twice as many RGBA for half as many vertices.\r\n    else\r\n      dimensions = computeDimensions(numVertices, nRgbaPerVertex, 0, maxDimension);\r\n\r\n    const data = new Uint8Array(dimensions.width * dimensions.height * 4);\r\n    const props: Mutable<AuxChannelTableProps> = {\r\n      data,\r\n      width: dimensions.width,\r\n      height: dimensions.height,\r\n      count: numVertices,\r\n      numBytesPerVertex,\r\n    };\r\n\r\n    const builder = new AuxChannelTableBuilder(props, numBytesPerVertex);\r\n    builder.build(channels);\r\n    return AuxChannelTable.fromJSON(props);\r\n  }\r\n\r\n  private build(channels: ReadonlyArray<PolyfaceAuxChannel>): void {\r\n    let byteOffset = 0;\r\n    for (const channel of channels) {\r\n      if (AuxChannelDataType.Normal === channel.dataType)\r\n        this.addNormals(channel, byteOffset);\r\n      else if (AuxChannelDataType.Vector === channel.dataType)\r\n        this.addDisplacements(channel, byteOffset);\r\n      else\r\n        this.addParams(channel, byteOffset);\r\n\r\n      byteOffset += computeNumBytesPerVertex(channel);\r\n    }\r\n  }\r\n\r\n  private addNormals(channel: PolyfaceAuxChannel, byteOffset: number): void {\r\n    const inputs = [];\r\n    const indices = [];\r\n\r\n    const normal = new Vector3d();\r\n    for (let i = 0; i < channel.data.length; i++) {\r\n      let byteIndex = byteOffset + i * 2; // 2 bytes per normal\r\n      indices.push(byteIndex / 2); // indices aligned to 2-byte intervals\r\n\r\n      const data = channel.data[i];\r\n      inputs.push(data.input);\r\n\r\n      for (let j = 0; j < data.values.length; j += 3) {\r\n        normal.x = data.values[j];\r\n        normal.y = data.values[j + 1];\r\n        normal.z = data.values[j + 2];\r\n        normal.normalizeInPlace();\r\n\r\n        const encodedNormal = OctEncodedNormal.encode(normal);\r\n        this._view.setUint16(byteIndex, encodedNormal, true);\r\n        byteIndex += this._numBytesPerVertex;\r\n      }\r\n    }\r\n\r\n    const normals = this._props.normals ?? (this._props.normals = []);\r\n    normals.push({\r\n      name: channel.name ?? \"\",\r\n      inputs,\r\n      indices,\r\n    });\r\n  }\r\n\r\n  private addParams(channel: PolyfaceAuxChannel, byteOffset: number): void {\r\n    const inputs = [];\r\n    const indices = [];\r\n\r\n    const range = Range1d.createNull();\r\n    for (const data of channel.data) {\r\n      inputs.push(data.input);\r\n      range.extendArray(data.values);\r\n    }\r\n\r\n    const qScale = Quantization.computeScale(range.high - range.low);\r\n\r\n    for (let i = 0; i < channel.data.length; i++) {\r\n      let byteIndex = byteOffset + i * 2; // 2 bytes per double\r\n      indices.push(byteIndex / 2); // indices aligned to 2-byte intervals\r\n\r\n      for (const value of channel.data[i].values) {\r\n        const quantized = Quantization.quantize(value, range.low, qScale);\r\n        this._view.setUint16(byteIndex, quantized, true);\r\n        byteIndex += this._numBytesPerVertex;\r\n      }\r\n    }\r\n\r\n    const params = this._props.params ?? (this._props.params = []);\r\n    params.push({\r\n      inputs,\r\n      indices,\r\n      name: channel.name ?? \"\",\r\n      qOrigin: [range.low],\r\n      qScale: [invert(qScale)],\r\n    });\r\n  }\r\n\r\n  private addDisplacements(channel: PolyfaceAuxChannel, byteOffset: number): void {\r\n    const inputs = [];\r\n    const indices = [];\r\n\r\n    const point = new Point3d();\r\n    const range = Range3d.createNull();\r\n    for (const data of channel.data) {\r\n      inputs.push(data.input);\r\n      for (let i = 0; i < data.values.length; i += 3) {\r\n        point.set(data.values[i], data.values[i + 1], data.values[i + 2]);\r\n        range.extend(point);\r\n      }\r\n    }\r\n\r\n    const qParams = QParams3d.fromRange(range);\r\n    const qPoint = new QPoint3d();\r\n    for (let i = 0; i < channel.data.length; i++) {\r\n      let byteIndex = byteOffset + i * 6; // 2 bytes per coordinate\r\n      indices.push(byteIndex / 2); // indices aligned to 2-byte intervals\r\n\r\n      const data = channel.data[i];\r\n      for (let j = 0; j < data.values.length; j += 3) {\r\n        point.set(data.values[j], data.values[j + 1], data.values[j + 2]);\r\n        qPoint.init(point, qParams);\r\n\r\n        this._view.setUint16(byteIndex + 0, qPoint.x, true);\r\n        this._view.setUint16(byteIndex + 2, qPoint.y, true);\r\n        this._view.setUint16(byteIndex + 4, qPoint.z, true);\r\n        byteIndex += this._numBytesPerVertex;\r\n      }\r\n    }\r\n\r\n    const displacements = this._props.displacements ?? (this._props.displacements = []);\r\n    displacements.push({\r\n      inputs,\r\n      indices,\r\n      name: channel.name ?? \"\",\r\n      qOrigin: qParams.origin.toArray(),\r\n      qScale: qParams.scale.toArray().map((x) => invert(x)),\r\n    });\r\n  }\r\n}\r\n\r\nfunction computeNumBytesPerVertex(channel: PolyfaceAuxChannel): number {\r\n  const nEntries = channel.data.length;\r\n  switch (channel.dataType) {\r\n    case AuxChannelDataType.Vector:\r\n      return 6 * nEntries; // 3 16-bit quantized coordinate values per entry.\r\n    case AuxChannelDataType.Normal:\r\n    case AuxChannelDataType.Distance:\r\n    case AuxChannelDataType.Scalar:\r\n      return 2 * nEntries; // 1 16-bit quantized value per entry.\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/render/primitives/DisplayParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayParams.d.ts","sourceRoot":"","sources":["../../../../../src/common/render/primitives/DisplayParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAa7I;;GAEG;AACH,qBAAa,aAAa;IACxB,gBAAuB,eAAe,EAAE,MAAM,CAAM;IACpD,SAAgB,IAAI,EAAE,aAAa,CAAC,IAAI,CAA2B;IACnE,SAAgB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAgB,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAiB;IAClD,SAAgB,SAAS,EAAE,QAAQ,CAAC;IACpC,SAAgB,SAAS,EAAE,QAAQ,CAAC;IACpC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,cAAc,EAAE,OAAO,CAAC;gBAErB,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAU,EAAE,UAAU,GAAE,UAA6B,EACjJ,SAAS,GAAE,SAA0B,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAE,OAAe,EAAE,cAAc,CAAC,EAAE,cAAc;IAe9J,sHAAsH;WACxG,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,aAAa,GAAG,SAAS,EAAE,cAAc,UAAQ,GAAG,aAAa;IAmBrL,wGAAwG;WAC1F,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,aAAa,GAAG,SAAS,GAAG,aAAa;IAI5J,0GAA0G;WAC5F,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,aAAa;IAI/D,wGAAwG;WAC1F,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,aAAa;IAI7D,IAAW,cAAc,IAAI,aAAa,CAAC,cAAc,CAYxD;IAED,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IAED,IAAW,eAAe,IAAI,OAAO,CAAyE;IAC9G,IAAW,mBAAmB,IAAI,OAAO,CAA8C;IACvF,IAAW,mBAAmB,IAAI,OAAO,CAA8C;IACvF,IAAW,cAAc,IAAI,cAAc,GAAG,SAAS,CAA8F;IACrJ,IAAW,UAAU,IAAI,OAAO,CAA8C;IAE9E,qHAAqH;IAC9G,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,aAAa,CAAC,cAAoD,GAAG,OAAO;IA+BhH,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM;IAoClD;;;OAGG;WACW,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ;CAG5D;AAED,gBAAgB;AAChB,yBAAiB,aAAa,CAAC;IAC7B,KAAY,IAAI;QACd,IAAI,IAAA;QACJ,MAAM,IAAA;QACN,IAAI,IAAA;KACL;IAED,KAAY,cAAc;QACxB,IAAI,IAAA;QACJ,OAAO,IAAA;QACP,OAAO,IAAA;KACR;IAED,KAAY,cAAc;QACxB,KAAK,IAAA;QACL,MAAM,IAAA;KACP;CACF"}

package/lib/cjs/common/render/primitives/DisplayParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayParams.js","sourceRoot":"","sources":["../../../../../src/common/render/primitives/DisplayParams.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { assert, compareBooleans, compareNumbers, comparePossiblyUndefined, compareStringsOrUndefined } from \"@itwin/core-bentley\";\r\nimport { ColorDef, FillFlags, Gradient, GraphicParams, LinePixels, RenderMaterial, RenderTexture, TextureMapping } from \"@itwin/core-common\";\r\n\r\nfunction compareMaterials(lhs?: RenderMaterial, rhs?: RenderMaterial): number {\r\n  return comparePossiblyUndefined((lhMat: RenderMaterial, rhMat: RenderMaterial) => lhMat === rhMat ? 0 : compareStringsOrUndefined(lhMat.key, rhMat.key), lhs, rhs);\r\n}\r\n\r\nfunction compareTextureMappings(_lhs?: TextureMapping, _rhs?: TextureMapping): number {\r\n  // ###TODO we don't have a way of ordering the textures from the pattern/normal map(s) - not all textures have keys defined.\r\n  // For now this will only work if the GraphicBuilder uses a single material for all geometry.\r\n  // return comparePossiblyUndefined((lhTex: TextureMapping, rhTex: TextureMapping) => lhTex === rhTex ? 0 : compareStringsOrUndefined(lhTex.texture.key, rhTex.texture.key), lhs, rhs);\r\n  return 0;\r\n}\r\n\r\n/** This class is used to determine if things can be batched together for display.\r\n * @internal\r\n */\r\nexport class DisplayParams {\r\n  public static readonly minTransparency: number = 15;  // Threshold below which we consider a color fully opaque\r\n  public readonly type: DisplayParams.Type = DisplayParams.Type.Mesh;\r\n  public readonly material?: RenderMaterial; // meshes only\r\n  public readonly gradient?: Gradient.Symb;\r\n  private readonly _textureMapping?: TextureMapping; // only if material is undefined - e.g. glyphs, gradients\r\n  public readonly lineColor: ColorDef; // all types of geometry (edge color for meshes)\r\n  public readonly fillColor: ColorDef; // meshes only\r\n  public readonly width: number; // linear and mesh (edges)\r\n  public readonly linePixels: LinePixels; // linear and mesh (edges)\r\n  public readonly fillFlags: FillFlags; // meshes only\r\n  public readonly ignoreLighting: boolean; // always true for text and linear geometry; true for meshes only if normals not desired\r\n\r\n  public constructor(type: DisplayParams.Type, lineColor: ColorDef, fillColor: ColorDef, width: number = 0, linePixels: LinePixels = LinePixels.Solid,\r\n    fillFlags: FillFlags = FillFlags.None, material?: RenderMaterial, gradient?: Gradient.Symb, ignoreLighting: boolean = false, textureMapping?: TextureMapping) {\r\n    this.type = type;\r\n    this.material = material;\r\n    this.gradient = gradient;\r\n    this.lineColor = DisplayParams.adjustTransparency(lineColor);\r\n    this.fillColor = DisplayParams.adjustTransparency(fillColor);\r\n    this.width = width;\r\n    this.linePixels = linePixels;\r\n    this.fillFlags = fillFlags;\r\n    this.ignoreLighting = ignoreLighting;\r\n    this._textureMapping = textureMapping;\r\n\r\n    assert(undefined === material || undefined === textureMapping);\r\n  }\r\n\r\n  /** Creates a DisplayParams object for a particular type (mesh, linear, text) based on the specified GraphicParams. */\r\n  public static createForType(type: DisplayParams.Type, gf: GraphicParams, resolveGradient?: (grad: Gradient.Symb) => RenderTexture | undefined, ignoreLighting = false): DisplayParams {\r\n    const lineColor = DisplayParams.adjustTransparency(gf.lineColor);\r\n    switch (type) {\r\n      case DisplayParams.Type.Mesh: {\r\n        let gradientMapping: TextureMapping | undefined;\r\n        if (undefined !== gf.gradient && undefined !== resolveGradient) {\r\n          const gradientTexture = resolveGradient(gf.gradient);\r\n          if (undefined !== gradientTexture)\r\n            gradientMapping = new TextureMapping(gradientTexture, new TextureMapping.Params());\r\n        }\r\n        return new DisplayParams(type, lineColor, DisplayParams.adjustTransparency(gf.fillColor), gf.rasterWidth, gf.linePixels, gf.fillFlags, gf.material, gf.gradient, ignoreLighting, gradientMapping);\r\n      }\r\n      case DisplayParams.Type.Linear:\r\n        return new DisplayParams(type, lineColor, lineColor, gf.rasterWidth, gf.linePixels);\r\n      default: // DisplayParams.Type.Text\r\n        return new DisplayParams(type, lineColor, lineColor, 0, LinePixels.Solid, FillFlags.Always, undefined, undefined, true);\r\n    }\r\n  }\r\n\r\n  /** Creates a DisplayParams object that describes mesh geometry based on the specified GraphicParams. */\r\n  public static createForMesh(gf: GraphicParams, ignoreLighting: boolean, resolveGradient?: (grad: Gradient.Symb) => RenderTexture | undefined): DisplayParams {\r\n    return DisplayParams.createForType(DisplayParams.Type.Mesh, gf, resolveGradient, ignoreLighting);\r\n  }\r\n\r\n  /** Creates a DisplayParams object that describes linear geometry based on the specified GraphicParams. */\r\n  public static createForLinear(gf: GraphicParams): DisplayParams {\r\n    return DisplayParams.createForType(DisplayParams.Type.Linear, gf);\r\n  }\r\n\r\n  /** Creates a DisplayParams object that describes text geometry based on the specified GraphicParams. */\r\n  public static createForText(gf: GraphicParams): DisplayParams {\r\n    return DisplayParams.createForType(DisplayParams.Type.Text, gf);\r\n  }\r\n\r\n  public get regionEdgeType(): DisplayParams.RegionEdgeType {\r\n    if (this.hasBlankingFill)\r\n      return DisplayParams.RegionEdgeType.None;\r\n\r\n    if (this.gradient !== undefined && undefined !== this.gradient.flags) {\r\n      // Even if the gradient is not outlined, produce an outline to be displayed as the region's edges when fill ViewFlag is off.\r\n      const gradFlags: Gradient.Flags = this.gradient.flags;\r\n      if (0 !== (gradFlags & Gradient.Flags.Outline) || FillFlags.None === (this.fillFlags & FillFlags.Always))\r\n        return DisplayParams.RegionEdgeType.Outline;\r\n      return DisplayParams.RegionEdgeType.None;\r\n    }\r\n    return (!this.fillColor.equals(this.lineColor)) ? DisplayParams.RegionEdgeType.Outline : DisplayParams.RegionEdgeType.Default;\r\n  }\r\n\r\n  public get wantRegionOutline(): boolean {\r\n    return DisplayParams.RegionEdgeType.Outline === this.regionEdgeType;\r\n  }\r\n\r\n  public get hasBlankingFill(): boolean { return FillFlags.Blanking === (this.fillFlags & FillFlags.Blanking); }\r\n  public get hasFillTransparency(): boolean { return 255 !== this.fillColor.getAlpha(); }\r\n  public get hasLineTransparency(): boolean { return 255 !== this.lineColor.getAlpha(); }\r\n  public get textureMapping(): TextureMapping | undefined { return undefined !== this.material ? this.material.textureMapping : this._textureMapping; }\r\n  public get isTextured(): boolean { return undefined !== this.textureMapping; }\r\n\r\n  /** Determines if the properties of this DisplayParams object are equal to those of another DisplayParams object.  */\r\n  public equals(rhs: DisplayParams, purpose: DisplayParams.ComparePurpose = DisplayParams.ComparePurpose.Strict): boolean {\r\n    if (DisplayParams.ComparePurpose.Merge === purpose)\r\n      return 0 === this.compareForMerge(rhs);\r\n    else if (rhs === this)\r\n      return true;\r\n\r\n    if (this.type !== rhs.type)\r\n      return false;\r\n    if (this.ignoreLighting !== rhs.ignoreLighting)\r\n      return false;\r\n    if (this.width !== rhs.width)\r\n      return false;\r\n    if (this.linePixels !== rhs.linePixels)\r\n      return false;\r\n    if (this.fillFlags !== rhs.fillFlags)\r\n      return false;\r\n    if (this.wantRegionOutline !== rhs.wantRegionOutline)\r\n      return false;\r\n    if (this.material !== rhs.material)\r\n      return false;\r\n    if (this.textureMapping !== rhs.textureMapping)\r\n      return false;\r\n\r\n    if (!this.fillColor.equals(rhs.fillColor))\r\n      return false;\r\n    if (!this.lineColor.equals(rhs.lineColor))\r\n      return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  public compareForMerge(rhs: DisplayParams): number {\r\n    if (rhs === this)\r\n      return 0;\r\n\r\n    let diff = compareNumbers(this.type, rhs.type);\r\n    if (0 === diff) {\r\n      diff = compareBooleans(this.ignoreLighting, rhs.ignoreLighting);\r\n      if (0 === diff) {\r\n        diff = compareNumbers(this.width, rhs.width);\r\n        if (0 === diff) {\r\n          diff = compareNumbers(this.linePixels, rhs.linePixels);\r\n          if (0 === diff) {\r\n            diff = compareNumbers(this.fillFlags, rhs.fillFlags);\r\n            if (0 === diff) {\r\n              diff = compareBooleans(this.wantRegionOutline, rhs.wantRegionOutline);\r\n              if (0 === diff) {\r\n                diff = compareBooleans(this.hasFillTransparency, rhs.hasFillTransparency);\r\n                if (0 === diff) {\r\n                  diff = compareBooleans(this.hasLineTransparency, rhs.hasLineTransparency);\r\n                  if (0 === diff) {\r\n                    diff = compareMaterials(this.material, rhs.material);\r\n                    if (0 === diff && undefined === this.material && this.isTextured) {\r\n                      diff = compareTextureMappings(this.textureMapping, rhs.textureMapping);\r\n                    }\r\n                  }\r\n                }\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    return diff;\r\n  }\r\n\r\n  /**\r\n   * Given a ColorDef object, check its transparency and if it falls below the minimum, mark the color as fully opaque.\r\n   * @return The original reference to the color provided, which has possibly been modified.\r\n   */\r\n  public static adjustTransparency(color: ColorDef): ColorDef {\r\n    return (color.colors.t < DisplayParams.minTransparency) ? color.withTransparency(0) : color;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport namespace DisplayParams { // eslint-disable-line no-redeclare\r\n  export enum Type {\r\n    Mesh,\r\n    Linear,\r\n    Text,\r\n  }\r\n\r\n  export enum RegionEdgeType {\r\n    None,\r\n    Default,\r\n    Outline,\r\n  }\r\n\r\n  export enum ComparePurpose {\r\n    Merge,  // considers colors equivalent if both have or both lack transparency\r\n    Strict, // compares all members\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/render/primitives/EdgeParams.d.ts

@@ -0,0 +1,94 @@
+/** @packageDocumentation
+ * @module Rendering
+ */
+import { LinePixels } from "@itwin/core-common";
+import { VertexIndices } from "./VertexIndices";
+import { TesselatedPolyline } from "./PolylineParams";
+/**
+ * Describes a set of line segments representing edges of a mesh.
+ * Each segment is expanded into a quad defined by two triangles.
+ * The positions are adjusted in the shader to account for the edge width.
+ * @internal
+ */
+export interface SegmentEdgeParams {
+    /** The 24-bit indices of the tesselated line segment */
+    readonly indices: VertexIndices;
+    /**
+     * For each 24-bit index, 4 bytes:
+     * the 24-bit index of the vertex at the other end of the segment, followed by
+     * an 8-bit 'quad index' in [0..3] indicating which point in the expanded quad the vertex represents.
+     */
+    readonly endPointAndQuadIndices: Uint8Array;
+}
+/**
+ * A set of line segments representing edges of curved portions of a mesh.
+ * Each vertex is augmented with a pair of oct-encoded normals used in the shader
+ * to determine whether or not the edge should be displayed.
+ * @internal
+ */
+export interface SilhouetteParams extends SegmentEdgeParams {
+    /** Per index, 2 16-bit oct-encoded normals */
+    readonly normalPairs: Uint8Array;
+}
+/** A lookup table of edges for a mesh. The table is partitioned such that the lower partition contains simple segment edges
+ * and the upper partition contains silhouette edges. Each entry in the lower partition consists of 2 24-bit indices into
+ * a [[VertexTable]] from which to obtain the endpoints of the edge. Each entry in the upper partition consists of 2 24-bit
+ * vertex indices followed by two 16-bit [[OctEncodedNormal]]s.
+ * If both partitions exist then one row may exist between them containing a mix of segments and silhouettes; in this case a handful
+ * of padding bytes may exist between the last segment and the first silhouette.
+ * @see [[IndexedEdgeParams.edges]].
+ * @internal
+ */
+export interface EdgeTable {
+    /** The rectangular lookup table. */
+    readonly data: Uint8Array;
+    /** Width of the table. */
+    readonly width: number;
+    /** Height of the table. */
+    readonly height: number;
+    /** The number of segments in the lower partition. */
+    readonly numSegments: number;
+    /** The number of padding bytes inserted between the partitions to preserve alignment of data. */
+    readonly silhouettePadding: number;
+}
+/** Describes the edges of a surface as a lookup table. Each edge consists of six identical indices into the lookup table, forming a quad.
+ * @see [[EdgeParams.indexed]].
+ * @internal
+ */
+export interface IndexedEdgeParams {
+    /** The indices into [[edges]]. */
+    readonly indices: VertexIndices;
+    /** The lookup table indexed by [[indices]]. */
+    readonly edges: EdgeTable;
+}
+/** @internal */
+export interface EdgeTableInfo {
+    /** Width of the table. */
+    readonly width: number;
+    /** Height of the table. */
+    readonly height: number;
+    /** The number of segments in the lower partition. */
+    readonly silhouettePadding: number;
+    /** The starting byte index of silhouettes */
+    readonly silhouetteStartByteIndex: number;
+}
+/** Describes the edges of a mesh.
+ * @internal
+ */
+export interface EdgeParams {
+    /** The edge width in pixels. */
+    readonly weight: number;
+    /** The line pattern in which edges are drawn. */
+    readonly linePixels: LinePixels;
+    /** Simple single-segment edges, always displayed when edge display is enabled. */
+    readonly segments?: SegmentEdgeParams;
+    /** Single-segment edges of curved surfaces, displayed based on edge normal relative to eye. */
+    readonly silhouettes?: SilhouetteParams;
+    /** Polyline edges, always displayed when edge display is enabled. */
+    readonly polylines?: TesselatedPolyline;
+    /** Silhouettes and simple-segment edges, compactly represented as indices into a lookup table. */
+    readonly indexed?: IndexedEdgeParams;
+}
+/** @internal */
+export declare function calculateEdgeTableParams(numSegmentEdges: number, numSilhouettes: number, maxSize: number): EdgeTableInfo;
+//# sourceMappingURL=EdgeParams.d.ts.map

package/lib/cjs/common/render/primitives/EdgeParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeParams.d.ts","sourceRoot":"","sources":["../../../../../src/common/render/primitives/EdgeParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,UAAU,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAmCxH"}

package/lib/cjs/common/render/primitives/EdgeParams.js

@@ -0,0 +1,46 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateEdgeTableParams = void 0;
+/** @internal */
+function calculateEdgeTableParams(numSegmentEdges, numSilhouettes, maxSize) {
+    // Each segment edge requires 2 24-bit indices = 6 bytes = 1.5 RGBA values.
+    // Each silhouette requires the same as segment edge plus 2 16-bit oct-encoded normals = 10 bytes = 2.5 RGBA values.
+    let nRgbaRequired = Math.ceil(1.5 * numSegmentEdges + 2.5 * numSilhouettes);
+    const silhouetteStartByteIndex = numSegmentEdges * 6;
+    let silhouettePadding = 0;
+    let width = nRgbaRequired;
+    let height = 1;
+    if (nRgbaRequired >= maxSize) {
+        // Make roughly square to reduce unused space in last row.
+        width = Math.ceil(Math.sqrt(nRgbaRequired));
+        // Each entry's data must fit on the same row. 15 RGBA = 60 bytes = lowest common multiple of 6, 10, and 4.
+        const remainder = width % 15;
+        if (0 !== remainder)
+            width += 15 - remainder;
+        // If the table contains both segments and silhouettes, there may be one row containing a mix of the two where padding
+        // is required between them.
+        if (numSilhouettes > 0 && numSegmentEdges > 0) {
+            const silOffset = silhouetteStartByteIndex % 60; // some multiple of 6.
+            silhouettePadding = (60 - silOffset) % 10;
+            nRgbaRequired += Math.ceil(silhouettePadding / 4);
+        }
+        height = Math.ceil(nRgbaRequired / width);
+        if (width * height < nRgbaRequired)
+            height++;
+    }
+    return {
+        width,
+        height,
+        silhouettePadding,
+        silhouetteStartByteIndex,
+    };
+}
+exports.calculateEdgeTableParams = calculateEdgeTableParams;
+//# sourceMappingURL=EdgeParams.js.map

package/lib/cjs/common/render/primitives/EdgeParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeParams.js","sourceRoot":"","sources":["../../../../../src/common/render/primitives/EdgeParams.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAiGH,gBAAgB;AAChB,SAAgB,wBAAwB,CAAC,eAAuB,EAAE,cAAsB,EAAE,OAAe;IACvG,2EAA2E;IAC3E,oHAAoH;IACpH,IAAI,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,GAAG,GAAG,GAAG,cAAc,CAAC,CAAC;IAC5E,MAAM,wBAAwB,GAAG,eAAe,GAAG,CAAC,CAAC;IACrD,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,GAAG,aAAa,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,aAAa,IAAI,OAAO,EAAE;QAC5B,0DAA0D;QAC1D,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5C,2GAA2G;QAC3G,MAAM,SAAS,GAAG,KAAK,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,SAAS;YACjB,KAAK,IAAI,EAAE,GAAG,SAAS,CAAC;QAE1B,sHAAsH;QACtH,4BAA4B;QAC5B,IAAI,cAAc,GAAG,CAAC,IAAI,eAAe,GAAG,CAAC,EAAE;YAC7C,MAAM,SAAS,GAAG,wBAAwB,GAAG,EAAE,CAAC,CAAC,sBAAsB;YACvE,iBAAiB,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC1C,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;SACnD;QAED,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,MAAM,GAAG,aAAa;YAChC,MAAM,EAAE,CAAC;KACZ;IAED,OAAO;QACL,KAAK;QACL,MAAM;QACN,iBAAiB;QACjB,wBAAwB;KACzB,CAAC;AACJ,CAAC;AAnCD,4DAmCC","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 { LinePixels } from \"@itwin/core-common\";\r\nimport { VertexIndices } from \"./VertexIndices\";\r\nimport { TesselatedPolyline } from \"./PolylineParams\";\r\n\r\n/**\r\n * Describes a set of line segments representing edges of a mesh.\r\n * Each segment is expanded into a quad defined by two triangles.\r\n * The positions are adjusted in the shader to account for the edge width.\r\n * @internal\r\n */\r\nexport interface SegmentEdgeParams {\r\n  /** The 24-bit indices of the tesselated line segment */\r\n  readonly indices: VertexIndices;\r\n  /**\r\n   * For each 24-bit index, 4 bytes:\r\n   * the 24-bit index of the vertex at the other end of the segment, followed by\r\n   * an 8-bit 'quad index' in [0..3] indicating which point in the expanded quad the vertex represents.\r\n   */\r\n  readonly endPointAndQuadIndices: Uint8Array;\r\n}\r\n\r\n/**\r\n * A set of line segments representing edges of curved portions of a mesh.\r\n * Each vertex is augmented with a pair of oct-encoded normals used in the shader\r\n * to determine whether or not the edge should be displayed.\r\n * @internal\r\n */\r\nexport interface SilhouetteParams extends SegmentEdgeParams {\r\n  /** Per index, 2 16-bit oct-encoded normals */\r\n  readonly normalPairs: Uint8Array;\r\n}\r\n\r\n/** A lookup table of edges for a mesh. The table is partitioned such that the lower partition contains simple segment edges\r\n * and the upper partition contains silhouette edges. Each entry in the lower partition consists of 2 24-bit indices into\r\n * a [[VertexTable]] from which to obtain the endpoints of the edge. Each entry in the upper partition consists of 2 24-bit\r\n * vertex indices followed by two 16-bit [[OctEncodedNormal]]s.\r\n * If both partitions exist then one row may exist between them containing a mix of segments and silhouettes; in this case a handful\r\n * of padding bytes may exist between the last segment and the first silhouette.\r\n * @see [[IndexedEdgeParams.edges]].\r\n * @internal\r\n */\r\nexport interface EdgeTable {\r\n  /** The rectangular lookup table. */\r\n  readonly data: Uint8Array;\r\n  /** Width of the table. */\r\n  readonly width: number;\r\n  /** Height of the table. */\r\n  readonly height: number;\r\n  /** The number of segments in the lower partition. */\r\n  readonly numSegments: number;\r\n  /** The number of padding bytes inserted between the partitions to preserve alignment of data. */\r\n  readonly silhouettePadding: number;\r\n}\r\n\r\n/** Describes the edges of a surface as a lookup table. Each edge consists of six identical indices into the lookup table, forming a quad.\r\n * @see [[EdgeParams.indexed]].\r\n * @internal\r\n */\r\nexport interface IndexedEdgeParams {\r\n  /** The indices into [[edges]]. */\r\n  readonly indices: VertexIndices;\r\n  /** The lookup table indexed by [[indices]]. */\r\n  readonly edges: EdgeTable;\r\n}\r\n\r\n/** @internal */\r\nexport interface EdgeTableInfo {\r\n  /** Width of the table. */\r\n  readonly width: number;\r\n  /** Height of the table. */\r\n  readonly height: number;\r\n  /** The number of segments in the lower partition. */\r\n  readonly silhouettePadding: number;\r\n  /** The starting byte index of silhouettes */\r\n  readonly silhouetteStartByteIndex: number;\r\n}\r\n\r\n/** Describes the edges of a mesh.\r\n * @internal\r\n */\r\nexport interface EdgeParams {\r\n  /** The edge width in pixels. */\r\n  readonly weight: number;\r\n  /** The line pattern in which edges are drawn. */\r\n  readonly linePixels: LinePixels;\r\n  /** Simple single-segment edges, always displayed when edge display is enabled. */\r\n  readonly segments?: SegmentEdgeParams;\r\n  /** Single-segment edges of curved surfaces, displayed based on edge normal relative to eye. */\r\n  readonly silhouettes?: SilhouetteParams;\r\n  /** Polyline edges, always displayed when edge display is enabled. */\r\n  readonly polylines?: TesselatedPolyline;\r\n  /** Silhouettes and simple-segment edges, compactly represented as indices into a lookup table. */\r\n  readonly indexed?: IndexedEdgeParams;\r\n}\r\n\r\n/** @internal */\r\nexport function calculateEdgeTableParams(numSegmentEdges: number, numSilhouettes: number, maxSize: number): EdgeTableInfo {\r\n  // Each segment edge requires 2 24-bit indices = 6 bytes = 1.5 RGBA values.\r\n  // Each silhouette requires the same as segment edge plus 2 16-bit oct-encoded normals = 10 bytes = 2.5 RGBA values.\r\n  let nRgbaRequired = Math.ceil(1.5 * numSegmentEdges + 2.5 * numSilhouettes);\r\n  const silhouetteStartByteIndex = numSegmentEdges * 6;\r\n  let silhouettePadding = 0;\r\n  let width = nRgbaRequired;\r\n  let height = 1;\r\n  if (nRgbaRequired >= maxSize) {\r\n    // Make roughly square to reduce unused space in last row.\r\n    width = Math.ceil(Math.sqrt(nRgbaRequired));\r\n    // Each entry's data must fit on the same row. 15 RGBA = 60 bytes = lowest common multiple of 6, 10, and 4.\r\n    const remainder = width % 15;\r\n    if (0 !== remainder)\r\n      width += 15 - remainder;\r\n\r\n    // If the table contains both segments and silhouettes, there may be one row containing a mix of the two where padding\r\n    // is required between them.\r\n    if (numSilhouettes > 0 && numSegmentEdges > 0) {\r\n      const silOffset = silhouetteStartByteIndex % 60; // some multiple of 6.\r\n      silhouettePadding = (60 - silOffset) % 10;\r\n      nRgbaRequired += Math.ceil(silhouettePadding / 4);\r\n    }\r\n\r\n    height = Math.ceil(nRgbaRequired / width);\r\n    if (width * height < nRgbaRequired)\r\n      height++;\r\n  }\r\n\r\n  return {\r\n    width,\r\n    height,\r\n    silhouettePadding,\r\n    silhouetteStartByteIndex,\r\n  };\r\n}\r\n"]}

package/lib/cjs/common/render/primitives/MeshParams.d.ts

@@ -0,0 +1,20 @@
+/** @packageDocumentation
+ * @module Rendering
+ */
+import { AuxChannelTable } from "./AuxChannelTable";
+import { VertexTable } from "./VertexTable";
+import { SurfaceParams } from "./SurfaceParams";
+import { EdgeParams } from "./EdgeParams";
+/** Describes mesh geometry to be submitted to the rendering system.
+ * A mesh consists of a surface and its edges, which may include any combination of silhouettes, polylines, and single segments.
+ * The surface and edges all refer to the same vertex table.
+ * @internal
+ */
+export interface MeshParams {
+    vertices: VertexTable;
+    surface: SurfaceParams;
+    edges?: EdgeParams;
+    isPlanar: boolean;
+    auxChannels?: AuxChannelTable;
+}
+//# sourceMappingURL=MeshParams.d.ts.map

package/lib/cjs/common/render/primitives/MeshParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshParams.d.ts","sourceRoot":"","sources":["../../../../../src/common/render/primitives/MeshParams.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B"}