@itwin/core-geometry 4.5.0-dev.8 → 4.6.0-dev.0

package/lib/esm/geometry3d/XYZProps.d.ts

@@ -73,11 +73,25 @@ export declare namespace XYAndZ {
  * @public
  */
 export type LowAndHighXY = Readonly<WritableLowAndHighXY>;
+/** JSON representation of [[LowAndHighXY]].
+ * @public
+ */
+export interface LowAndHighXYProps {
+    low: XYProps;
+    high: XYProps;
+}
 /**
  * Interface for type with readable `low` and `high` members which have `x`, `y`, and `z` number members.
  * @public
  */
 export type LowAndHighXYZ = Readonly<WritableLowAndHighXYZ>;
+/** JSON representation of [[LowAndHighXYZ]].
+ * @public
+ */
+export interface LowAndHighXYZProps {
+    low: XYZProps;
+    high: XYZProps;
+}
 /**
  * Interface for variant json (one of)
  * * (individually optional) `x`, `y`, `z`
@@ -124,20 +138,14 @@ export type TransformProps = number[][] | number[] | {
  * * array of `XYZProps`
  * @public
  */
-export type Range3dProps = {
-    low: XYZProps;
-    high: XYZProps;
-} | XYZProps[];
+export type Range3dProps = LowAndHighXYZProps | XYZProps[];
 /**
  *  Interface for variant json representing a Range2d
  * * pair of `XYProps` named `low` and `high`
  * * array of `XYProps`
  * @public
  */
-export type Range2dProps = {
-    low: XYProps;
-    high: XYProps;
-} | XYProps[];
+export type Range2dProps = LowAndHighXYProps | XYProps[];
 /**
  *  Interface for variant json representing a Range1d
  * * pair of `number` named `low` and `high`

package/lib/esm/geometry3d/XYZProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XYZProps.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/XYZProps.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;CACX;AACD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;CACX;AACD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa,EAAE,aAAa;CACnE;AACD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,GAAG,EAAE,aAAa,CAAC;IACnB,6BAA6B;IAC7B,IAAI,EAAE,aAAa,CAAC;CACrB;AACD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,cAAc,CAAC;CACtB;AACD;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC3C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC5C;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE9C,cAAc;AACd,yBAAiB,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,SAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAIvE;CACF;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC1D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAC5D;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,EAAE,CAAC;AACb;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,EAAE,CAAC;AACb;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;AAClD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG;IACnD,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,QAAQ,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,GAAG,QAAQ,EAAE,CAAC;AACf;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,EAAE,CAAC;AACd;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,EAAE,CAAC"}
+{"version":3,"file":"XYZProps.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/XYZProps.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;CACX;AACD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;CACX;AACD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa,EAAE,aAAa;CACnE;AACD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,GAAG,EAAE,aAAa,CAAC;IACnB,6BAA6B;IAC7B,IAAI,EAAE,aAAa,CAAC;CACrB;AACD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,cAAc,CAAC;CACtB;AACD;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC3C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC5C;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAE9C,cAAc;AACd,yBAAiB,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,SAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAIvE;CACF;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE;AAElE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAAG,GAAG,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE;AAErE;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,EAAE,CAAC;AACb;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,EAAE,CAAC;AACb;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;AAClD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG;IACnD,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,QAAQ,EAAE,CAAC;AAC3D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,OAAO,EAAE,CAAC;AACzD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,EAAE,CAAC"}

package/lib/esm/geometry3d/XYZProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"XYZProps.js","sourceRoot":"","sources":["../../../src/geometry3d/XYZProps.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8DvC,cAAc;AACd,MAAM,KAAW,MAAM,CAatB;AAbD,WAAiB,MAAM;IACrB;;;;;;OAMG;IACH,SAAgB,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,GAAY;QAC5D,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;eAC1C,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;eACxC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAJe,kBAAW,cAI1B,CAAA;AACH,CAAC,EAbgB,MAAM,KAAN,MAAM,QAatB","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\n\nimport { Geometry } from \"../Geometry\";\n\n/**\n * Interface for class with `x` and `y` as number properties.\n * @public\n */\nexport interface WritableXAndY {\n  /** x coordinate */\n  x: number;\n  /** y coordinate */\n  y: number;\n}\n/**\n * Interface for class with `z` as number property.\n * @public\n */\nexport interface WriteableHasZ {\n  /** z coordinate */\n  z: number;\n}\n/**\n * Interface for class with `x`, `y`, `z` as number property.\n * @public\n */\nexport interface WritableXYAndZ extends WritableXAndY, WriteableHasZ {\n}\n/**\n * Interface for class with named properties `low` and `high`, both being `WriteableXAndY`\n * @public\n */\nexport interface WritableLowAndHighXY {\n  /** Low x,y coordinates */\n  low: WritableXAndY;\n  /** High x,y,z coordinates */\n  high: WritableXAndY;\n}\n/**\n * Interface for class with named properties `low` and `high`, both being `WriteableXYAndZ`\n * @public\n */\nexport interface WritableLowAndHighXYZ {\n  /** Low x,y,z coordinates */\n  low: WritableXYAndZ;\n  /** High x,y,z coordinates */\n  high: WritableXYAndZ;\n}\n/**\n * Interface for readable `z` number members.\n * @public\n */\nexport type HasZ = Readonly<WriteableHasZ>;\n/**\n * Interface for readable `x` and `y` number members.\n * @public\n */\nexport type XAndY = Readonly<WritableXAndY>;\n/**\n * Interface for type with readable `x`, `y`, `z` number members.\n * @public\n */\nexport type XYAndZ = Readonly<WritableXYAndZ>;\n\n/** @public */\nexport namespace XYAndZ { // eslint-disable-line @typescript-eslint/no-redeclare\n  /**\n   * Return true if two XYAndZs have equal x,y,z parts within a specified tolerance.\n   * @param a The first XYAndZ to compare\n   * @param b The second XYAndZ to compare\n   * @param The tolerance for comparison. If undefined, [[Geometry.smallMetricDistance]] is used.\n   * @returns true if the difference in each coordinate of `a` and `b` is smaller than `tol`.\n   */\n  export function almostEqual(a: XYAndZ, b: XYAndZ, tol?: number): boolean {\n    return Geometry.isSameCoordinate(a.x, b.x, tol)\n      && Geometry.isSameCoordinate(a.y, b.y, tol)\n      && Geometry.isSameCoordinate(a.z, b.z, tol);\n  }\n}\n\n/**\n * Interface for type with readable `low` and `high` members which have `x` and `y` number members.\n * @public\n */\nexport type LowAndHighXY = Readonly<WritableLowAndHighXY>;\n/**\n * Interface for type with readable `low` and `high` members which have `x`, `y`, and `z` number members.\n * @public\n */\nexport type LowAndHighXYZ = Readonly<WritableLowAndHighXYZ>;\n/**\n * Interface for variant json (one of)\n * * (individually optional) `x`, `y`, `z`\n * * number array\n * @public\n */\nexport type XYZProps = {\n  x?: number;\n  y?: number;\n  z?: number;\n} | number[];\n/**\n * Interface for variant json (one of)\n * * (individually optional) `x`, `y`\n * * number array\n * @public\n */\nexport type XYProps = {\n  x?: number;\n  y?: number;\n} | number[];\n/**\n * Interface for variant json (one of)\n * * array of number arrays, with one matrix row in each array\n * * flat array of numbers, in row-mor order\n * * `Matrix3d` object\n * @public\n */\nexport type Matrix3dProps = number[][] | number[];\n/**\n * Interface for variant json (one of)\n * * array of number arrays, with each low level array containing 4 numbers of a transform row (qx, qy, qz, ax)\n * * flat array of 12 numbers, in row-major order for the 3 rows of 4 values\n * * `Transform` object\n * @public\n */\nexport type TransformProps = number[][] | number[] | {\n  origin: XYZProps;\n  matrix: Matrix3dProps;\n};\n/**\n *  Interface for variant json representing a Range3d\n * * pair of `XYZProps` named `low` and `high`\n * * array of `XYZProps`\n * @public\n */\nexport type Range3dProps = {\n  low: XYZProps;\n  high: XYZProps;\n} | XYZProps[];\n/**\n *  Interface for variant json representing a Range2d\n * * pair of `XYProps` named `low` and `high`\n * * array of `XYProps`\n * @public\n */\nexport type Range2dProps = {\n  low: XYProps;\n  high: XYProps;\n} | XYProps[];\n/**\n *  Interface for variant json representing a Range1d\n * * pair of `number` named `low` and `high`\n * * array of `number`\n * @public\n */\nexport type Range1dProps = {\n  low: number;\n  high: number;\n} | number[];\n"]}
+{"version":3,"file":"XYZProps.js","sourceRoot":"","sources":["../../../src/geometry3d/XYZProps.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8DvC,cAAc;AACd,MAAM,KAAW,MAAM,CAatB;AAbD,WAAiB,MAAM;IACrB;;;;;;OAMG;IACH,SAAgB,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,GAAY;QAC5D,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;eAC1C,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;eACxC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAJe,kBAAW,cAI1B,CAAA;AACH,CAAC,EAbgB,MAAM,KAAN,MAAM,QAatB","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\n\nimport { Geometry } from \"../Geometry\";\n\n/**\n * Interface for class with `x` and `y` as number properties.\n * @public\n */\nexport interface WritableXAndY {\n  /** x coordinate */\n  x: number;\n  /** y coordinate */\n  y: number;\n}\n/**\n * Interface for class with `z` as number property.\n * @public\n */\nexport interface WriteableHasZ {\n  /** z coordinate */\n  z: number;\n}\n/**\n * Interface for class with `x`, `y`, `z` as number property.\n * @public\n */\nexport interface WritableXYAndZ extends WritableXAndY, WriteableHasZ {\n}\n/**\n * Interface for class with named properties `low` and `high`, both being `WriteableXAndY`\n * @public\n */\nexport interface WritableLowAndHighXY {\n  /** Low x,y coordinates */\n  low: WritableXAndY;\n  /** High x,y,z coordinates */\n  high: WritableXAndY;\n}\n/**\n * Interface for class with named properties `low` and `high`, both being `WriteableXYAndZ`\n * @public\n */\nexport interface WritableLowAndHighXYZ {\n  /** Low x,y,z coordinates */\n  low: WritableXYAndZ;\n  /** High x,y,z coordinates */\n  high: WritableXYAndZ;\n}\n/**\n * Interface for readable `z` number members.\n * @public\n */\nexport type HasZ = Readonly<WriteableHasZ>;\n/**\n * Interface for readable `x` and `y` number members.\n * @public\n */\nexport type XAndY = Readonly<WritableXAndY>;\n/**\n * Interface for type with readable `x`, `y`, `z` number members.\n * @public\n */\nexport type XYAndZ = Readonly<WritableXYAndZ>;\n\n/** @public */\nexport namespace XYAndZ { // eslint-disable-line @typescript-eslint/no-redeclare\n  /**\n   * Return true if two XYAndZs have equal x,y,z parts within a specified tolerance.\n   * @param a The first XYAndZ to compare\n   * @param b The second XYAndZ to compare\n   * @param The tolerance for comparison. If undefined, [[Geometry.smallMetricDistance]] is used.\n   * @returns true if the difference in each coordinate of `a` and `b` is smaller than `tol`.\n   */\n  export function almostEqual(a: XYAndZ, b: XYAndZ, tol?: number): boolean {\n    return Geometry.isSameCoordinate(a.x, b.x, tol)\n      && Geometry.isSameCoordinate(a.y, b.y, tol)\n      && Geometry.isSameCoordinate(a.z, b.z, tol);\n  }\n}\n\n/**\n * Interface for type with readable `low` and `high` members which have `x` and `y` number members.\n * @public\n */\nexport type LowAndHighXY = Readonly<WritableLowAndHighXY>;\n\n/** JSON representation of [[LowAndHighXY]].\n * @public\n */\nexport interface LowAndHighXYProps { low: XYProps, high: XYProps }\n\n/**\n * Interface for type with readable `low` and `high` members which have `x`, `y`, and `z` number members.\n * @public\n */\nexport type LowAndHighXYZ = Readonly<WritableLowAndHighXYZ>;\n\n/** JSON representation of [[LowAndHighXYZ]].\n * @public\n */\nexport interface LowAndHighXYZProps { low: XYZProps, high: XYZProps }\n\n/**\n * Interface for variant json (one of)\n * * (individually optional) `x`, `y`, `z`\n * * number array\n * @public\n */\nexport type XYZProps = {\n  x?: number;\n  y?: number;\n  z?: number;\n} | number[];\n/**\n * Interface for variant json (one of)\n * * (individually optional) `x`, `y`\n * * number array\n * @public\n */\nexport type XYProps = {\n  x?: number;\n  y?: number;\n} | number[];\n/**\n * Interface for variant json (one of)\n * * array of number arrays, with one matrix row in each array\n * * flat array of numbers, in row-mor order\n * * `Matrix3d` object\n * @public\n */\nexport type Matrix3dProps = number[][] | number[];\n/**\n * Interface for variant json (one of)\n * * array of number arrays, with each low level array containing 4 numbers of a transform row (qx, qy, qz, ax)\n * * flat array of 12 numbers, in row-major order for the 3 rows of 4 values\n * * `Transform` object\n * @public\n */\nexport type TransformProps = number[][] | number[] | {\n  origin: XYZProps;\n  matrix: Matrix3dProps;\n};\n/**\n *  Interface for variant json representing a Range3d\n * * pair of `XYZProps` named `low` and `high`\n * * array of `XYZProps`\n * @public\n */\nexport type Range3dProps = LowAndHighXYZProps | XYZProps[];\n/**\n *  Interface for variant json representing a Range2d\n * * pair of `XYProps` named `low` and `high`\n * * array of `XYProps`\n * @public\n */\nexport type Range2dProps = LowAndHighXYProps | XYProps[];\n/**\n *  Interface for variant json representing a Range1d\n * * pair of `number` named `low` and `high`\n * * array of `number`\n * @public\n */\nexport type Range1dProps = {\n  low: number;\n  high: number;\n} | number[];\n"]}

package/lib/esm/polyface/IndexedPolyfaceVisitor.d.ts

@@ -3,7 +3,7 @@ import { IndexedPolyface, Polyface, PolyfaceVisitor } from "./Polyface";
 import { PolyfaceData } from "./PolyfaceData";
 /**
  * An `IndexedPolyfaceVisitor` is an iterator-like object that "visits" facets of a mesh.
- * * The visitor extends a `PolyfaceData ` class, so it can at any time hold all the data of a single facet.
+ * * The visitor extends `PolyfaceData`, so it can at any time hold all the data of a single facet.
  * @public
  */
 export declare class IndexedPolyfaceVisitor extends PolyfaceData implements PolyfaceVisitor {
@@ -12,95 +12,87 @@ export declare class IndexedPolyfaceVisitor extends PolyfaceData implements Poly
     private _numWrap;
     private _numEdges;
     private _polyface;
-    protected constructor(facets: IndexedPolyface, numWrap: number);
+    protected constructor(polyface: IndexedPolyface, numWrap: number);
     /** Return the client polyface object. */
     clientPolyface(): Polyface;
-    /** Set the number of vertices duplicated (e.g. 1 for start and end) in arrays in the visitor. */
+    /**
+     * Set the number of vertices replicated in visitor arrays (both data and index arrays).
+     * * 0,1,2 are the most common as numWrap.
+     * * Example: suppose `[6,7,8]` is the pointIndex array representing a triangle. First edge would be `6,7`. Second
+     * edge is `7,8`. Third edge is `8,6`. To access `6` for the third edge, we have to go back to the start of array.
+     * Therefore, it is useful to store `6` at the end of pointIndex array, i.e., `[6,7,8,6]` meaning `numWrap = 1`.
+     * * `numWrap = 2` is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
+     */
     setNumWrap(numWrap: number): void;
-    /** Return the number of edges in the current facet.
-     * * Note that if this visitor has `numWrap` greater than zero, the number of edges is smaller than the number of points.
+    /**
+     * Return the number of edges in the current facet.
+     * * If `numWrap > 0` for this visitor, the number of edges is smaller than the number of points.
      */
     get numEdgesThisFacet(): number;
-    /** Create a visitor for iterating the facets of `polyface`, with indicated number of points to be added to each facet to produce closed point arrays
-     * Typical wrap counts are:
-     * * 0 -- leave the point arrays with "missing final edge"
-     * * 1 -- add point 0 as closure point
-     * * 2 -- add points 0 and 1 as closure and wrap point.  This is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
-     */
+    /** Create a visitor for iterating the facets of `polyface`. */
     static create(polyface: IndexedPolyface, numWrap: number): IndexedPolyfaceVisitor;
-    /** Advance the iterator to a particular facet in the client polyface */
+    /** Advance the iterator to a particular facet in the client polyface. */
     moveToReadIndex(facetIndex: number): boolean;
-    /** Advance the iterator to a the 'next' facet in the client polyface */
+    /** Advance the iterator to a the 'next' facet in the client polyface. */
     moveToNextFacet(): boolean;
     /** Reset the iterator to start at the first facet of the polyface. */
     reset(): void;
     /**
-     * Attempts to extract the distance parameter for the given vertex index on the current facet
-     * Returns the distance parameter as a point. Returns undefined on failure.
+     * Attempts to extract the distance parameter for the given vertex `index` on the current facet.
+     * Returns the distance parameter as a point. Returns `undefined` on failure.
      */
     tryGetDistanceParameter(index: number, result?: Point2d): Point2d | undefined;
     /**
-     * Attempts to extract the normalized parameter (0,1) for the given vertex index on the current facet.
-     * Returns the normalized parameter as a point. Returns undefined on failure.
+     * Attempts to extract the normalized parameter (0,1) for the given vertex `index` on the current facet.
+     * Returns the normalized parameter as a point. Returns `undefined` on failure.
      */
     tryGetNormalizedParameter(index: number, result?: Point2d): Point2d | undefined;
-    /** Return the index (in the client polyface) of the current facet */
+    /** Return the index (in the client polyface) of the current facet. */
     currentReadIndex(): number;
-    /** Return the point index of vertex i within the currently loaded facet */
+    /** Return the point index of vertex `i` within the currently loaded facet. */
     clientPointIndex(i: number): number;
-    /** Return the param index of vertex i within the currently loaded facet */
+    /** Return the param index of vertex `i` within the currently loaded facet. */
     clientParamIndex(i: number): number;
-    /** Return the normal index of vertex i within the currently loaded facet */
+    /** Return the normal index of vertex `i` within the currently loaded facet. */
     clientNormalIndex(i: number): number;
-    /** Return the color index of vertex i within the currently loaded facet */
+    /** Return the color index of vertex `i` within the currently loaded facet. */
     clientColorIndex(i: number): number;
-    /** Return the aux data index of vertex i within the currently loaded facet */
+    /** Return the aux data index of vertex `i` within the currently loaded facet. */
     clientAuxIndex(i: number): number;
-    /** clear the contents of all arrays.  Use this along with transferDataFrom methods to build up new facets */
+    /** Clear the contents of all arrays. */
     clearArrays(): void;
-    /** transfer data from a specified index of the other visitor as new data in this visitor. */
+    /** Transfer data from a specified `index` of the `other` visitor as new data in this visitor. */
     pushDataFrom(other: PolyfaceVisitor, index: number): void;
-    /** transfer interpolated data from the other visitor.
-     * * all data values are interpolated at `fraction` between `other` values at index0 and index1.
+    /**
+     * Transfer interpolated data from the other visitor.
+     * * All data values are interpolated at `fraction` between `other` values at `index0` and `index1`.
      */
     pushInterpolatedDataFrom(other: PolyfaceVisitor, index0: number, fraction: number, index1: number): void;
 }
 /**
- * Interpolate each byte of color0 and color1 as integers.
- * @param color0 32 bit color (e.g. rgb+transparency)
- * @param fraction fractional position.  This is clamped to 0..1 to prevent byte values outside their 0..255 range.
- * @param color1
- * @param shiftBits
- * @internal
- */
-export declare function interpolateColor(color0: number, fraction: number, color1: number): number;
-/**
- * An `IndexedPolyfaceSubsetVisitor` is an IndexedPolyfaceVisitor which only visits a subset of facets in the polyface.
+ * An `IndexedPolyfaceSubsetVisitor` is an `IndexedPolyfaceVisitor` which only visits a subset of facets in the polyface.
  * * The subset is defined by an array of facet indices provided when this visitor is created.
- * * Within the subset visitor, "facetIndex" is understood as index within the subset array:
- *   * moveToNextFacet moves only within the subset
- *   * moveToReadIndex(i) moves underlying visitor's parentFacetIndex(i)
+ * * Within the subset visitor, `facetIndex` is understood as index within the subset array:
+ *   * `moveToNextFacet` moves only within the subset.
+ *   * `moveToReadIndex(i)` moves underlying visitor's `parentFacetIndex(i)`.
  * @public
  */
 export declare class IndexedPolyfaceSubsetVisitor extends IndexedPolyfaceVisitor {
     private _parentFacetIndices;
     private _nextActiveIndex;
     private constructor();
-    /** Create a visitor for iterating a subset of the facets of `polyface`, with indicated number of points to be added to each facet to produce closed point arrays
-     * * Typical wrap counts are:
-     *   * 0 -- leave the point arrays with "missing final edge"
-     *   * 1 -- add point 0 as closure point
-     *   * 2 -- add points 0 and 1 as closure and wrap point.  This is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
-     * * The activeFacetIndices array indicates all facets to be visited.
+    /**
+     * Create a visitor for iterating a subset of the facets of `polyface`.
+     * * The `activeFacetIndices` array indicates all facets to be visited.
      */
     static createSubsetVisitor(polyface: IndexedPolyface, activeFacetIndices: number[], numWrap: number): IndexedPolyfaceSubsetVisitor;
-    /** Advance the iterator to a particular facet in the client polyface */
+    /** Advance the iterator to a particular facet in the client polyface. */
     moveToReadIndex(activeIndex: number): boolean;
-    /** Advance the iterator to a the 'next' facet in the client polyface */
+    /** Advance the iterator to the next facet in the client polyface. */
     moveToNextFacet(): boolean;
-    /** Reset the iterator to start at the first facet of the polyface. */
+    /** Reset the iterator to start at the first active facet in the polyface. */
     reset(): void;
-    /** return the parent facet index of the indicated index within the active facets */
+    /** Return the parent facet index of the indicated index within the active facets. */
     parentFacetIndex(activeIndex: number): number | undefined;
 }
 //# sourceMappingURL=IndexedPolyfaceVisitor.d.ts.map

package/lib/esm/polyface/IndexedPolyfaceVisitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedPolyfaceVisitor.d.ts","sourceRoot":"","sources":["../../../src/polyface/IndexedPolyfaceVisitor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,eAAe;IACjF,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS,aAAa,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;IAa9D,yCAAyC;IAClC,cAAc,IAAI,QAAQ;IACjC,iGAAiG;IAC1F,UAAU,CAAC,OAAO,EAAE,MAAM;IAEjC;;OAEG;IACH,IAAW,iBAAiB,IAAI,MAAM,CAA2B;IACjE;;;;;OAKG;WACW,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB;IAGxF,wEAAwE;IACjE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAUnD,wEAAwE;IACjE,eAAe,IAAI,OAAO;IAOjC,sEAAsE;IAC/D,KAAK,IAAI,IAAI;IAKpB;;;OAGG;IACI,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAapF;;;OAGG;IACI,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAYtF,qEAAqE;IAC9D,gBAAgB,IAAI,MAAM;IACjC,2EAA2E;IACpE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAC1C,2EAA2E;IACpE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAC1C,4EAA4E;IACrE,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAC3C,2EAA2E;IACpE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAC1C,8EAA8E;IACvE,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAExC,6GAA6G;IACtG,WAAW,IAAI,IAAI;IAU1B,6FAA6F;IACtF,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAShE;;OAEG;IACI,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAShH;AAoBD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAgBhF;AAED;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB;IACtE,OAAO,CAAC,mBAAmB,CAAW;IAEtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO;IAKP;;;;;;OAMG;WACW,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,4BAA4B;IAGzI,wEAAwE;IACxD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAO7D,wEAAwE;IACxD,eAAe,IAAI,OAAO;IAU1C,sEAAsE;IACtD,KAAK,IAAI,IAAI;IAG7B,oFAAoF;IAC7E,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAMjE"}
+{"version":3,"file":"IndexedPolyfaceVisitor.d.ts","sourceRoot":"","sources":["../../../src/polyface/IndexedPolyfaceVisitor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,YAAa,YAAW,eAAe;IACjF,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS,aAAa,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;IAYhE,yCAAyC;IAClC,cAAc,IAAI,QAAQ;IAGjC;;;;;;;OAOG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM;IAGjC;;;OAGG;IACH,IAAW,iBAAiB,IAAI,MAAM,CAErC;IACD,+DAA+D;WACjD,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB;IAGxF,yEAAyE;IAClE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAenD,yEAAyE;IAClE,eAAe,IAAI,OAAO;IAMjC,sEAAsE;IAC/D,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAcpF;;;OAGG;IACI,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IActF,sEAAsE;IAC/D,gBAAgB,IAAI,MAAM;IAGjC,8EAA8E;IACvE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG1C,8EAA8E;IACvE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG1C,+EAA+E;IACxE,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG3C,8EAA8E;IACvE,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG1C,iFAAiF;IAC1E,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAGxC,wCAAwC;IACjC,WAAW,IAAI,IAAI;IAU1B,iGAAiG;IAC1F,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAShE;;;OAGG;IACI,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAShH;AACD;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB;IACtE,OAAO,CAAC,mBAAmB,CAAW;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO;IAKP;;;OAGG;WACW,mBAAmB,CAC/B,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GACvE,4BAA4B;IAG/B,yEAAyE;IACzD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAO7D,qEAAqE;IACrD,eAAe,IAAI,OAAO;IAU1C,6EAA6E;IAC7D,KAAK,IAAI,IAAI;IAG7B,qFAAqF;IAC9E,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAMjE"}

package/lib/esm/polyface/IndexedPolyfaceVisitor.js

@@ -10,51 +10,60 @@ import { PolyfaceData } from "./PolyfaceData";
 /* eslint-disable @itwin/prefer-get */
 /**
  * An `IndexedPolyfaceVisitor` is an iterator-like object that "visits" facets of a mesh.
- * * The visitor extends a `PolyfaceData ` class, so it can at any time hold all the data of a single facet.
+ * * The visitor extends `PolyfaceData`, so it can at any time hold all the data of a single facet.
  * @public
  */
 export class IndexedPolyfaceVisitor extends PolyfaceData {
-    // to be called from static factory method that validates the polyface ...
-    constructor(facets, numWrap) {
-        super(facets.data.normalCount > 0, facets.data.paramCount > 0, facets.data.colorCount > 0, facets.twoSided);
-        this._polyface = facets;
+    // to be called from static factory method that validates the polyface
+    constructor(polyface, numWrap) {
+        super(polyface.data.normalCount > 0, polyface.data.paramCount > 0, polyface.data.colorCount > 0, polyface.twoSided);
+        this._polyface = polyface;
         this._numWrap = numWrap;
-        if (facets.data.auxData)
-            this.auxData = facets.data.auxData.createForVisitor();
+        if (polyface.data.auxData)
+            this.auxData = polyface.data.auxData.createForVisitor();
         this.reset();
         this._numEdges = 0;
         this._nextFacetIndex = 0;
         this._currentFacetIndex = -1;
     }
     /** Return the client polyface object. */
-    clientPolyface() { return this._polyface; }
-    /** Set the number of vertices duplicated (e.g. 1 for start and end) in arrays in the visitor. */
-    setNumWrap(numWrap) { this._numWrap = numWrap; }
-    /** Return the number of edges in the current facet.
-     * * Note that if this visitor has `numWrap` greater than zero, the number of edges is smaller than the number of points.
+    clientPolyface() {
+        return this._polyface;
+    }
+    /**
+     * Set the number of vertices replicated in visitor arrays (both data and index arrays).
+     * * 0,1,2 are the most common as numWrap.
+     * * Example: suppose `[6,7,8]` is the pointIndex array representing a triangle. First edge would be `6,7`. Second
+     * edge is `7,8`. Third edge is `8,6`. To access `6` for the third edge, we have to go back to the start of array.
+     * Therefore, it is useful to store `6` at the end of pointIndex array, i.e., `[6,7,8,6]` meaning `numWrap = 1`.
+     * * `numWrap = 2` is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
      */
-    get numEdgesThisFacet() { return this._numEdges; }
-    /** Create a visitor for iterating the facets of `polyface`, with indicated number of points to be added to each facet to produce closed point arrays
-     * Typical wrap counts are:
-     * * 0 -- leave the point arrays with "missing final edge"
-     * * 1 -- add point 0 as closure point
-     * * 2 -- add points 0 and 1 as closure and wrap point.  This is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
+    setNumWrap(numWrap) {
+        this._numWrap = numWrap;
+    }
+    /**
+     * Return the number of edges in the current facet.
+     * * If `numWrap > 0` for this visitor, the number of edges is smaller than the number of points.
      */
+    get numEdgesThisFacet() {
+        return this._numEdges;
+    }
+    /** Create a visitor for iterating the facets of `polyface`. */
     static create(polyface, numWrap) {
         return new IndexedPolyfaceVisitor(polyface, numWrap);
     }
-    /** Advance the iterator to a particular facet in the client polyface */
+    /** Advance the iterator to a particular facet in the client polyface. */
     moveToReadIndex(facetIndex) {
         if (!this._polyface.isValidFacetIndex(facetIndex))
             return false;
         this._currentFacetIndex = facetIndex;
         this._nextFacetIndex = facetIndex + 1;
         this._numEdges = this._polyface.numEdgeInFacet(facetIndex);
-        this.resizeAllDataArrays(this._numEdges + this._numWrap);
+        this.resizeAllArrays(this._numEdges + this._numWrap);
         this.gatherIndexedData(this._polyface.data, this._polyface.facetIndex0(this._currentFacetIndex), this._polyface.facetIndex1(this._currentFacetIndex), this._numWrap);
         return true;
     }
-    /** Advance the iterator to a the 'next' facet in the client polyface */
+    /** Advance the iterator to a the 'next' facet in the client polyface. */
     moveToNextFacet() {
         if (this._nextFacetIndex !== this._currentFacetIndex)
             return this.moveToReadIndex(this._nextFacetIndex);
@@ -67,11 +76,11 @@ export class IndexedPolyfaceVisitor extends PolyfaceData {
         this._nextFacetIndex = 0; // so immediate moveToNextFacet stays here.
     }
     /**
-     * Attempts to extract the distance parameter for the given vertex index on the current facet
-     * Returns the distance parameter as a point. Returns undefined on failure.
+     * Attempts to extract the distance parameter for the given vertex `index` on the current facet.
+     * Returns the distance parameter as a point. Returns `undefined` on failure.
      */
     tryGetDistanceParameter(index, result) {
-        if (index >= this.numEdgesThisFacet)
+        if (index < 0 || index >= this.numEdgesThisFacet)
             return undefined;
         if (this.param === undefined || this._polyface.data.face.length === 0)
             return undefined;
@@ -81,11 +90,11 @@ export class IndexedPolyfaceVisitor extends PolyfaceData {
         return faceData.convertParamXYToDistance(this.param.getXAtUncheckedPointIndex(index), this.param.getYAtUncheckedPointIndex(index), result);
     }
     /**
-     * Attempts to extract the normalized parameter (0,1) for the given vertex index on the current facet.
-     * Returns the normalized parameter as a point. Returns undefined on failure.
+     * Attempts to extract the normalized parameter (0,1) for the given vertex `index` on the current facet.
+     * Returns the normalized parameter as a point. Returns `undefined` on failure.
      */
     tryGetNormalizedParameter(index, result) {
-        if (index >= this.numEdgesThisFacet)
+        if (index < 0 || index >= this.numEdgesThisFacet)
             return undefined;
         if (this.param === undefined || this._polyface.data.face.length === 0)
             return undefined;
@@ -94,19 +103,31 @@ export class IndexedPolyfaceVisitor extends PolyfaceData {
             return undefined;
         return faceData.convertParamXYToNormalized(this.param.getXAtUncheckedPointIndex(index), this.param.getYAtUncheckedPointIndex(index), result);
     }
-    /** Return the index (in the client polyface) of the current facet */
-    currentReadIndex() { return this._currentFacetIndex; }
-    /** Return the point index of vertex i within the currently loaded facet */
-    clientPointIndex(i) { return this.pointIndex[i]; }
-    /** Return the param index of vertex i within the currently loaded facet */
-    clientParamIndex(i) { return this.paramIndex ? this.paramIndex[i] : -1; }
-    /** Return the normal index of vertex i within the currently loaded facet */
-    clientNormalIndex(i) { return this.normalIndex ? this.normalIndex[i] : -1; }
-    /** Return the color index of vertex i within the currently loaded facet */
-    clientColorIndex(i) { return this.colorIndex ? this.colorIndex[i] : -1; }
-    /** Return the aux data index of vertex i within the currently loaded facet */
-    clientAuxIndex(i) { return this.auxData ? this.auxData.indices[i] : -1; }
-    /** clear the contents of all arrays.  Use this along with transferDataFrom methods to build up new facets */
+    /** Return the index (in the client polyface) of the current facet. */
+    currentReadIndex() {
+        return this._currentFacetIndex;
+    }
+    /** Return the point index of vertex `i` within the currently loaded facet. */
+    clientPointIndex(i) {
+        return this.pointIndex[i];
+    }
+    /** Return the param index of vertex `i` within the currently loaded facet. */
+    clientParamIndex(i) {
+        return this.paramIndex ? this.paramIndex[i] : -1;
+    }
+    /** Return the normal index of vertex `i` within the currently loaded facet. */
+    clientNormalIndex(i) {
+        return this.normalIndex ? this.normalIndex[i] : -1;
+    }
+    /** Return the color index of vertex `i` within the currently loaded facet. */
+    clientColorIndex(i) {
+        return this.colorIndex ? this.colorIndex[i] : -1;
+    }
+    /** Return the aux data index of vertex `i` within the currently loaded facet. */
+    clientAuxIndex(i) {
+        return this.auxData ? this.auxData.indices[i] : -1;
+    }
+    /** Clear the contents of all arrays. */
     clearArrays() {
         if (this.point !== undefined)
             this.point.length = 0;
@@ -117,77 +138,36 @@ export class IndexedPolyfaceVisitor extends PolyfaceData {
         if (this.color !== undefined)
             this.color.length = 0;
     }
-    /** transfer data from a specified index of the other visitor as new data in this visitor. */
+    /** Transfer data from a specified `index` of the `other` visitor as new data in this visitor. */
     pushDataFrom(other, index) {
         this.point.pushFromGrowableXYZArray(other.point, index);
-        if (this.color && other.color && index < other.color.length)
-            this.color.push(other.color[index]);
         if (this.param && other.param && index < other.param.length)
             this.param.pushFromGrowableXYArray(other.param, index);
         if (this.normal && other.normal && index < other.normal.length)
             this.normal.pushFromGrowableXYZArray(other.normal, index);
+        if (this.color && other.color && index < other.color.length)
+            this.color.push(other.color[index]);
     }
-    /** transfer interpolated data from the other visitor.
-     * * all data values are interpolated at `fraction` between `other` values at index0 and index1.
+    /**
+     * Transfer interpolated data from the other visitor.
+     * * All data values are interpolated at `fraction` between `other` values at `index0` and `index1`.
      */
     pushInterpolatedDataFrom(other, index0, fraction, index1) {
         this.point.pushInterpolatedFromGrowableXYZArray(other.point, index0, fraction, index1);
-        if (this.color && other.color && index0 < other.color.length && index1 < other.color.length)
-            this.color.push(interpolateColor(other.color[index0], fraction, other.color[index1]));
         if (this.param && other.param && index0 < other.param.length && index1 < other.param.length)
             this.param.pushInterpolatedFromGrowableXYArray(other.param, index0, fraction, index1);
         if (this.normal && other.normal && index0 < other.normal.length && index1 < other.normal.length)
             this.normal.pushInterpolatedFromGrowableXYZArray(other.normal, index0, fraction, index1);
+        if (this.color && other.color && index0 < other.color.length && index1 < other.color.length)
+            this.color.push(Geometry.interpolateColor(other.color[index0], fraction, other.color[index1]));
     }
 }
 /**
- * * shift to right by shiftBits.
- * * mask off the low 8 bits
- * * interpolate the number
- * * truncate to floor
- * * shift left
- * * Hence all numbers in and out of the floating point are 0..255.
- * @param color0
- * @param fraction
- * @param color1
- * @param shiftBits
- */
-function interpolateByte(color0, fraction, color1, shiftBits) {
-    color0 = (color0 >>> shiftBits) & 0xFF;
-    color1 = (color1 >>> shiftBits) & 0xFF;
-    const color = Math.floor(color0 + fraction * (color1 - color0)) & 0xFF;
-    return color << shiftBits;
-}
-/**
- * Interpolate each byte of color0 and color1 as integers.
- * @param color0 32 bit color (e.g. rgb+transparency)
- * @param fraction fractional position.  This is clamped to 0..1 to prevent byte values outside their 0..255 range.
- * @param color1
- * @param shiftBits
- * @internal
- */
-export function interpolateColor(color0, fraction, color1) {
-    // don't allow fractions outside the individual byte ranges.
-    fraction = Geometry.clamp(fraction, 0, 1);
-    // interpolate each byte in place ....
-    /*
-    const byte0 = interpolateLowByte(color0 & 0xFF, fraction, color1 & 0xFF);
-    const byte1 = interpolateLowByte((color0 & 0xFF00) >>> 8, fraction, (color1 & 0xFF00) >>> 8) << 8;
-    const byte2 = interpolateLowByte((color0 & 0xFF0000) >>> 16, fraction, (color1 & 0xFF0000) >>> 16) << 16;
-    const byte3 = interpolateLowByte((color0 & 0xFF000000) >>> 24, fraction, (color1 & 0xFF000000) >>> 24) << 24;
-    */
-    const byte0 = interpolateByte(color0, fraction, color1, 0);
-    const byte1 = interpolateByte(color0, fraction, color1, 8);
-    const byte2 = interpolateByte(color0, fraction, color1, 16);
-    const byte3 = interpolateByte(color0, fraction, color1, 24);
-    return (byte0 | byte1 | byte2 | byte3);
-}
-/**
- * An `IndexedPolyfaceSubsetVisitor` is an IndexedPolyfaceVisitor which only visits a subset of facets in the polyface.
+ * An `IndexedPolyfaceSubsetVisitor` is an `IndexedPolyfaceVisitor` which only visits a subset of facets in the polyface.
  * * The subset is defined by an array of facet indices provided when this visitor is created.
- * * Within the subset visitor, "facetIndex" is understood as index within the subset array:
- *   * moveToNextFacet moves only within the subset
- *   * moveToReadIndex(i) moves underlying visitor's parentFacetIndex(i)
+ * * Within the subset visitor, `facetIndex` is understood as index within the subset array:
+ *   * `moveToNextFacet` moves only within the subset.
+ *   * `moveToReadIndex(i)` moves underlying visitor's `parentFacetIndex(i)`.
  * @public
  */
 export class IndexedPolyfaceSubsetVisitor extends IndexedPolyfaceVisitor {
@@ -196,17 +176,14 @@ export class IndexedPolyfaceSubsetVisitor extends IndexedPolyfaceVisitor {
         this._parentFacetIndices = activeFacetIndices.slice();
         this._nextActiveIndex = 0;
     }
-    /** Create a visitor for iterating a subset of the facets of `polyface`, with indicated number of points to be added to each facet to produce closed point arrays
-     * * Typical wrap counts are:
-     *   * 0 -- leave the point arrays with "missing final edge"
-     *   * 1 -- add point 0 as closure point
-     *   * 2 -- add points 0 and 1 as closure and wrap point.  This is useful when vertex visit requires two adjacent vectors, e.g. for cross products.
-     * * The activeFacetIndices array indicates all facets to be visited.
+    /**
+     * Create a visitor for iterating a subset of the facets of `polyface`.
+     * * The `activeFacetIndices` array indicates all facets to be visited.
      */
     static createSubsetVisitor(polyface, activeFacetIndices, numWrap) {
         return new IndexedPolyfaceSubsetVisitor(polyface, activeFacetIndices, numWrap);
     }
-    /** Advance the iterator to a particular facet in the client polyface */
+    /** Advance the iterator to a particular facet in the client polyface. */
     moveToReadIndex(activeIndex) {
         if (activeIndex >= 0 && activeIndex <= this._parentFacetIndices.length) {
             this._nextActiveIndex = activeIndex;
@@ -214,7 +191,7 @@ export class IndexedPolyfaceSubsetVisitor extends IndexedPolyfaceVisitor {
         }
         return false;
     }
-    /** Advance the iterator to a the 'next' facet in the client polyface */
+    /** Advance the iterator to the next facet in the client polyface. */
     moveToNextFacet() {
         if (this._nextActiveIndex < this._parentFacetIndices.length) {
             const result = this.moveToReadIndex(this._nextActiveIndex);
@@ -225,11 +202,11 @@ export class IndexedPolyfaceSubsetVisitor extends IndexedPolyfaceVisitor {
         }
         return false;
     }
-    /** Reset the iterator to start at the first facet of the polyface. */
+    /** Reset the iterator to start at the first active facet in the polyface. */
     reset() {
         this._nextActiveIndex = 0;
     }
-    /** return the parent facet index of the indicated index within the active facets */
+    /** Return the parent facet index of the indicated index within the active facets. */
     parentFacetIndex(activeIndex) {
         if (activeIndex >= 0 && activeIndex <= this._nextActiveIndex) {
             return this._parentFacetIndices[activeIndex];