@itwin/core-geometry 5.0.0-dev.16 → 5.0.0-dev.20

package/lib/esm/curve/CurveFactory.d.ts

@@ -61,21 +61,13 @@ export interface MiteredSweepOptions {
     wrapIfPhysicallyClosed?: boolean;
     /** Whether to output sections only, or sections plus optional geometry constructed from them. Default value is `MiteredSweepOutputSelect.Sections`. */
     outputSelect?: MiteredSweepOutputSelect;
-    /** How to stroke the ruled sweep if outputting a mesh. If undefined, default stroke options are used. */
+    /** How to stroke smooth input curves and the ruled sweep (if outputting a mesh). If undefined, default stroke options are used. */
     strokeOptions?: StrokeOptions;
     /** Whether to cap the ruled sweep if outputting a ruled sweep or mesh. Default value is `false`. */
     capped?: boolean;
-    /**
-     * If the centerline is not physically closed, the first section's normal is aligned to this vector (typically points
-     * toward the swept geometry). If the centerline is physically closed, the first section's normal is aligned to this
-     * vector if and only if endTangent is provided and is equal to startTangent.
-     */
+    /** The first section's normal is aligned to this vector, typically the start tangent of the smooth curve stroked for the centerline. */
     startTangent?: Vector3d;
-    /**
-     * If the centerline is not physically closed, the last section's normal is aligned to this vector (typically points
-     * away from the swept geometry). If the centerline is physically closed, the last section's normal is aligned to this
-     * vector if and only if startTangent is provided and is equal to endTangent.
-     */
+    /** The last section's normal is aligned to this vector, typically the end tangent of the smooth curve stroked for the centerline. */
     endTangent?: Vector3d;
 }
 /**
@@ -152,27 +144,42 @@ export declare class CurveFactory {
      * @param sectionData circle radius, ellipse semi-axis lengths, or full Arc3d (if not full, function makes it full).
      */
     static createMiteredPipeSections(centerline: IndexedXYZCollection, sectionData: number | XAndY | Arc3d): Arc3d[];
+    /** For a smooth curve, stroke and return unnormalized start/end tangents. */
+    private static strokeSmoothCurve;
     /**
-     * Sweep the initialSection along each segment of the centerLine until it hits the bisector plane at the next vertex.
-     * * The caller should place the initialSection on a plane perpendicular to the first edge.
-     *   * This plane is commonly (but not necessarily) through the start point itself.
-     *   * If the initialSection is not "on a perpendicular plane", the output geometry will still be flattened onto the
-     *     various planes.
-     * * In the "open path" case (i.e when `wrapIfPhysicallyClosed` is false or the path does not have matched first and
-     *   last points), the first/last output plane will be at the start/end of the first/last edge and on a perpendicular
-     *   plane.
-     * * In the "closed path" case, if start/edn tangents are not provided in the `options`, then the output plane for the
-     *   first and last point is the bisector of the start and end planes from the "open path" case, and the first/last
-     *   section geometry may be different from `initialSection`.
-     * * The centerline path does NOT have to be planar, however twisting effects effects will appear in the various bisector
-     *   planes.
-     * @param centerline sweep path, e.g., as stroked from a smooth centerline curve.
+     * Align two bisector plane normals to given smooth rail tangents or optional overrides.
+     * * Optionally average the normals for physically closed rail.
+     */
+    private static alignFirstAndLastBisectorPlanes;
+    /** Reverse a closed curve or region if necessary so that its orientation is CCW with respect to the plane normal. */
+    private static alignClosedCurveToPlane;
+    /**
+     * Projection to target plane, constructing sweep direction from two given planes.
+     * * If successful, push the target plane and swept section to the output arrays and return the swept section.
+     * * If unsuccessful, leave the output arrays alone and return the input section.
+     */
+    private static doSweepToPlane;
+    /**
+     * Sweep the `initialSection` along each segment of the (stroked) `centerline` until it hits the bisector plane at
+     * the next vertex.
+     * * For best results, the caller should place `initialSection` in a plane perpendicular to the `centerline`
+     * start tangent.
+     *   * This plane is commonly (but not necessarily) through the centerline start point itself.
+     *   * To compute the sections, `initialSection` is projected in the direction of the centerline start tangent onto
+     * the first bisector plane at the centerline start. The result of this projection will be likewise projected onto
+     * the second plane, and so on in sequence.
+     * * By default, the first/last bisector plane normals are set to the centerline start/end tangents. The caller can
+     * override these with tangents supplied in `options`. If the centerline is physically closed and
+     * `options.wrapIfPhysicallyClosed` is true, the first and last plane normals are averaged and equated.
+     * * The centerline path does NOT have to be planar, however non-planarity will result in twisting of the sections
+     * in the bisector planes.
+     * @param centerline sweep path. Will be stroked if smooth.
      * @param initialSection profile curve to be swept. As noted above, this should be on a plane perpendicular to the
-     * first segment of the centerline.
+     * centerline start tangent.
      * @param options options for computation and output.
-     * @return array of sections, starting with `initialSection` projected along the first edge to the first plane.
+     * @return array of sections, formed from projecting `initialSection` successively onto the bisector planes.
      */
