@itwin/core-geometry 5.0.0-dev.9 → 5.0.0-dev.90

package/lib/esm/polyface/PolyfaceBuilder.js

@@ -2,11 +2,14 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Polyface
+ */
+import { Arc3d } from "../curve/Arc3d";
 import { ConstructCurveBetweenCurves } from "../curve/ConstructCurveBetweenCurves";
 import { CurveChain, CurveCollection } from "../curve/CurveCollection";
-import { CurveFactory } from "../curve/CurveFactory";
+import { CurveFactory, MiteredSweepOutputSelect } from "../curve/CurveFactory";
 import { CurvePrimitive } from "../curve/CurvePrimitive";
-import { GeometryQuery } from "../curve/GeometryQuery";
 import { LineString3d } from "../curve/LineString3d";
 import { ParityRegion } from "../curve/ParityRegion";
 import { CylindricalRangeQuery } from "../curve/Query/CylindricalRange";
@@ -20,7 +23,6 @@ import { NullGeometryHandler } from "../geometry3d/GeometryHandler";
 import { GrowableFloat64Array } from "../geometry3d/GrowableFloat64Array";
 import { GrowableXYArray } from "../geometry3d/GrowableXYArray";
 import { GrowableXYZArray } from "../geometry3d/GrowableXYZArray";
-import { IndexedXYZCollection } from "../geometry3d/IndexedXYZCollection";
 import { Matrix3d } from "../geometry3d/Matrix3d";
 import { Plane3dByOriginAndVectors } from "../geometry3d/Plane3dByOriginAndVectors";
 import { Point2d } from "../geometry3d/Point2dVector2d";
