@itwin/core-backend 5.0.0-dev.9 → 5.0.0-dev.92

package/lib/esm/ExportGraphics.d.ts

@@ -0,0 +1,318 @@
+/** @packageDocumentation
+ * @module ExportGraphics
+ */
+import { Id64Array, Id64String } from "@itwin/core-bentley";
+import { IndexedPolyface, Polyface, PolyfaceData, PolyfaceVisitor } from "@itwin/core-geometry";
+import { ColorDefProps, GeometryClass } from "@itwin/core-common";
+/** A collection of line segments, suitable for direct use with graphics APIs.
+ * The structure of this data matches GL_LINES in OpenGL.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export interface ExportGraphicsLines {
+    /** Zero-based vertex indices, every two indices represent a line segment */
+    indices: Int32Array;
+    /** Vertices for these lines, laid out in the pattern XYZXYZ */
+    points: Float64Array;
+}
+/** Info provided to ExportLinesFunction about linework graphics.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export interface ExportLinesInfo {
+    /** The element ID for the element the graphics originated from */
+    elementId: Id64String;
+    /** ID for the [SubCategory]($core-backend) for these graphics  */
+    subCategory: Id64String;
+    /** The color and transparency for these graphics */
+    color: ColorDefProps;
+    /** GeometryClass for these graphics */
+    geometryClass: GeometryClass;
+    /** The linework for these graphics */
+    lines: ExportGraphicsLines;
+}
+/** A callback function that receives generated line graphics.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export type ExportLinesFunction = (info: ExportLinesInfo) => void;
+/** A triangulated mesh with unified indices, suitable for direct use with graphics APIs.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export interface ExportGraphicsMesh {
+    /** Zero-based vertex indices, every three indices represent a triangle */
+    indices: Int32Array;
+    /** Vertices for this mesh, laid out in the pattern XYZXYZ */
+    points: Float64Array;
+    /** Normals for this mesh, laid out in the pattern XYZXYZ */
+    normals: Float32Array;
+    /** Parameters (uvs) for this mesh, laid out in the pattern XYXY */
+    params: Float32Array;
+    /** If true, clients should assume both sides of the mesh are visible and not cull backfaces. */
+    isTwoSided: boolean;
+}
+/** Info provided to ExportGraphicsFunction about graphics.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export interface ExportGraphicsInfo {
+    /** The element ID for the element the graphics originated from */
+    elementId: Id64String;
+    /** ID for the [SubCategory]($core-backend) for these graphics  */
+    subCategory: Id64String;
+    /** The color and transparency for these graphics */
+    color: ColorDefProps;
+    /** GeometryClass for these graphics */
+    geometryClass: GeometryClass;
+    /** If defined, ID for the [RenderMaterialElement]($core-backend) for these graphics */
+    materialId?: Id64String;
+    /** If defined, ID for the [Texture]($core-backend) for these graphics  */
+    textureId?: Id64String;
+    /** The mesh for these graphics */
+    mesh: ExportGraphicsMesh;
+}
+/** Information about the base display properties when a [GeometryPart]($core-backend) was
+ * referenced. This is intended to be used with [IModelDb.exportPartGraphics]($core-backend).
+ *  * If two ExportPartInstanceInfo have the same ExportPartDisplayInfos, they will result in the
+ *    same graphics (with a different transform).
+ *  * If two ExportPartInstanceInfo have different ExportPartDisplayInfos, they may result in different
+ *    graphics.
+ * @public
+ */
+export interface ExportPartDisplayInfo {
+    categoryId: Id64String;
+    subCategoryId: Id64String;
+    geometryClass: GeometryClass;
+    materialId: Id64String;
+    elmTransparency: number;
+    lineColor: number;
+}
+/** Information about references to [GeometryPart]($core-backend) elements found during
+ * a call to [IModelDb.exportGraphics]($core-backend).
+ * See [IModelDb.exportPartGraphics]($core-backend) for the intended use case.
+ * @public
+ */
+export interface ExportPartInstanceInfo {
+    /** ID for the [GeometryPart]($core-backend) */
+    partId: Id64String;
+    /** ID for the element that contained the reference to the [GeometryPart]($core-backend) */
+    partInstanceId: Id64String;
+    /** The base display properties when the [GeometryPart]($core-backend) was referenced. */
+    displayProps: ExportPartDisplayInfo;
+    /** A row-major storage 4x3 transform for this instance.
+     *  See export-gltf under test-apps in the iTwin.js monorepo for a working reference.
+     */
+    transform?: Float64Array;
+}
+/** A callback function that receives generated graphics.
+ * See [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export type ExportGraphicsFunction = (info: ExportGraphicsInfo) => void;
+/** Parameters for [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export interface ExportGraphicsOptions {
+    /** The source elements for the exported graphics */
+    elementIdArray: Id64Array;
+    /** A function to call for each unique element ID, color and texture combination */
+    onGraphics: ExportGraphicsFunction;
+    /** An optional function to call if line graphics are desired. */
+    onLineGraphics?: ExportLinesFunction;
+    /** If supplied, any references to [GeometryPart]($core-backend) elements found will be
+     * recorded in this array. In this case, graphics that would result from the GeometryPart
+     * will not be supplied via onGraphics. See [IModelDb.exportPartGraphics]($core-backend)
+     */
+    partInstanceArray?: ExportPartInstanceInfo[];
+    /** Max distance from a face to the original geometry, see [StrokeOptions]($core-geometry).
+     * If not supplied, defaults to zero and angleTol will control the quality of the resulting mesh.
+     */
+    chordTol?: number;
+    /** Max angle difference in radians for approximated face, see [StrokeOptions]($core-geometry).
+     * If not supplied, defaults to PI/12 (15 degrees).
+     */
+    angleTol?: number;
+    /** Max length of any edge in generated faces, see [StrokeOptions]($core-geometry).
+     * If not supplied, there is no maximum length of an edge. Supplying this value can greatly increase the
+     * size of the resulting geometry, and should only be done in cases where necessary (if you don't know
+     * that it's necessary, it's almost certainly not!)
+     */
+    maxEdgeLength?: number;
+    /** The longest dimension of a line style's largest component must be at least this size in order for
+     * exportGraphics to evaluate and generate its graphics. If undefined, this defaults to 0.1.
+     * Line styles can evaluate to 3D geometry that clients expect to receive from exportGraphics, but they
+     * can also generate gigabytes of mesh data when line styles with small components are applied to long
+     * line strings.
+     */
+    minLineStyleComponentSize?: number;
+    /** Max distance between mesh vertices for them to be collapsed.
+     * Meshes stored in GeometryStreams are unaffected by StrokeOptions settings. If decimationTol is undefined,
+     * they are output from exportGraphics without any reduction in quality and can be too detailed for
+     * some uses. However, decimation is a destructive operation that can introduce gaps and other visual
+     * anomalies so it is important to choose an appropriate setting for your use case.
+     */
+    decimationTol?: number;
+    /** BRep features with bounding boxes smaller than this size will not generate graphics.
+     * This option can be used to ignore expensive details from [BRepEntity.DataProps]($core-common)
+     * like screws and screw holes.
+     */
+    minBRepFeatureSize?: number;
+}
+/** Info provided to ExportPartFunction about graphics.
+ * See [IModelDb.exportPartGraphics]($core-backend)
+ * @public
+ */
+export interface ExportPartInfo {
+    /** The color and transparency for these graphics */
+    color: ColorDefProps;
+    /** GeometryClass for these graphics */
+    geometryClass: GeometryClass;
+    /** If defined, ID for the [RenderMaterialElement]($core-backend) for these graphics */
+    materialId?: Id64String;
+    /** If defined, ID for the [Texture]($core-backend) for these graphics  */
+    textureId?: Id64String;
+    /** The mesh for these graphics */
+    mesh: ExportGraphicsMesh;
+}
+/** A callback function that receives generated graphics for a [GeometryPart]($core-backend).
+ * See [IModelDb.exportPartGraphics]($core-backend)
+ * @public
+ */
+export type ExportPartFunction = (info: ExportPartInfo) => void;
+/** Info provided to ExportPartFunction about line graphics.
+ * See [IModelDb.exportPartGraphics]($core-backend)
+ * @public
+ */
+export interface ExportPartLinesInfo {
+    /** The color and transparency for these graphics */
+    color: ColorDefProps;
+    /** GeometryClass for these graphics */
+    geometryClass: GeometryClass;
+    /** The linework for these graphics */
+    lines: ExportGraphicsLines;
+}
+/** A callback function that receives generated line graphics for a [GeometryPart]($core-backend).
+ * See [IModelDb.exportPartGraphics]($core-backend)
+ * @public
+ */
+export type ExportPartLinesFunction = (info: ExportPartLinesInfo) => void;
+/** Parameters for [IModelDb.exportPartGraphics]($core-backend)
+ * @public
+ */
+export interface ExportPartGraphicsOptions {
+    /** The ID for the source [GeometryPart]($core-backend) */
+    elementId: Id64String;
+    /** The base display properties to use for generating the graphics. This should come from an
+     * ExportPartInstanceProps generated by [IModelDb.exportGraphics]($core-backend)
+     */
+    displayProps: ExportPartDisplayInfo;
+    /** A function to call for each unique color and texture combination. */
+    onPartGraphics: ExportPartFunction;
+    /** An optional function to call if line graphics are desired. */
+    onPartLineGraphics?: ExportPartLinesFunction;
+    /** Max distance from a face to the original geometry, see [StrokeOptions]($core-geometry).
+     * If not supplied, defaults to zero and angleTol will control the quality of the resulting mesh.
+     */
+    chordTol?: number;
+    /** Max angle difference in radians for approximated face, see [StrokeOptions]($core-geometry).
+     * If not supplied, defaults to PI/12 (15 degrees).
+     */
+    angleTol?: number;
+    /** Max length of any edge in generated faces, see [StrokeOptions]($core-geometry)
+     * If not supplied, there is no maximum length of an edge. Supplying this value can greatly increase the
+     * size of the resulting geometry, and should only be done in cases where necessary (if you don't know
+     * that it's necessary, it's almost certainly not!)
+     */
+    maxEdgeLength?: number;
+    /** The longest dimension of a line style's largest component must be at least this size in order for
+     * exportGraphics to evaluate and generate its graphics. If undefined, this defaults to 0.1.
+     * Line styles can evaluate to 3D geometry that clients expect to receive from exportGraphics, but they
+     * can also generate gigabytes of mesh data when line styles with small components are applied to long
+     * line strings.
+     */
+    minLineStyleComponentSize?: number;
+    /** Max distance between mesh vertices for them to be collapsed.
+     * Meshes stored in GeometryStreams are unaffected by StrokeOptions settings. If decimationTol is undefined,
+     * they are output from exportGraphics without any reduction in quality and can be too detailed for
+     * some uses. However, decimation is a destructive operation that can introduce gaps and other visual
+     * anomalies so it is important to choose an appropriate setting for your use case.
+     */
+    decimationTol?: number;
+    /** BRep features with bounding boxes smaller than this size will not generate graphics.
+     * This option can be used to ignore expensive details from [BRepEntity.DataProps]($core-common)
+     * like screws and screw holes.
+     */
+    minBRepFeatureSize?: number;
+}
+/** Provides utility functions for working with data generated by [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export declare namespace ExportGraphics {
+    /** Test if ExportPartDisplayInfos have exactly the same values.
+     * @public
+     */
+    function arePartDisplayInfosEqual(lhs: ExportPartDisplayInfo, rhs: ExportPartDisplayInfo): boolean;
+    /**
+     * Convert an ExportGraphicsMesh to an IndexedPolyface usable by the geometry API.
+     * @note The resulting IndexedPolyface may have duplicate points, normals and params. If problematic, call [PolyfaceData.compress]($core-geometry)
+     * @public
+     */
+    function convertToIndexedPolyface(mesh: ExportGraphicsMesh): IndexedPolyface;
+}
+/**
+ * * Iterator to walk the facets of an ExportGraphicsMesh and present them to the world as if visiting a Polyface.
+ * * Because the ExportGraphicsMesh has limited data:
+ *   * There is no auxData in this visitor.
+ *   * There is no color in this visitor.
+ *   * All edgeVisible are true.
+ * @public
+ */
+export declare class ExportGraphicsMeshVisitor extends PolyfaceData implements PolyfaceVisitor {
+    private _currentFacetIndex;
+    private _nextFacetIndex;
+    private _numWrap;
+    private _polyface;
+    private constructor();
+    /** 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.
+     */
+    static create(polyface: ExportGraphicsMesh, numWrap: number): ExportGraphicsMeshVisitor;
+    /** Reset the iterator to start at the first facet of the polyface. */
+    reset(): void;
+    /** Select a facet by simple index. */
+    moveToReadIndex(facetIndex: number): boolean;
+    moveToNextFacet(): boolean;
+    /** Set the number of vertices to replicate in visitor arrays. */
+    setNumWrap(numWrap: number): void;
+    /** 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 */
+    clientPointIndex(i: number): number;
+    /** Return the param index of vertex i within the currently loaded facet.
+     * Use the artificial paramIndex, which matches pointIndex.
+     */
+    clientParamIndex(i: number): number;
+    /** Return the normal index of vertex i within the currently loaded facet.
+     * Use the artificial paramIndex, which matches pointIndex.
+     */
+    clientNormalIndex(i: number): number;
+    /** 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 */
+    clientAuxIndex(_i: number): number;
+    /** return the client polyface */
+    clientPolyface(): Polyface;
+    /** clear the contents of all arrays.  Use this along with transferDataFrom methods to build up new facets */
+    clearArrays(): void;
+    /** 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;
+    /** transfer data from a specified index of the other visitor as new data in this visitor. */
+    pushDataFrom(other: PolyfaceVisitor, index: number): void;
+}
+//# sourceMappingURL=ExportGraphics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExportGraphics.d.ts","sourceRoot":"","sources":["../../src/ExportGraphics.ts"],"names":[],"mappings":"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"}