-    static createMiteredSweepSections(centerline: IndexedXYZCollection | Point3d[], initialSection: AnyCurve, options: MiteredSweepOptions): SectionSequenceWithPlanes | undefined;
+    static createMiteredSweepSections(centerline: IndexedXYZCollection | Point3d[] | CurvePrimitive | CurveChain, initialSection: AnyCurve, options: MiteredSweepOptions): SectionSequenceWithPlanes | undefined;
     /**
      * Create a circular arc from start point, tangent at start, radius, optional plane normal, arc sweep.
      * * The vector from start point to center is in the direction of upVector crossed with tangentA.

package/lib/esm/curve/CurveFactory.d.ts.map

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

package/lib/esm/curve/CurveFactory.js

@@ -5,7 +5,6 @@
 /** @packageDocumentation
  * @module Curve
  */
-// import { Geometry, Angle, AngleSweep } from "../Geometry";
 import { AxisIndex, AxisOrder, Geometry } from "../Geometry";
 import { Angle } from "../geometry3d/Angle";
 import { AngleSweep } from "../geometry3d/AngleSweep";
@@ -30,6 +29,7 @@ import { LineSegment3d } from "./LineSegment3d";
 import { LineString3d } from "./LineString3d";
 import { Loop } from "./Loop";
 import { Path } from "./Path";
+import { RegionOps } from "./RegionOps";
 import { IntegratedSpiral3d } from "./spiral/IntegratedSpiral3d";
 /**
  * Enumeration of geometric output for [CurveFactory.createMiteredSweepSections].
@@ -44,6 +44,7 @@ export var MiteredSweepOutputSelect;
     /** Output planes and sections, as well as the assembled ruled sweep and its stroked mesh. */
     MiteredSweepOutputSelect[MiteredSweepOutputSelect["AlsoMesh"] = 2] = "AlsoMesh";
 })(MiteredSweepOutputSelect || (MiteredSweepOutputSelect = {}));