@@ -48,6 +50,13 @@ import { PolyfaceQuery } from "./PolyfaceQuery";
  * * Indices are set up even later.
  */
 class FacetSector {
+    xyz;
+    xyzIndex;
+    normal;
+    normalIndex;
+    uv;
+    uvIndex;
+    sectionDerivative;
     constructor(needNormal = false, needUV = false, needSectionDerivative = false) {
         this.xyz = Point3d.create();
         this.normalIndex = -1;
@@ -105,6 +114,7 @@ class FacetSector {
         if (Math.abs(uvw.z) < tol)
             uvw.z = 0.0;
     }
+    static _edgeVector = Vector3d.create();
     /**
      * Given two sectors with xyz and sectionDerivative (u derivative), use the edge from A to B as v direction
      * in-surface derivative. Compute cross products (and normalize).
@@ -126,7 +136,6 @@ class FacetSector {
         }
     }
 }
-FacetSector._edgeVector = Vector3d.create();
 /**
  * * Simple construction for strongly typed GeometryQuery objects:
  *
@@ -172,10 +181,14 @@ FacetSector._edgeVector = Vector3d.create();
  * @public
  */
 export class PolyfaceBuilder extends NullGeometryHandler {
+    _polyface;
+    _options;
     /** Return (pointer to) the `StrokeOptions` in use by the builder. */
     get options() {
         return this._options;
     }
+    /** State data that affects the current construction. **/
+    _reversed;
     /** Ask if this builder is reversing vertex order as loops are received. */
     get reversedFlag() {
         return this._reversed;
@@ -319,24 +332,13 @@ export class PolyfaceBuilder extends NullGeometryHandler {
     addPoint(xyz) {
         return this._polyface.addPoint(xyz);
     }
-    /**
-     * Add a point to the polyface.
-     * @deprecated in 3.x. Use addPoint instead.
-     */
-    findOrAddPoint(xyz) {
-        return this.addPoint(xyz);
-    }
     /** Add a uv parameter to the polyface. */
     addParamXY(x, y) {
         return this._polyface.addParamUV(x, y);
     }
-    /**
-     * Add a uv parameter to the polyface.
-     * @deprecated in 3.x. Use addParamXY instead.
-     */
-    findOrAddParamXY(x, y) {
-        return this.addParamXY(x, y);
-    }
+    static _workPointFindOrAddA = Point3d.create();
+    static _workVectorFindOrAdd = Vector3d.create();
+    static _workUVFindOrAdd = Point2d.create();
     /**
      * Add a point to the polyface. The implementation is free to either create a new point or return the index of a
      * prior point with the same coordinates.
@@ -405,13 +407,6 @@ export class PolyfaceBuilder extends NullGeometryHandler {
             return this._polyface.addParam(q);
         return undefined;
     }
-    /**
-     * Add a uv parameter to the polyface.
-     * @deprecated in 3.x. Use addParamInGrowableXYArray instead.
-     */
-    findOrAddParamInGrowableXYArray(data, index) {
-        return this.addParamInGrowableXYArray(data, index);
-    }
     /**
      * Add a uv parameter to the polyface, taking `u` from `ls.fractions` and `v` from input. The implementation is
      * free to either create a new param or return the index of a prior param with the same coordinates.
@@ -452,13 +447,6 @@ export class PolyfaceBuilder extends NullGeometryHandler {
     addPointXYZ(x, y, z) {
         return this._polyface.addPointXYZ(x, y, z);
     }
-    /**
-     * Add a point to the polyface.
-     * @deprecated in 3.x. Use addPointXYZ instead.
-     */
-    findOrAddPointXYZ(x, y, z) {
-        return this.addPointXYZ(x, y, z);
-    }
     /** Returns a transform who can be applied to points on a triangular facet in order to obtain UV parameters. */
     getUVTransformForTriangleFacet(pointA, pointB, pointC) {
         const vectorAB = pointA.vectorTo(pointB);
@@ -1827,56 +1815,39 @@ export class PolyfaceBuilder extends NullGeometryHandler {
         const context = GreedyTriangulationBetweenLineStrings.createContext();
         context.emitTriangles(resolveToIndexedXYZCollectionOrCarrier(pointsA), resolveToIndexedXYZCollectionOrCarrier(pointsB), (triangle) => { this.addTriangleFacet(triangle.points); });
     }
-    addMiteredPipesFromPoints(centerline, sectionData, numFacetAround = 12) {
-        const sections = CurveFactory.createMiteredPipeSections(centerline, sectionData);
-        const pointA0 = Point3d.create();
-        const pointA1 = Point3d.create();
-        const pointB0 = Point3d.create();
-        const pointB1 = Point3d.create();
-        if (numFacetAround < 3)
-            numFacetAround = 3;
-        const df = 1.0 / numFacetAround;
-        for (let i = 1; i < sections.length; i++) {
-            const arcA = sections[i - 1];
-            const arcB = sections[i];
-            arcA.fractionToPoint(0.0, pointA0);
-            arcB.fractionToPoint(0.0, pointB0);
-            for (let k = 1; k <= numFacetAround; k++, pointA0.setFromPoint3d(pointA1), pointB0.setFromPoint3d(pointB1)) {
-                const f = k * df;
-                arcA.fractionToPoint(f, pointA1);
-                arcB.fractionToPoint(f, pointB1);
-                this.addQuadFacet([pointA0, pointB0, pointB1, pointA1]);
-            }
-        }
-    }
     /**
      * Add quad facets along a mitered pipe that follows a centerline curve.
+     * * At the end of each pipe segment, the pipe is mitered by the plane that bisects the angle between successive
+     * centerline segments.
      * * Circular or elliptical pipe cross sections can be specified by supplying either a radius, a pair of semi-axis
-     * lengths, or a full Arc3d:
-     *    * For semi-axis length input, x corresponds to an ellipse local axis nominally situated parallel to the xy-plane.
-     *    * For Arc3d input, the center is translated to the centerline start point to act as initial cross section.
-     * @param centerline centerline of pipe. If curved, it will be stroked using the builder's StrokeOptions.
-     * @param sectionData circle radius, ellipse semi-axis lengths, or full Arc3d.
+     * lengths, or an Arc3d:
+     *    * For semi-axis length input, x and y correspond to ellipse local axes perpendicular to each other and to the
+     * start tangent.
+     *    * For Arc3d input, the center is translated to the centerline start point. For best results, ensure this arc
+     * is perpendicular to the centerline start tangent.
+     * * This function internally calls [[CurveFactory.createMiteredSweepSections]], passing in the `startTangent`
+     * option to preserve the rotation of Arc3d-type `sectionData`.
+     * @param centerline centerline of pipe. If curved, it will be stroked using the builder's StrokeOptions, otherwise
+     * for best results, ensure no successive duplicate points with e.g., [[GrowableXYZArray.createCompressed]].
+     * @param sectionData circle radius, ellipse semi-axis lengths, or Arc3d.
      * @param numFacetAround how many equal parameter-space chords around each section.
+     * @param capped if `true`, add a cap at each end of the pipe; defaults to `false`.
      */
-    addMiteredPipes(centerline, sectionData, numFacetAround = 12) {
-        if (Array.isArray(centerline)) {
-            this.addMiteredPipesFromPoints(new Point3dArrayCarrier(centerline), sectionData, numFacetAround);
-        }
-        else if (centerline instanceof GrowableXYZArray) {
-            this.addMiteredPipesFromPoints(centerline, sectionData, numFacetAround);
-        }
-        else if (centerline instanceof IndexedXYZCollection) {
-            this.addMiteredPipesFromPoints(centerline, sectionData, numFacetAround);
-        }
-        else if (centerline instanceof LineString3d) {
-            this.addMiteredPipesFromPoints(centerline.packedPoints, sectionData, numFacetAround);
-        }
-        else if (centerline instanceof GeometryQuery) {
-            const linestring = LineString3d.create();
-            centerline.emitStrokes(linestring, this._options);
-            this.addMiteredPipesFromPoints(linestring.packedPoints, sectionData, numFacetAround);
-        }
+    addMiteredPipes(centerline, sectionData, numFacetAround = 12, capped = false) {
+        const arc = CurveFactory.createArcFromSectionData(centerline, sectionData);
+        if (!arc)
+            return;
+        if (numFacetAround < 3)
+            numFacetAround = 3;
+        const section = LineString3d.create();
+        section.appendFractionalStrokePoints(arc, numFacetAround, 0.0, 1.0, true);
+        const strokeOptions = this._options.clone();
+        const outputSelect = MiteredSweepOutputSelect.AlsoMesh;
+        const startTangent = sectionData instanceof Arc3d ? arc.binormalVector() : undefined; // preserve arc orientation
+        const options = { strokeOptions, capped, outputSelect, startTangent };
+        const sections = CurveFactory.createMiteredSweepSections(centerline, section, options);
+        if (sections && sections.mesh)
+            this.addIndexedPolyface(sections.mesh);
     }
     /** Return the polyface index array indices corresponding to the given edge, or `undefined` if error. */
     getEdgeIndices(edge) {
@@ -1986,9 +1957,6 @@ export class PolyfaceBuilder extends NullGeometryHandler {
         return isSimpleSweep;
     }
 }
-PolyfaceBuilder._workPointFindOrAddA = Point3d.create();
-PolyfaceBuilder._workVectorFindOrAdd = Vector3d.create();
-PolyfaceBuilder._workUVFindOrAdd = Point2d.create();
 function resolveToIndexedXYZCollectionOrCarrier(points) {
     if (Array.isArray(points))
         return new Point3dArrayCarrier(points);