package/lib/esm/ExportGraphics.js

@@ -0,0 +1,209 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ExportGraphics
+ */
+import { assert } from "@itwin/core-bentley";
+import { IndexedPolyface, PolyfaceData } from "@itwin/core-geometry";
+/** Provides utility functions for working with data generated by [IModelDb.exportGraphics]($core-backend)
+ * @public
+ */
+export var ExportGraphics;
+(function (ExportGraphics) {
+    /** Test if ExportPartDisplayInfos have exactly the same values.
+     * @public
+     */
+    function arePartDisplayInfosEqual(lhs, rhs) {
+        if (lhs.categoryId !== rhs.categoryId)
+            return false;
+        if (lhs.subCategoryId !== rhs.subCategoryId)
+            return false;
+        if (lhs.materialId !== rhs.materialId)
+            return false;
+        if (lhs.elmTransparency !== rhs.elmTransparency)
+            return false;
+        if (lhs.lineColor !== rhs.lineColor)
+            return false;
+        return true;
+    }
+    ExportGraphics.arePartDisplayInfosEqual = arePartDisplayInfosEqual;
+    /**
+     * Convert an ExportGraphicsMesh to an IndexedPolyface usable by the geometry API.
+     * @note The resulting IndexedPolyface may have duplicate points, normals and params. If problematic, call [PolyfaceData.compress]($core-geometry)
+     * @public
+     */
+    function convertToIndexedPolyface(mesh) {
+        const polyface = IndexedPolyface.create(true, true, false, mesh.isTwoSided);
+        const p = mesh.points;
+        for (let i = 0; i < p.length; i += 3)
+            polyface.data.point.pushXYZ(p[i], p[i + 1], p[i + 2]);
+        const n = mesh.normals;
+        assert(undefined !== polyface.data.normal);
+        for (let i = 0; i < n.length; i += 3)
+            polyface.data.normal.pushXYZ(n[i], n[i + 1], n[i + 2]);
+        const uv = mesh.params;
+        assert(undefined !== polyface.data.param);
+        for (let i = 0; i < uv.length; i += 2)
+            polyface.data.param.pushXY(uv[i], uv[i + 1]);
+        const indices = mesh.indices;
+        const addIndex = (idx) => {
+            polyface.addPointIndex(idx, true);
+            polyface.addNormalIndex(idx);
+            polyface.addParamIndex(idx);
+        };
+        for (let i = 0; i < indices.length; i += 3) {
+            addIndex(indices[i]);
+            addIndex(indices[i + 1]);
+            addIndex(indices[i + 2]);
+            polyface.terminateFacet(false);
+        }
+        return polyface;
+    }
+    ExportGraphics.convertToIndexedPolyface = convertToIndexedPolyface;
+})(ExportGraphics || (ExportGraphics = {}));
+/**
+ * * Iterator to walk the facets of an ExportGraphicsMesh and present them to the world as if visiting a Polyface.
+ * * Because the ExportGraphicsMesh has limited data:
+ *   * There is no auxData in this visitor.
+ *   * There is no color in this visitor.
+ *   * All edgeVisible are true.
+ * @public
+ */
+export class ExportGraphicsMeshVisitor extends PolyfaceData {
+    _currentFacetIndex;
+    _nextFacetIndex;
+    _numWrap;
+    _polyface;
+    // to be called from static factory method that validates the polyface ...
+    constructor(facets, numWrap) {
+        super(facets.normals.length > 0, facets.params.length > 0, false, facets.isTwoSided);
+        this._polyface = facets;
+        this._numWrap = numWrap;
+        this._nextFacetIndex = 0;
+        this._currentFacetIndex = -1;
+        this.twoSided = facets.isTwoSided;
+        this.reset();
+    }
+    /** 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.
+     */
+    static create(polyface, numWrap) {
+        return new ExportGraphicsMeshVisitor(polyface, numWrap);
+    }
+    /** Reset the iterator to start at the first facet of the polyface. */
+    reset() {
+        this.moveToReadIndex(0);
+        this._nextFacetIndex = 0; // so immediate moveToNextFacet stays here.
+    }
+    /** Select a facet by simple index. */
+    moveToReadIndex(facetIndex) {
+        if (facetIndex < 0 || 2 + facetIndex * 3 >= this._polyface.indices.length)
+            return false;
+        this._currentFacetIndex = facetIndex;
+        this._nextFacetIndex = facetIndex + 1;
+        this.point.length = 0;
+        const points = this.point;
+        points.length = 0;
+        this.pointIndex.length = 0;
+        this.point.length = 0;
+        this.edgeVisible.length = 0;
+        const sourcePoints = this._polyface.points;
+        const indices = this._polyface.indices;
+        const i0 = 3 * facetIndex;
+        for (let i = i0; i < i0 + 3; i++) {
+            const k = 3 * indices[i];
+            this.pointIndex.push(indices[i]);
+            this.point.pushXYZ(sourcePoints[k], sourcePoints[k + 1], sourcePoints[k + 2]);
+            this.edgeVisible.push(true);
+        }
+        for (let i = 0; i < this._numWrap; i++) {
+            this.point.pushFromGrowableXYZArray(this.point, i);
+        }
+        const sourceParams = this._polyface.params;
+        if (sourceParams.length > 0 && this.paramIndex && this.param) {
+            this.paramIndex.length = 0;
+            this.param.length = 0;
+            for (let i = i0; i < i0 + 3; i++) {
+                const k = 2 * indices[i];
+                this.paramIndex.push(indices[i]);
+                this.param.pushXY(sourceParams[k], sourceParams[k + 1]);
+            }
+            for (let i = 0; i < this._numWrap; i++) {
+                this.param.pushFromGrowableXYArray(this.param, i);
+            }
+        }
+        const sourceNormals = this._polyface.normals;
+        if (sourceNormals.length > 0 && this.normalIndex && this.normal) {
+            this.normalIndex.length = 0;
+            this.normal.length = 0;
+            for (let i = i0; i < i0 + 3; i++) {
+                const k = 3 * indices[i];
+                this.normalIndex.push(indices[i]);
+                this.normal.pushXYZ(sourceNormals[k], sourceNormals[k + 1], sourceNormals[k + 2]);
+            }
+            for (let i = 0; i < this._numWrap; i++) {
+                this.normal.pushFromGrowableXYZArray(this.normal, i);
+            }
+        }
+        return true;
+    }
+    moveToNextFacet() {
+        return this.moveToReadIndex(this._nextFacetIndex);
+    }
+    /** Set the number of vertices to replicate in visitor arrays. */
+    setNumWrap(numWrap) { this._numWrap = numWrap; }
+    /** 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.
+     * Use the artificial paramIndex, which matches pointIndex.
+     */
+    clientParamIndex(i) { return this.paramIndex ? this.paramIndex[i] : -1; }
+    /** Return the normal index of vertex i within the currently loaded facet.
+     * Use the artificial paramIndex, which matches pointIndex.
+     */
+    clientNormalIndex(i) { return this.normalIndex ? this.normalIndex[i] : -1; }
+    /** Return the color index of vertex i within the currently loaded facet */
+    clientColorIndex(_i) { return 1; }
+    /** Return the aux data index of vertex i within the currently loaded facet */
+    clientAuxIndex(_i) { return -1; }
+    /** return the client polyface */
+    clientPolyface() { return undefined; }
+    /** clear the contents of all arrays.  Use this along with transferDataFrom methods to build up new facets */
+    clearArrays() {
+        if (this.point !== undefined)
+            this.point.length = 0;
+        if (this.param !== undefined)
+            this.param.length = 0;
+        if (this.normal !== undefined)
+            this.normal.length = 0;
+        // ignore color and aux -- they never exist.
+    }
+    /** 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.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);
+    }
+    /** 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);
+    }
+}
+//# sourceMappingURL=ExportGraphics.js.map

package/lib/esm/ExportGraphics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportGraphics.js","sourceRoot":"","sources":["../../src/ExportGraphics.ts"],"names":[],"mappings":"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","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/** @packageDocumentation\n * @module ExportGraphics\n */\n\nimport { assert, Id64Array, Id64String } from \"@itwin/core-bentley\";\nimport { IndexedPolyface, Polyface, PolyfaceData, PolyfaceVisitor } from \"@itwin/core-geometry\";\nimport { ColorDefProps, GeometryClass } from \"@itwin/core-common\";\n\n/** A collection of line segments, suitable for direct use with graphics APIs.\n * The structure of this data matches GL_LINES in OpenGL.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport interface ExportGraphicsLines {\n  /** Zero-based vertex indices, every two indices represent a line segment */\n  indices: Int32Array;\n  /** Vertices for these lines, laid out in the pattern XYZXYZ */\n  points: Float64Array;\n}\n\n/** Info provided to ExportLinesFunction about linework graphics.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport interface ExportLinesInfo {\n  /** The element ID for the element the graphics originated from */\n  elementId: Id64String;\n  /** ID for the [SubCategory]($core-backend) for these graphics  */\n  subCategory: Id64String;\n  /** The color and transparency for these graphics */\n  color: ColorDefProps;\n  /** GeometryClass for these graphics */\n  geometryClass: GeometryClass;\n  /** The linework for these graphics */\n  lines: ExportGraphicsLines;\n}\n\n/** A callback function that receives generated line graphics.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport type ExportLinesFunction = (info: ExportLinesInfo) => void;\n\n/** A triangulated mesh with unified indices, suitable for direct use with graphics APIs.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport interface ExportGraphicsMesh {\n  /** Zero-based vertex indices, every three indices represent a triangle */\n  indices: Int32Array;\n  /** Vertices for this mesh, laid out in the pattern XYZXYZ */\n  points: Float64Array;\n  /** Normals for this mesh, laid out in the pattern XYZXYZ */\n  normals: Float32Array;\n  /** Parameters (uvs) for this mesh, laid out in the pattern XYXY */\n  params: Float32Array;\n  /** If true, clients should assume both sides of the mesh are visible and not cull backfaces. */\n  isTwoSided: boolean;\n}\n\n/** Info provided to ExportGraphicsFunction about graphics.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport interface ExportGraphicsInfo {\n  /** The element ID for the element the graphics originated from */\n  elementId: Id64String;\n  /** ID for the [SubCategory]($core-backend) for these graphics  */\n  subCategory: Id64String;\n  /** The color and transparency for these graphics */\n  color: ColorDefProps;\n  /** GeometryClass for these graphics */\n  geometryClass: GeometryClass;\n  /** If defined, ID for the [RenderMaterialElement]($core-backend) for these graphics */\n  materialId?: Id64String;\n  /** If defined, ID for the [Texture]($core-backend) for these graphics  */\n  textureId?: Id64String;\n  /** The mesh for these graphics */\n  mesh: ExportGraphicsMesh;\n}\n\n/** Information about the base display properties when a [GeometryPart]($core-backend) was\n * referenced. This is intended to be used with [IModelDb.exportPartGraphics]($core-backend).\n *  * If two ExportPartInstanceInfo have the same ExportPartDisplayInfos, they will result in the\n *    same graphics (with a different transform).\n *  * If two ExportPartInstanceInfo have different ExportPartDisplayInfos, they may result in different\n *    graphics.\n * @public\n */\nexport interface ExportPartDisplayInfo {\n  categoryId: Id64String;\n  subCategoryId: Id64String;\n  geometryClass: GeometryClass;\n  materialId: Id64String;\n  elmTransparency: number;\n  lineColor: number;\n}\n\n/** Information about references to [GeometryPart]($core-backend) elements found during\n * a call to [IModelDb.exportGraphics]($core-backend).\n * See [IModelDb.exportPartGraphics]($core-backend) for the intended use case.\n * @public\n */\nexport interface ExportPartInstanceInfo {\n  /** ID for the [GeometryPart]($core-backend) */\n  partId: Id64String;\n  /** ID for the element that contained the reference to the [GeometryPart]($core-backend) */\n  partInstanceId: Id64String;\n  /** The base display properties when the [GeometryPart]($core-backend) was referenced. */\n  displayProps: ExportPartDisplayInfo;\n  /** A row-major storage 4x3 transform for this instance.\n   *  See export-gltf under test-apps in the iTwin.js monorepo for a working reference.\n   */\n  transform?: Float64Array;\n}\n\n/** A callback function that receives generated graphics.\n * See [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport type ExportGraphicsFunction = (info: ExportGraphicsInfo) => void;\n\n/** Parameters for [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport interface ExportGraphicsOptions {\n  /** The source elements for the exported graphics */\n  elementIdArray: Id64Array;\n  /** A function to call for each unique element ID, color and texture combination */\n  onGraphics: ExportGraphicsFunction;\n  /** An optional function to call if line graphics are desired. */\n  onLineGraphics?: ExportLinesFunction;\n  /** If supplied, any references to [GeometryPart]($core-backend) elements found will be\n   * recorded in this array. In this case, graphics that would result from the GeometryPart\n   * will not be supplied via onGraphics. See [IModelDb.exportPartGraphics]($core-backend)\n   */\n  partInstanceArray?: ExportPartInstanceInfo[];\n  /** Max distance from a face to the original geometry, see [StrokeOptions]($core-geometry).\n   * If not supplied, defaults to zero and angleTol will control the quality of the resulting mesh.\n   */\n  chordTol?: number;\n  /** Max angle difference in radians for approximated face, see [StrokeOptions]($core-geometry).\n   * If not supplied, defaults to PI/12 (15 degrees).\n   */\n  angleTol?: number;\n  /** Max length of any edge in generated faces, see [StrokeOptions]($core-geometry).\n   * If not supplied, there is no maximum length of an edge. Supplying this value can greatly increase the\n   * size of the resulting geometry, and should only be done in cases where necessary (if you don't know\n   * that it's necessary, it's almost certainly not!)\n   */\n  maxEdgeLength?: number;\n  /** The longest dimension of a line style's largest component must be at least this size in order for\n   * exportGraphics to evaluate and generate its graphics. If undefined, this defaults to 0.1.\n   * Line styles can evaluate to 3D geometry that clients expect to receive from exportGraphics, but they\n   * can also generate gigabytes of mesh data when line styles with small components are applied to long\n   * line strings.\n   */\n  minLineStyleComponentSize?: number;\n  /** Max distance between mesh vertices for them to be collapsed.\n   * Meshes stored in GeometryStreams are unaffected by StrokeOptions settings. If decimationTol is undefined,\n   * they are output from exportGraphics without any reduction in quality and can be too detailed for\n   * some uses. However, decimation is a destructive operation that can introduce gaps and other visual\n   * anomalies so it is important to choose an appropriate setting for your use case.\n   */\n  decimationTol?: number;\n  /** BRep features with bounding boxes smaller than this size will not generate graphics.\n   * This option can be used to ignore expensive details from [BRepEntity.DataProps]($core-common)\n   * like screws and screw holes.\n   */\n  minBRepFeatureSize?: number;\n}\n\n/** Info provided to ExportPartFunction about graphics.\n * See [IModelDb.exportPartGraphics]($core-backend)\n * @public\n */\nexport interface ExportPartInfo {\n  /** The color and transparency for these graphics */\n  color: ColorDefProps;\n  /** GeometryClass for these graphics */\n  geometryClass: GeometryClass;\n  /** If defined, ID for the [RenderMaterialElement]($core-backend) for these graphics */\n  materialId?: Id64String;\n  /** If defined, ID for the [Texture]($core-backend) for these graphics  */\n  textureId?: Id64String;\n  /** The mesh for these graphics */\n  mesh: ExportGraphicsMesh;\n}\n\n/** A callback function that receives generated graphics for a [GeometryPart]($core-backend).\n * See [IModelDb.exportPartGraphics]($core-backend)\n * @public\n */\nexport type ExportPartFunction = (info: ExportPartInfo) => void;\n\n/** Info provided to ExportPartFunction about line graphics.\n * See [IModelDb.exportPartGraphics]($core-backend)\n * @public\n */\nexport interface ExportPartLinesInfo {\n  /** The color and transparency for these graphics */\n  color: ColorDefProps;\n  /** GeometryClass for these graphics */\n  geometryClass: GeometryClass;\n  /** The linework for these graphics */\n  lines: ExportGraphicsLines;\n}\n\n/** A callback function that receives generated line graphics for a [GeometryPart]($core-backend).\n * See [IModelDb.exportPartGraphics]($core-backend)\n * @public\n */\nexport type ExportPartLinesFunction = (info: ExportPartLinesInfo) => void;\n\n/** Parameters for [IModelDb.exportPartGraphics]($core-backend)\n * @public\n */\nexport interface ExportPartGraphicsOptions {\n  /** The ID for the source [GeometryPart]($core-backend) */\n  elementId: Id64String;\n  /** The base display properties to use for generating the graphics. This should come from an\n   * ExportPartInstanceProps generated by [IModelDb.exportGraphics]($core-backend)\n   */\n  displayProps: ExportPartDisplayInfo;\n  /** A function to call for each unique color and texture combination. */\n  onPartGraphics: ExportPartFunction;\n  /** An optional function to call if line graphics are desired. */\n  onPartLineGraphics?: ExportPartLinesFunction;\n  /** Max distance from a face to the original geometry, see [StrokeOptions]($core-geometry).\n   * If not supplied, defaults to zero and angleTol will control the quality of the resulting mesh.\n   */\n  chordTol?: number;\n  /** Max angle difference in radians for approximated face, see [StrokeOptions]($core-geometry).\n   * If not supplied, defaults to PI/12 (15 degrees).\n   */\n  angleTol?: number;\n  /** Max length of any edge in generated faces, see [StrokeOptions]($core-geometry)\n   * If not supplied, there is no maximum length of an edge. Supplying this value can greatly increase the\n   * size of the resulting geometry, and should only be done in cases where necessary (if you don't know\n   * that it's necessary, it's almost certainly not!)\n   */\n  maxEdgeLength?: number;\n  /** The longest dimension of a line style's largest component must be at least this size in order for\n   * exportGraphics to evaluate and generate its graphics. If undefined, this defaults to 0.1.\n   * Line styles can evaluate to 3D geometry that clients expect to receive from exportGraphics, but they\n   * can also generate gigabytes of mesh data when line styles with small components are applied to long\n   * line strings.\n   */\n  minLineStyleComponentSize?: number;\n  /** Max distance between mesh vertices for them to be collapsed.\n   * Meshes stored in GeometryStreams are unaffected by StrokeOptions settings. If decimationTol is undefined,\n   * they are output from exportGraphics without any reduction in quality and can be too detailed for\n   * some uses. However, decimation is a destructive operation that can introduce gaps and other visual\n   * anomalies so it is important to choose an appropriate setting for your use case.\n   */\n  decimationTol?: number;\n  /** BRep features with bounding boxes smaller than this size will not generate graphics.\n   * This option can be used to ignore expensive details from [BRepEntity.DataProps]($core-common)\n   * like screws and screw holes.\n   */\n  minBRepFeatureSize?: number;\n}\n\n/** Provides utility functions for working with data generated by [IModelDb.exportGraphics]($core-backend)\n * @public\n */\nexport namespace ExportGraphics {\n  /** Test if ExportPartDisplayInfos have exactly the same values.\n   * @public\n   */\n  export function arePartDisplayInfosEqual(lhs: ExportPartDisplayInfo, rhs: ExportPartDisplayInfo): boolean {\n    if (lhs.categoryId !== rhs.categoryId)\n      return false;\n    if (lhs.subCategoryId !== rhs.subCategoryId)\n      return false;\n    if (lhs.materialId !== rhs.materialId)\n      return false;\n    if (lhs.elmTransparency !== rhs.elmTransparency)\n      return false;\n    if (lhs.lineColor !== rhs.lineColor)\n      return false;\n    return true;\n  }\n\n  /**\n   * Convert an ExportGraphicsMesh to an IndexedPolyface usable by the geometry API.\n   * @note The resulting IndexedPolyface may have duplicate points, normals and params. If problematic, call [PolyfaceData.compress]($core-geometry)\n   * @public\n   */\n  export function convertToIndexedPolyface(mesh: ExportGraphicsMesh): IndexedPolyface {\n    const polyface = IndexedPolyface.create(true, true, false, mesh.isTwoSided);\n\n    const p: Float64Array = mesh.points;\n    for (let i = 0; i < p.length; i += 3)\n      polyface.data.point.pushXYZ(p[i], p[i + 1], p[i + 2]);\n\n    const n: Float32Array = mesh.normals;\n    assert(undefined !== polyface.data.normal);\n    for (let i = 0; i < n.length; i += 3)\n      polyface.data.normal.pushXYZ(n[i], n[i + 1], n[i + 2]);\n\n    const uv: Float32Array = mesh.params;\n    assert(undefined !== polyface.data.param);\n    for (let i = 0; i < uv.length; i += 2)\n      polyface.data.param.pushXY(uv[i], uv[i + 1]);\n\n    const indices = mesh.indices;\n    const addIndex = (idx: number) => {\n      polyface.addPointIndex(idx, true);\n      polyface.addNormalIndex(idx);\n      polyface.addParamIndex(idx);\n    };\n    for (let i = 0; i < indices.length; i += 3) {\n      addIndex(indices[i]);\n      addIndex(indices[i + 1]);\n      addIndex(indices[i + 2]);\n      polyface.terminateFacet(false);\n    }\n\n    return polyface;\n  }\n}\n/**\n * * Iterator to walk the facets of an ExportGraphicsMesh and present them to the world as if visiting a Polyface.\n * * Because the ExportGraphicsMesh has limited data:\n *   * There is no auxData in this visitor.\n *   * There is no color in this visitor.\n *   * All edgeVisible are true.\n * @public\n */\nexport class ExportGraphicsMeshVisitor extends PolyfaceData implements PolyfaceVisitor {\n  private _currentFacetIndex: number;\n  private _nextFacetIndex: number;\n  private _numWrap: number;\n  private _polyface: ExportGraphicsMesh;\n  // to be called from static factory method that validates the polyface ...\n  private constructor(facets: ExportGraphicsMesh, numWrap: number) {\n    super(facets.normals.length > 0, facets.params.length > 0, false, facets.isTwoSided);\n    this._polyface = facets;\n    this._numWrap = numWrap;\n\n    this._nextFacetIndex = 0;\n    this._currentFacetIndex = -1;\n    this.twoSided = facets.isTwoSided;\n    this.reset();\n  }\n  /** 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\n   * Typical wrap counts are:\n   * * 0 -- leave the point arrays with \"missing final edge\"\n   * * 1 -- add point 0 as closure point\n   * * 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.\n   */\n  public static create(polyface: ExportGraphicsMesh, numWrap: number): ExportGraphicsMeshVisitor {\n    return new ExportGraphicsMeshVisitor(polyface, numWrap);\n  }\n  /** Reset the iterator to start at the first facet of the polyface. */\n  public reset(): void {\n    this.moveToReadIndex(0);\n    this._nextFacetIndex = 0; // so immediate moveToNextFacet stays here.\n  }\n  /** Select a facet by simple index. */\n  public moveToReadIndex(facetIndex: number): boolean {\n    if (facetIndex < 0 || 2 + facetIndex * 3 >= this._polyface.indices.length)\n      return false;\n    this._currentFacetIndex = facetIndex;\n    this._nextFacetIndex = facetIndex + 1;\n    this.point.length = 0;\n    const points = this.point;\n    points.length = 0;\n    this.pointIndex.length = 0;\n    this.point.length = 0;\n    this.edgeVisible.length = 0;\n    const sourcePoints = this._polyface.points;\n    const indices = this._polyface.indices;\n    const i0 = 3 * facetIndex;\n    for (let i = i0; i < i0 + 3; i++) {\n      const k = 3 * indices[i];\n      this.pointIndex.push(indices[i]);\n      this.point.pushXYZ(sourcePoints[k], sourcePoints[k + 1], sourcePoints[k + 2]);\n      this.edgeVisible.push(true);\n    }\n    for (let i = 0; i < this._numWrap; i++) {\n      this.point.pushFromGrowableXYZArray(this.point, i);\n    }\n\n    const sourceParams = this._polyface.params;\n    if (sourceParams.length > 0 && this.paramIndex && this.param) {\n      this.paramIndex.length = 0;\n      this.param.length = 0;\n      for (let i = i0; i < i0 + 3; i++) {\n        const k = 2 * indices[i];\n        this.paramIndex.push(indices[i]);\n        this.param.pushXY(sourceParams[k], sourceParams[k + 1]);\n      }\n      for (let i = 0; i < this._numWrap; i++) {\n        this.param.pushFromGrowableXYArray(this.param, i);\n      }\n    }\n\n    const sourceNormals = this._polyface.normals;\n    if (sourceNormals.length > 0 && this.normalIndex && this.normal) {\n      this.normalIndex.length = 0;\n      this.normal.length = 0;\n      for (let i = i0; i < i0 + 3; i++) {\n        const k = 3 * indices[i];\n        this.normalIndex.push(indices[i]);\n        this.normal.pushXYZ(sourceNormals[k], sourceNormals[k + 1], sourceNormals[k + 2]);\n      }\n      for (let i = 0; i < this._numWrap; i++) {\n        this.normal.pushFromGrowableXYZArray(this.normal, i);\n      }\n    }\n    return true;\n  }\n  public moveToNextFacet(): boolean {\n    return this.moveToReadIndex(this._nextFacetIndex);\n  }\n  /** Set the number of vertices to replicate in visitor arrays. */\n  public setNumWrap(numWrap: number): void { this._numWrap = numWrap; }\n\n  /** Return the index (in the client polyface) of the current facet */\n  public currentReadIndex(): number { return this._currentFacetIndex; }\n  /** Return the point index of vertex i within the currently loaded facet */\n  public clientPointIndex(i: number): number { return this.pointIndex[i]; }\n  /** Return the param index of vertex i within the currently loaded facet.\n   * Use the artificial paramIndex, which matches pointIndex.\n   */\n  public clientParamIndex(i: number): number { return this.paramIndex ? this.paramIndex[i] : -1; }\n  /** Return the normal index of vertex i within the currently loaded facet.\n   * Use the artificial paramIndex, which matches pointIndex.\n   */\n  public clientNormalIndex(i: number): number { return this.normalIndex ? this.normalIndex[i] : -1; }\n  /** Return the color index of vertex i within the currently loaded facet */\n  public clientColorIndex(_i: number): number { return 1; }\n  /** Return the aux data index of vertex i within the currently loaded facet */\n  public clientAuxIndex(_i: number): number { return -1; }\n\n  /** return the client polyface */\n  public clientPolyface(): Polyface { return (undefined as unknown) as Polyface; }\n  /** clear the contents of all arrays.  Use this along with transferDataFrom methods to build up new facets */\n  public clearArrays(): void {\n    if (this.point !== undefined)\n      this.point.length = 0;\n    if (this.param !== undefined)\n      this.param.length = 0;\n    if (this.normal !== undefined)\n      this.normal.length = 0;\n    // ignore color and aux -- they never exist.\n  }\n  /** transfer interpolated data from the other visitor.\n   * * all data values are interpolated at `fraction` between `other` values at index0 and index1.\n   */\n  public pushInterpolatedDataFrom(other: PolyfaceVisitor, index0: number, fraction: number, index1: number): void {\n    this.point.pushInterpolatedFromGrowableXYZArray(other.point, index0, fraction, index1);\n    if (this.param && other.param && index0 < other.param.length && index1 < other.param.length)\n      this.param.pushInterpolatedFromGrowableXYArray(other.param, index0, fraction, index1);\n    if (this.normal && other.normal && index0 < other.normal.length && index1 < other.normal.length)\n      this.normal.pushInterpolatedFromGrowableXYZArray(other.normal, index0, fraction, index1);\n  }\n  /** transfer data from a specified index of the other visitor as new data in this visitor. */\n  public pushDataFrom(other: PolyfaceVisitor, index: number): void {\n    this.point.pushFromGrowableXYZArray(other.point, index);\n    if (this.color && other.color && index < other.color.length)\n      this.color.push(other.color[index]);\n    if (this.param && other.param && index < other.param.length)\n      this.param.pushFromGrowableXYArray(other.param, index);\n    if (this.normal && other.normal && index < other.normal.length)\n      this.normal.pushFromGrowableXYZArray(other.normal, index);\n  }\n\n}\n"]}