+;
 /**
  * The `CurveFactory` class contains methods for specialized curve constructions.
  * @public
@@ -349,75 +350,132 @@ export class CurveFactory {
         }
         return arcs;
     }
+    /** For a smooth curve, stroke and return unnormalized start/end tangents. */
+    static strokeSmoothCurve(curve, options) {
+        let startTangent, endTangent;
+        if (curve instanceof CurvePrimitive) {
+            startTangent = curve.fractionToPointAndDerivative(0.0).direction;
+            endTangent = curve.fractionToPointAndDerivative(1.0).direction;
+            const strokes = LineString3d.create();
+            curve.emitStrokes(strokes, options);
+            curve = strokes.packedPoints;
+        }
+        else if (curve instanceof CurveChain) {
+            startTangent = curve.startPointAndDerivative()?.direction;
+            endTangent = curve.endPointAndDerivative()?.direction;
+            const strokes = curve.getPackedStrokes(options);
+            if (!strokes)
+                return undefined;
+            curve = strokes;
+        }
+        else if (Array.isArray(curve))
+            curve = new Point3dArrayCarrier(curve);
+        return { strokes: curve, startTangent, endTangent };
+    }
     /**
-     * Sweep the initialSection along each segment of the centerLine until it hits the bisector plane at the next vertex.
-     * * The caller should place the initialSection on a plane perpendicular to the first edge.
-     *   * This plane is commonly (but not necessarily) through the start point itself.
-     *   * If the initialSection is not "on a perpendicular plane", the output geometry will still be flattened onto the
-     *     various planes.
-     * * In the "open path" case (i.e when `wrapIfPhysicallyClosed` is false or the path does not have matched first and
-     *   last points), the first/last output plane will be at the start/end of the first/last edge and on a perpendicular
-     *   plane.
-     * * In the "closed path" case, if start/edn tangents are not provided in the `options`, then the output plane for the
-     *   first and last point is the bisector of the start and end planes from the "open path" case, and the first/last
-     *   section geometry may be different from `initialSection`.
-     * * The centerline path does NOT have to be planar, however twisting effects effects will appear in the various bisector
-     *   planes.
-     * @param centerline sweep path, e.g., as stroked from a smooth centerline curve.
+     * Align two bisector plane normals to given smooth rail tangents or optional overrides.
+     * * Optionally average the normals for physically closed rail.
+     */
+    static alignFirstAndLastBisectorPlanes(firstPlane, lastPlane, smoothRailData, options) {
+        const normal0 = options?.startTangent ?? (smoothRailData?.startTangent ?? firstPlane.getNormalRef());
+        const normal1 = options?.endTangent ?? (smoothRailData?.endTangent ?? lastPlane.getNormalRef());
+        if (options?.wrapIfPhysicallyClosed && firstPlane.getOriginRef().isAlmostEqual(lastPlane.getOriginRef())) {
+            const avgNormal = normal0.plus(normal1);
+            if (avgNormal.tryNormalizeInPlace()) { // ignore cusp at seam
+                firstPlane.getNormalRef().setFrom(avgNormal);
+                lastPlane.getNormalRef().setFrom(avgNormal);
+                return;
+            }
+        }
+        if (normal0.tryNormalizeInPlace())
+            firstPlane.getNormalRef().setFrom(normal0);
+        if (normal1.tryNormalizeInPlace())
+            lastPlane.getNormalRef().setFrom(normal1);
+    }
+    /** Reverse a closed curve or region if necessary so that its orientation is CCW with respect to the plane normal. */
+    static alignClosedCurveToPlane(curve, planeNormal) {
+        let closedCurve;
+        if (curve instanceof CurvePrimitive) {
+            if (curve.startPoint().isAlmostEqual(curve.endPoint()))
+                closedCurve = Loop.create(curve);
+        }
+        else if (curve.isAnyRegion())
+            closedCurve = curve;
+        if (closedCurve) {
+            // The alignment condition is equivalent to positive projected curve area computed wrt to the plane normal.
+            const toLocal = Matrix3d.createRigidHeadsUp(planeNormal).transpose();
+            const projection = closedCurve.cloneTransformed(Transform.createOriginAndMatrix(undefined, toLocal));
+            if (projection) { // now we can ignore z-coords
+                const areaXY = RegionOps.computeXYArea(projection);
+                if (areaXY && areaXY < 0)
+                    curve.reverseInPlace();
+            }
+        }
+    }
+    /**
+     * Projection to target plane, constructing sweep direction from two given planes.
+     * * If successful, push the target plane and swept section to the output arrays and return the swept section.
+     * * If unsuccessful, leave the output arrays alone and return the input section.
+     */
+    static doSweepToPlane(output, edgePlane0, edgePlane1, targetPlane, section) {
+        const sweepVector = Vector3d.createStartEnd(edgePlane0.getOriginRef(), edgePlane1.getOriginRef());
+        const transform = Transform.createFlattenAlongVectorToPlane(sweepVector, targetPlane.getOriginRef(), targetPlane.getNormalRef());
+        if (transform === undefined)
+            return section;
+        const transformedSection = section.cloneTransformed(transform);
+        if (transformedSection === undefined)
+            return section;
+        output.planes.push(targetPlane);
+        output.sections.push(transformedSection);
+        return transformedSection;
+    }
+    /**
+     * Sweep the `initialSection` along each segment of the (stroked) `centerline` until it hits the bisector plane at
+     * the next vertex.
+     * * For best results, the caller should place `initialSection` in a plane perpendicular to the `centerline`
+     * start tangent.
+     *   * This plane is commonly (but not necessarily) through the centerline start point itself.
+     *   * To compute the sections, `initialSection` is projected in the direction of the centerline start tangent onto
+     * the first bisector plane at the centerline start. The result of this projection will be likewise projected onto
+     * the second plane, and so on in sequence.
+     * * By default, the first/last bisector plane normals are set to the centerline start/end tangents. The caller can
+     * override these with tangents supplied in `options`. If the centerline is physically closed and
+     * `options.wrapIfPhysicallyClosed` is true, the first and last plane normals are averaged and equated.
+     * * The centerline path does NOT have to be planar, however non-planarity will result in twisting of the sections
+     * in the bisector planes.
+     * @param centerline sweep path. Will be stroked if smooth.
      * @param initialSection profile curve to be swept. As noted above, this should be on a plane perpendicular to the
-     * first segment of the centerline.
+     * centerline start tangent.
      * @param options options for computation and output.
-     * @return array of sections, starting with `initialSection` projected along the first edge to the first plane.
+     * @return array of sections, formed from projecting `initialSection` successively onto the bisector planes.
      */
     static createMiteredSweepSections(centerline, initialSection, options) {
+        const rail = this.strokeSmoothCurve(centerline, options.strokeOptions);
+        if (!rail)
+            return undefined;
+        const planes = PolylineOps.createBisectorPlanesForDistinctPoints(rail.strokes);
+        if (!planes || planes.length < 2)
+            return undefined;
+        this.alignFirstAndLastBisectorPlanes(planes[0], planes[planes.length - 1], rail, options);
+        // RuledSweep facet construction assumes the contours are oriented CCW with respect to the sweep direction so that
+        // facet normals point outward. We only have to align the first contour; the rest will inherit its orientation.
+        this.alignClosedCurveToPlane(initialSection, planes[0].getNormalRef());
         const sectionData = { sections: [], planes: [] };
-        const planes = PolylineOps.createBisectorPlanesForDistinctPoints(centerline, options.wrapIfPhysicallyClosed);
-        // apply start/end tangent options
-        if (planes !== undefined && planes.length > 1) {
-            const firstPlane = planes[0];
-            const lastPlane = planes[planes.length - 1];
-            const startTang = options.startTangent;
-            const endTang = options.endTangent;
-            if (!firstPlane.getOriginRef().isAlmostEqual(lastPlane.getOriginRef()) ||
-                (startTang && endTang && startTang.isAlmostEqual(endTang, 0.0))) {
-                if (startTang?.tryNormalizeInPlace())
-                    firstPlane.getNormalRef().setFrom(startTang);
-                if (endTang?.tryNormalizeInPlace())
-                    lastPlane.getNormalRef().setFrom(endTang);
-            }
-            // Projection to target plane, constructing sweep direction from two given planes.
-            // If successful, push the target plane and swept section to the output arrays and return the swept section.
-            // If unsuccessful, leave the output arrays alone and return the input section.
-            const doSweepToPlane = function (edgePlane0, edgePlane1, targetPlane, section) {
-                const sweepVector = Vector3d.createStartEnd(edgePlane0.getOriginRef(), edgePlane1.getOriginRef());
-                const transform = Transform.createFlattenAlongVectorToPlane(sweepVector, targetPlane.getOriginRef(), targetPlane.getNormalRef());
-                if (transform === undefined)
-                    return section;
-                const transformedSection = section.cloneTransformed(transform);
-                if (transformedSection === undefined)
-                    return section;
-                sectionData.planes.push(targetPlane);
-                sectionData.sections.push(transformedSection);
-                return transformedSection;
-            };
-            let currentSection = doSweepToPlane(planes[0], planes[1], planes[0], initialSection);
-            for (let i = 1; i < planes.length; i++) {
-                currentSection = doSweepToPlane(planes[i - 1], planes[i], planes[i], currentSection);
-            }
-            if (options.outputSelect) {
-                const ruledSweep = RuledSweep.create(sectionData.sections, options.capped ?? false);
-                if (ruledSweep) {
-                    sectionData.ruledSweep = ruledSweep;
-                    if (MiteredSweepOutputSelect.AlsoMesh === options.outputSelect) {
-                        const builder = PolyfaceBuilder.create(options.strokeOptions);
-                        builder.addRuledSweep(ruledSweep);
-                        sectionData.mesh = builder.claimPolyface();
-                    }
+        let currentSection = this.doSweepToPlane(sectionData, planes[0], planes[1], planes[0], initialSection);
+        for (let i = 1; i < planes.length; i++)
+            currentSection = this.doSweepToPlane(sectionData, planes[i - 1], planes[i], planes[i], currentSection);
+        if (options.outputSelect) {
+            const ruledSweep = RuledSweep.create(sectionData.sections, options.capped ?? false);
+            if (ruledSweep) {
+                sectionData.ruledSweep = ruledSweep;
+                if (MiteredSweepOutputSelect.AlsoMesh === options.outputSelect) {
+                    const builder = PolyfaceBuilder.create(options.strokeOptions);
+                    builder.addRuledSweep(ruledSweep);
+                    sectionData.mesh = builder.claimPolyface();
                 }
             }
-            return sectionData;
         }
-        return undefined;
+        return sectionData;
     }
     /**
      * Create a circular arc from start point, tangent at start, radius, optional plane normal, arc sweep.