@itwin/core-geometry 5.5.0-dev.4 → 5.5.0-dev.6

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

@@ -1,6 +1,3 @@
-/** @packageDocumentation
- * @module Curve
- */
 import { Clipper } from "../clipping/ClipUtils";
 import { BeJSONFunctions, PlaneAltitudeEvaluator } from "../Geometry";
 import { GeometryHandler, IStrokeHandler } from "../geometry3d/GeometryHandler";
@@ -87,7 +84,13 @@ export declare class LineString3d extends CurvePrimitive implements BeJSONFuncti
     static create(...points: any[]): LineString3d;
     /** Create a linestring, capturing the given GrowableXYZArray as the points. */
     static createCapture(points: GrowableXYZArray): LineString3d;
-    /** Create a linestring from `XAndY` points, with a specified z applied to all. */
+    /**
+     * Create a linestring from `XAndY` points, with a specified z applied to all.
+     * @param points array of 2D points.
+     * @param z the z-coordinate to apply to all points.
+     * @param enforceClosure set the coordinates of the last point to those of the first point if both points are
+     * within [[Geometry.smallMetricDistance]].
+     */
     static createXY(points: XAndY[], z: number, enforceClosure?: boolean): LineString3d;
     /**
      * Add copies of points to the linestring.
@@ -117,19 +120,19 @@ export declare class LineString3d extends CurvePrimitive implements BeJSONFuncti
      * @param fraction
      */
     addFraction(fraction: number): void;
-    /** Ensure that the fraction array exists with no fractions but at least the capacity of the point array. */
+    /** Ensure that the fractions array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyFractions(): GrowableFloat64Array;
-    /** Ensure that the parameter array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the uvParams array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyUVParams(): GrowableXYArray;
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the surfaceNormals array exists with length 0 but at least the capacity of the point array. */
     ensureEmptySurfaceNormals(): GrowableXYZArray;
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the derivatives array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyDerivatives(): GrowableXYZArray;
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the normalIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyNormalIndices(): GrowableFloat64Array;
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the uvIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyUVIndices(): GrowableFloat64Array;
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the pointIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyPointIndices(): GrowableFloat64Array;
     /**
      * Append a uv coordinate to the uvParams array
@@ -269,12 +272,17 @@ export declare class LineString3d extends CurvePrimitive implements BeJSONFuncti
         index: number;
         fraction: number;
     };
-    /** Return a frenet frame, using nearby points to estimate a plane. */
+    /** Return a Frenet frame, using nearby points to estimate a plane. */
     fractionToFrenetFrame(fraction: number, result?: Transform): Transform;
     /** Evaluate the start point of the linestring. */
     startPoint(result?: Point3d): Point3d;
     /** If i is a valid index, return that point. */
     pointAt(i: number, result?: Point3d): Point3d | undefined;
+    /**
+     * Return the point for the given index.
+     * * This method does not check for index validity. Use [[pointAt]] to have validity test.
+     */
+    pointAtUnchecked(i: number, result?: Point3d): Point3d;
     /** If i and j are both valid indices, return the vector from point i to point j */
     vectorBetween(i: number, j: number, result?: Vector3d): Vector3d | undefined;
     /** If i is a valid index, return that stored derivative vector. */
@@ -306,10 +314,6 @@ export declare class LineString3d extends CurvePrimitive implements BeJSONFuncti
      * * Find the segment that contains the start fraction
      * * Move point-by-point from that position to the start or end (respectively for negative or positive signedDistance)
      * * Optionally extrapolate
-     * @param startFraction
-     * @param signedDistance
-     * @param allowExtension
-     * @param result
      */
     moveSignedDistanceFromFraction(startFraction: number, signedDistance: number, allowExtension: false, result?: CurveLocationDetail): CurveLocationDetail;
     /** Sum lengths of segments in the linestring.  (This is a true length.) */
@@ -430,6 +434,11 @@ export declare class LineString3d extends CurvePrimitive implements BeJSONFuncti
     clonePartialCurve(fractionA: number, fractionB: number): LineString3d;
     /** Return (if possible) a specific segment of the linestring */
     getIndexedSegment(index: number, result?: LineSegment3d): LineSegment3d | undefined;
+    /**
+     * Return a specific segment of the linestring.
+     * * This method does not check for index validity. Use [[getIndexedSegment]] to have validity test.
+     */
+    getUncheckedIndexedSegment(index: number, result?: LineSegment3d): LineSegment3d;
     /**
      * Whether the start and end points are defined and within tolerance.
      * * Does not check for planarity or degeneracy.

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

@@ -1 +1 @@
-{"version":3,"file":"LineString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/LineString3d.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LineString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/LineString3d.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAa,eAAe,EAAY,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAsB,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAqB,mBAAmB,EAAqB,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA8ChD;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,cAAe,YAAW,eAAe;IACzE,wCAAwC;IACxC,SAAgB,kBAAkB,gBAAgB;IAClD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,uDAAuD;IAChD,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD,iEAAiE;IACjE,IAAoB,yBAAyB,IAAI,OAAO,CAEvD;IACD,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,UAAU,CAAC,CAAuB;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAkB;IACpC,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAC,CAAuB;IAC9C,wCAAwC;IACxC,IAAW,MAAM,IAAI,OAAO,EAAE,CAE7B;IACD,mEAAmE;IACnE,IAAW,YAAY,IAAI,gBAAgB,CAE1C;IACD;;;;;OAKG;IACH,IAAW,SAAS,IAAI,oBAAoB,GAAG,SAAS,CAEvD;IACD,wHAAwH;IACxH,IAAW,iBAAiB,IAAI,gBAAgB,GAAG,SAAS,CAE3D;IACD,0HAA0H;IAC1H,IAAW,cAAc,IAAI,eAAe,GAAG,SAAS,CAEvD;IACD,4HAA4H;IAC5H,IAAW,oBAAoB,IAAI,gBAAgB,GAAG,SAAS,CAE9D;IACD,2HAA2H;IAC3H,IAAW,aAAa,IAAI,oBAAoB,GAAG,SAAS,CAE3D;IACD,iIAAiI;IACjI,IAAW,YAAY,IAAI,oBAAoB,GAAG,SAAS,CAE1D;IACD,0HAA0H;IAC1H,IAAW,YAAY,IAAI,oBAAoB,GAAG,SAAS,CAE1D;IACD,OAAO;IAOP,yEAAyE;IAClE,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY;IAK3D;;;OAGG;WACW,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY;IAKpD,+EAA+E;WACjE,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY;IAGnE;;;;;;OAMG;WACW,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,GAAE,OAAe,GAAG,YAAY;IAWjG;;;;;;;;;OASG;IACI,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE;IAGjC,uFAAuF;IAChF,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGnG;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,OAAO;IAG9B;;;OAGG;IACI,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU;IAGtD;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM;IAKnC,yGAAyG;IAClG,oBAAoB,IAAI,oBAAoB;IAUnD,wGAAwG;IACjG,mBAAmB,IAAI,eAAe;IAU7C,8GAA8G;IACvG,yBAAyB,IAAI,gBAAgB;IAUpD,2GAA2G;IACpG,sBAAsB,IAAI,gBAAgB;IAUjD,6GAA6G;IACtG,wBAAwB,IAAI,oBAAoB;IAUvD,yGAAyG;IAClG,oBAAoB,IAAI,oBAAoB;IAUnD,4GAA4G;IACrG,uBAAuB,IAAI,oBAAoB;IAUtD;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,KAAK;IAKhC;;;OAGG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAK1C;;;OAGG;IACI,aAAa,CAAC,MAAM,EAAE,QAAQ;IAKrC;;;OAGG;IACI,gBAAgB,CAAC,MAAM,EAAE,QAAQ;IAKxC,oEAAoE;IAC7D,eAAe;IAKtB,wEAAwE;IACjE,QAAQ;IAGf,0FAA0F;IACnF,yBAAyB,CAAC,SAAS,EAAE,SAAS;IAGrD;;;;;;;;;;;OAWG;WACW,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc,GAAG,YAAY;IAe9G;;;;;;;OAOG;WACW,sBAAsB,CAClC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAE,OAAc,GACnF,YAAY;IAoBf;;;;;;;;;OASG;IACI,OAAO,CAAC,KAAK,EAAE,YAAY;IAmBlC,mDAAmD;WACrC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY;IAO3D,uFAAuF;WACzE,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,OAAe,GAAG,YAAY;IAQhH,0EAA0E;WAC5D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY;IAMrE,yCAAyC;IAClC,KAAK,IAAI,YAAY;IAK5B;;;;OAIG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAQ7B;;;OAGG;IACI,MAAM,IAAI,QAAQ,EAAE;IAS3B;;;OAGG;WACW,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,YAAY;IAGhD;;;;;OAKG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAiBnE;;;;;;OAMG;IACI,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK;IAmC5E,2EAA2E;IACpE,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAKtH;;;;;;OAMG;WACW,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAKxG;;;;;OAKG;IACI,4CAA4C,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAGjG;;;;;;;OAOG;WACW,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAavH;;;;;;OAMG;IACI,4CAA4C,CAAC,cAAc,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAGhH,sEAAsE;IACtD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;IA6CtF,kDAAkD;IAClC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO;IAK3C,gDAAgD;IACzC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAKhE;;;OAGG;IACI,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAG7D,mFAAmF;IAC5E,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAGnF,mEAAmE;IAC5D,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAKvE,sEAAsE;IAC/D,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAK1E,sDAAsD;IAC/C,SAAS,IAAI,MAAM;IAG1B,qDAAqD;IAC9C,QAAQ,IAAI,MAAM;IAGzB,gDAAgD;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IAKzC,gDAAgD;IACzC,cAAc,IAAI,IAAI;IAwB7B;;;;MAIE;IACK,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAQzD,wDAAwD;IACxC,WAAW,IAAI,MAAM;IAGrC,gFAAgF;IAChE,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuBzF,kFAAkF;IAClE,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO;IA0B3G;;;;;OAKG;IACa,8BAA8B,CAC5C,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,mBAAmB,GACjG,mBAAmB;IA4CtB,2EAA2E;IACpE,WAAW,IAAI,MAAM;IAC5B;;;;;;;;;OASG;IACI,eAAe,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAS/D,wGAAwG;IACxF,YAAY,CAC1B,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,CAAC,EAAE,mBAAmB,GACrF,mBAAmB;IAoCtB,2DAA2D;IACpD,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO;IAG9D,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAC,aAAa;IAe5B;;;;OAIG;IACa,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM;IA+BnH,uEAAuE;IAChE,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAGvE,+FAA+F;IAC/E,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAO5D;;;;;OAKG;IACI,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAejE,uEAAuE;IAChE,qBAAqB,CAAC,SAAS,GAAE,MAAqC;IAsB7E;;;;;;OAMG;IACI,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM;IAkBpE;;;;;OAKG;IACI,KAAK;IAOZ;;;;;OAKG;WACW,gBAAgB,CAAC,QAAQ,EAAE,MAAM,YAAI,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY;IAgBtG;;;;;;;OAOG;IACI,4BAA4B,CACjC,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,EAAE,SAAS,GAAE,MAAU,EAAE,SAAS,GAAE,OAAc,GACjH,IAAI;IAaP;;;;;;OAMG;IACI,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAarH,iDAAiD;IAC1C,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAyBrE;;;;OAIG;IACI,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAoCjF;;;OAGG;IACI,4BAA4B,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAUpE;;;;OAIG;IACa,qCAAqC,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,eAAe,CAAC,EAAE,cAAc;IAW/G,+EAA+E;IACxE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;IAK/D;;;;;;OAMG;IACa,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,kCAAkC,GAAG,OAAO;IA0B/G,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoB;IAC9C,gFAAgF;IAChF,OAAO,CAAC,gBAAgB;IAiBxB;;;;;OAKG;IACa,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY;IA4CrF,gEAAgE;IACzD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS;IAK1F;;;OAGG;IACI,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa;IAKvF;;;;;OAKG;IACa,uBAAuB,CAAC,SAAS,GAAE,MAAqC,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO;IAO3H,yEAAyE;IACzE,IAAW,kBAAkB,IAAI,OAAO,CAEvC;IAED;;;;;;;OAOG;IACa,8BAA8B,CAAC,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,GAAG,MAAM;IA4BzG;;;;;;OAMG;WACW,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,YAAY,EAAE;IAWzF;;;;;OAKG;IACa,wBAAwB,CACtC,cAAc,EAAE,cAAc,EAAE,EAAE,2BAA2B,EAAE,OAAO,EAAE,kBAAkB,GAAE,OAAe,GAC1G,IAAI;IASP;;;;;OAKG;IACa,iBAAiB,CAC/B,uBAAuB,EAAE,MAAM,GAAG,aAAa,GAC9C,cAAc,GAAG,cAAc,EAAE,GAAG,SAAS;IAchD;;;;;;;OAOG;IACa,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAGtG;;;;;;;;;;;;OAYG;WACW,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,mBAAmB;CAOzL;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,4CAA4C;IACrC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IACzC,uGAAuG;IAChG,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACnC,8DAA8D;IACvD,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAClC,8DAA8D;IACvD,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACnC"}

package/lib/esm/curve/LineString3d.js

@@ -1,3 +1,11 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Curve
+ */
+import { assert } from "@itwin/core-bentley";
 import { AxisOrder, Geometry } from "../Geometry";
 import { Angle } from "../geometry3d/Angle";
 import { GrowableFloat64Array } from "../geometry3d/GrowableFloat64Array";
@@ -155,22 +163,21 @@ export class LineString3d extends CurvePrimitive {
     static createCapture(points) {
         return new LineString3d(points);
     }
-    /** Create a linestring from `XAndY` points, with a specified z applied to all. */
+    /**
+     * Create a linestring from `XAndY` points, with a specified z applied to all.
+     * @param points array of 2D points.
+     * @param z the z-coordinate to apply to all points.
+     * @param enforceClosure set the coordinates of the last point to those of the first point if both points are
+     * within [[Geometry.smallMetricDistance]].
+     */
     static createXY(points, z, enforceClosure = false) {
         const result = new LineString3d();
         const xyz = result._points;
-        for (const xy of points) {
+        for (const xy of points)
             xyz.pushXYZ(xy.x, xy.y, z);
-        }
-        if (enforceClosure && points.length > 1) {
-            const distance = xyz.distanceIndexIndex(0, xyz.length - 1);
-            if (distance !== undefined && distance !== 0.0) {
-                if (Geometry.isSameCoordinate(0, distance)) {
-                    xyz.pop(); // nonzero but small distance -- to be replaced by point 0 exactly.
-                    const xyzA = xyz.front();
-                    xyz.push(xyzA);
-                }
-            }
+        if (enforceClosure && xyz.length > 1) {
+            if (xyz.almostEqualUncheckedIndexIndex(0, xyz.length - 1))
+                xyz.transferFromGrowableXYZArray(xyz.length - 1, xyz, 0);
         }
         return result;
     }
@@ -214,7 +221,7 @@ export class LineString3d extends CurvePrimitive {
             this._fractions = new GrowableFloat64Array();
         this._fractions.push(fraction);
     }
-    /** Ensure that the fraction array exists with no fractions but at least the capacity of the point array. */
+    /** Ensure that the fractions array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyFractions() {
         const n = this.numPoints();
         if (!this._fractions) {
@@ -225,7 +232,7 @@ export class LineString3d extends CurvePrimitive {
         this._fractions.ensureCapacity(n);
         return this._fractions;
     }
-    /** Ensure that the parameter array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the uvParams array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyUVParams() {
         const n = this.numPoints();
         if (!this._uvParams) {
@@ -236,7 +243,7 @@ export class LineString3d extends CurvePrimitive {
         this._uvParams.ensureCapacity(n);
         return this._uvParams;
     }
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the surfaceNormals array exists with length 0 but at least the capacity of the point array. */
     ensureEmptySurfaceNormals() {
         const n = this.numPoints();
         if (!this._surfaceNormals) {
@@ -247,7 +254,7 @@ export class LineString3d extends CurvePrimitive {
         this._surfaceNormals.ensureCapacity(n);
         return this._surfaceNormals;
     }
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the derivatives array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyDerivatives() {
         const n = this.numPoints();
         if (!this._derivatives) {
@@ -258,7 +265,7 @@ export class LineString3d extends CurvePrimitive {
         this._derivatives.ensureCapacity(n);
         return this._derivatives;
     }
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the normalIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyNormalIndices() {
         const n = this.numPoints();
         if (!this._normalIndices) {
@@ -269,7 +276,7 @@ export class LineString3d extends CurvePrimitive {
         this._normalIndices.ensureCapacity(n);
         return this._normalIndices;
     }
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the uvIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyUVIndices() {
         const n = this.numPoints();
         if (!this._uvIndices) {
@@ -280,7 +287,7 @@ export class LineString3d extends CurvePrimitive {
         this._uvIndices.ensureCapacity(n);
         return this._uvIndices;
     }
-    /** Ensure that the surfaceNormals array exists with no points but at least the capacity of the point array. */
+    /** Ensure that the pointIndices array exists with length 0 but at least the capacity of the point array. */
     ensureEmptyPointIndices() {
         const n = this.numPoints();
         if (!this._pointIndices) {
@@ -499,17 +506,20 @@ export class LineString3d extends CurvePrimitive {
      */
     fractionToPoint(fraction, result) {
         const n = this._points.length;
-        if (n === 0)
+        if (n <= 0)
             return Point3d.createZero();
         if (n === 1)
             return Point3d.createFrom(this._points.getPoint3dAtUncheckedPointIndex(0), result);
+        assert(n >= 2);
         const df = 1.0 / (n - 1);
-        if (fraction <= df)
-            return this._points.interpolate(0, fraction / df, 1, result);
-        if (fraction + df >= 1.0)
-            return this._points.interpolate(n - 1, (1.0 - fraction) / df, n - 2, result);
+        if (fraction <= df) // first segment
+            return this._points.interpolateUncheckedIndexIndex(0, fraction / df, 1, result);
+        if (fraction + df >= 1.0) // last segment
+            return this._points.interpolateUncheckedIndexIndex(n - 1, (1.0 - fraction) / df, n - 2, result);
+        assert(n > 3);
         const index0 = Math.floor(fraction / df);
-        return this._points.interpolate(index0, (fraction - index0 * df) / df, index0 + 1, result);
+        assert(0 < index0 && index0 + 1 < n);
+        return this._points.interpolateUncheckedIndexIndex(index0, (fraction - index0 * df) / df, index0 + 1, result);
     }
     /**
      * Evaluate a point a fractional position and derivative with respect to fraction along this linestring.
@@ -612,7 +622,7 @@ export class LineString3d extends CurvePrimitive {
     globalFractionToSegmentIndexAndLocalFraction(globalFraction) {
         return LineString3d.mapGlobalToLocalFraction(globalFraction, this._points.length - 1);
     }
-    /** Return a frenet frame, using nearby points to estimate a plane. */
+    /** Return a Frenet frame, using nearby points to estimate a plane. */
     fractionToFrenetFrame(fraction, result) {
         const n = this._points.length;
         if (n <= 1) {
@@ -620,8 +630,10 @@ export class LineString3d extends CurvePrimitive {
                 return Transform.createTranslation(this._points.getPoint3dAtUncheckedPointIndex(0), result);
             return Transform.createIdentity(result);
         }
-        if (n === 2)
-            return Transform.createRefs(this._points.interpolate(0, fraction, 1), Matrix3d.createRigidHeadsUp(this._points.vectorIndexIndex(0, 1), AxisOrder.XYZ));
+        if (n === 2) {
+            const rotation = Matrix3d.createRigidHeadsUp(this._points.vectorUncheckedIndexIndex(0, 1), AxisOrder.XYZ);
+            return Transform.createOriginAndMatrix(this._points.interpolate(0, fraction, 1), rotation, result);
+        }
         /** 3 or more points. */
         const numSegment = n - 1;
         const df = 1.0 / numSegment;
@@ -639,8 +651,9 @@ export class LineString3d extends CurvePrimitive {
             baseIndex = Math.floor(fraction / df);
             localFraction = fraction * numSegment - baseIndex;
         }
-        const origin = this._points.interpolate(baseIndex, localFraction, baseIndex + 1);
-        const vectorA = this._points.vectorIndexIndex(baseIndex, baseIndex + 1);
+        assert(0 <= baseIndex && baseIndex < n - 1, "expect valid baseIndex");
+        const origin = this._points.interpolateUncheckedIndexIndex(baseIndex, localFraction, baseIndex + 1);
+        const vectorA = this._points.vectorUncheckedIndexIndex(baseIndex, baseIndex + 1);
         // tricky stuff to handle colinear points.   But if vectorA is zero it is still a mess . ..
         const normal = Vector3d.create();
         const workVector = Vector3d.create();
@@ -668,9 +681,16 @@ export class LineString3d extends CurvePrimitive {
     /** If i is a valid index, return that point. */
     pointAt(i, result) {
         if (this._points.isIndexValid(i))
-            return this._points.getPoint3dAtUncheckedPointIndex(i, result);
+            return this.pointAtUnchecked(i, result);
         return undefined;
     }
+    /**
+     * Return the point for the given index.
+     * * This method does not check for index validity. Use [[pointAt]] to have validity test.
+     */
+    pointAtUnchecked(i, result) {
+        return this._points.getPoint3dAtUncheckedPointIndex(i, result);
+    }
     /** If i and j are both valid indices, return the vector from point i to point j */
     vectorBetween(i, j, result) {
         return this._points.vectorIndexIndex(i, j, result);
@@ -745,30 +765,27 @@ export class LineString3d extends CurvePrimitive {
     }
     /** Sum the lengths of segments between fractional positions on a linestring. */
     curveLengthBetweenFractions(fraction0, fraction1) {
-        const numSegments = this._points.length - 1;
+        const n = this._points.length;
+        const numSegments = n - 1;
         if (fraction1 === fraction0 || numSegments < 1)
             return 0.0;
         if (fraction1 < fraction0)
             return this.curveLengthBetweenFractions(fraction1, fraction0);
         const scaledFraction0 = fraction0 * numSegments;
         const scaledFraction1 = fraction1 * numSegments;
-        const index0 = Math.max(1, Math.ceil(scaledFraction0));
-        const index1 = Math.min(Math.floor(scaledFraction1), numSegments - 1);
-        const localFraction0 = index0 - scaledFraction0;
-        const localFraction1 = scaledFraction1 - index1;
-        if (index0 > index1) {
-            // the interval is entirely within a single segment
-            return Math.abs(scaledFraction1 - scaledFraction0) * this._points.distanceIndexIndex(index0 - 1, index0);
-        }
-        else {
-            // there is leading partial interval, 0 or more complete segments, and a trailing partial interval.
-            // (either or both partial may be zero length)
-            let sum = localFraction0 * this._points.distanceIndexIndex(index0 - 1, index0)
-                + localFraction1 * (this._points.distanceIndexIndex(index1, index1 + 1));
-            for (let i = index0; i < index1; i++)
-                sum += this._points.distanceIndexIndex(i, i + 1);
-            return sum;
-        }
+        const index0 = Math.max(1, Math.ceil(scaledFraction0)); // right index of first contributing partial/trivial segment
+        const index1 = Math.min(Math.floor(scaledFraction1), numSegments - 1); // left index of last contributing partial/trivial segment
+        assert(0 < index0 && index0 <= index1 + 1 && index1 + 1 < n, "expect index0, index1 are valid indices");
+        if (index0 > index1) // only one segment contributes to the sum
+            return Math.abs(scaledFraction1 - scaledFraction0) * this._points.distanceUncheckedIndexIndex(index1, index0);
+        // we have 1 leading partial/trivial segment, 0+ complete segments, and 1 trailing partial/trivial segment
+        const localFraction0 = index0 - scaledFraction0; // fractional length of first contributing segment
+        const localFraction1 = scaledFraction1 - index1; // fractional length of last contributing segment
+        let sum = localFraction0 * this._points.distanceUncheckedIndexIndex(index0 - 1, index0);
+        for (let i = index0; i < index1; i++)
+            sum += this._points.distanceUncheckedIndexIndex(i, i + 1);
+        sum += localFraction1 * this._points.distanceUncheckedIndexIndex(index1, index1 + 1);
+        return sum;
     }
     /** Compute the range of points between fractional positions on the linestring. */
     rangeBetweenFractions(fraction0, fraction1, transform) {
@@ -802,17 +819,15 @@ export class LineString3d extends CurvePrimitive {
      * * Find the segment that contains the start fraction
      * * Move point-by-point from that position to the start or end (respectively for negative or positive signedDistance)
      * * Optionally extrapolate
-     * @param startFraction
-     * @param signedDistance
-     * @param allowExtension
-     * @param result
      */
     moveSignedDistanceFromFraction(startFraction, signedDistance, allowExtension, result) {
-        const numSegments = this._points.length - 1;
+        const n = this._points.length;
+        const numSegments = n - 1;
         const scaledFraction = startFraction * numSegments;
         let leftPointIndex = Geometry.restrictToInterval(Math.floor(scaledFraction), 0, numSegments - 1); // lower point index on active segment.
         const localFraction = scaledFraction - leftPointIndex;
-        const point0 = this._points.interpolate(leftPointIndex, localFraction, leftPointIndex + 1, LineString3d._workPointA);
+        assert(0 <= leftPointIndex && leftPointIndex + 1 < n, "expect leftPointIndex is valid");
+        const point0 = this._points.interpolateUncheckedIndexIndex(leftPointIndex, localFraction, leftPointIndex + 1, LineString3d._workPointA);
         const point1 = LineString3d._workPointB;
         const context = new MoveByDistanceContext(point0, startFraction, signedDistance);
         if (signedDistance > 0.0) {
@@ -974,16 +989,15 @@ export class LineString3d extends CurvePrimitive {
     appendStrokePoint(point, fraction) {
         const n = this._points.length;
         let add = true;
-        const addFraction = (fraction !== undefined) && (this._fractions !== undefined);
         if (n > 0) {
-            if (addFraction && Geometry.isSmallRelative(fraction - this._fractions.back()))
+            if (fraction !== undefined && this._fractions && Geometry.isSmallRelative(fraction - this._fractions.back()))
                 add = false;
-            if (point.isAlmostEqual(this._points.getPoint3dAtUncheckedPointIndex(n - 1)))
+            else if (point.isAlmostEqual(this._points.getPoint3dAtUncheckedPointIndex(n - 1)))
                 add = false;
         }
         if (add) {
             this._points.push(point);
-            if (addFraction)
+            if (fraction !== undefined)
                 this.addFraction(fraction);
         }
     }
@@ -1174,9 +1188,8 @@ export class LineString3d extends CurvePrimitive {
         let numStroke = numPoints - 1;
         if (options && options.hasMaxEdgeLength) {
             numStroke = 0;
-            for (let i = 1; i < numPoints; i++) {
-                numStroke += options.applyMaxEdgeLength(1, this._points.distanceIndexIndex(i - 1, i));
-            }
+            for (let i = 1; i < numPoints; i++)
+                numStroke += options.applyMaxEdgeLength(1, this._points.distanceUncheckedIndexIndex(i - 1, i));
         }
         return numStroke;
     }
@@ -1190,7 +1203,7 @@ export class LineString3d extends CurvePrimitive {
         const applyOptions = options !== undefined && options.hasMaxEdgeLength;
         const myData = StrokeCountMap.createWithCurvePrimitiveAndOptionalParent(this, parentStrokeMap, []);
         for (let i = 1; i < numPoints; i++) {
-            const segmentLength = this._points.distanceIndexIndex(i - 1, i);
+            const segmentLength = this._points.distanceUncheckedIndexIndex(i - 1, i);
             const numStrokeOnSegment = applyOptions ? options.applyMaxEdgeLength(1, segmentLength) : 1;
             myData.addToCountAndLength(numStrokeOnSegment, segmentLength);
         }
@@ -1307,10 +1320,17 @@ export class LineString3d extends CurvePrimitive {
     }
     /** Return (if possible) a specific segment of the linestring */
     getIndexedSegment(index, result) {
-        if (index >= 0 && index + 1 < this._points.length)
-            return LineSegment3d.create(this._points.getPoint3dAtCheckedPointIndex(index), this._points.getPoint3dAtCheckedPointIndex(index + 1), result);
+        if (index >= 0 && index < this.numEdges())
+            return this.getUncheckedIndexedSegment(index, result);
         return undefined;
     }
+    /**
+     * Return a specific segment of the linestring.
+     * * This method does not check for index validity. Use [[getIndexedSegment]] to have validity test.
+     */
+    getUncheckedIndexedSegment(index, result) {
+        return LineSegment3d.create(this._points.getPoint3dAtUncheckedPointIndex(index), this._points.getPoint3dAtUncheckedPointIndex(index + 1), result);
+    }
     /**
      * Whether the start and end points are defined and within tolerance.
      * * Does not check for planarity or degeneracy.
@@ -1321,8 +1341,8 @@ export class LineString3d extends CurvePrimitive {
         if (!this._points.length)
             return false;
         if (xyOnly)
-            return this._points.almostEqualXYIndexIndex(0, this._points.length - 1, tolerance); // we know the indices are valid
-        return this._points.almostEqualIndexIndex(0, this._points.length - 1, tolerance);
+            return this._points.almostEqualXYUncheckedIndexIndex(0, this._points.length - 1, tolerance);
+        return this._points.almostEqualUncheckedIndexIndex(0, this._points.length - 1, tolerance);
     }
     /** Returns true if first and last points are within metric tolerance. */
     get isPhysicallyClosed() {
@@ -1338,8 +1358,6 @@ export class LineString3d extends CurvePrimitive {
      */
     addMappedStrokesToLineString3D(map, destLinestring) {
         const numPoint0 = destLinestring.numPoints();
-        const needFractions = destLinestring._fractions !== undefined;
-        const needDerivatives = destLinestring._derivatives !== undefined;
         const points = this._points;
         const pointA = LineString3d._workPointA;
         const pointB = LineString3d._workPointB;
@@ -1357,9 +1375,9 @@ export class LineString3d extends CurvePrimitive {
                     const fraction = i / m;
                     const outputFraction = segmentMap.fractionToA(fraction);
                     destLinestring.addPoint(pointA.interpolate(fraction, pointB, pointC));
-                    if (needFractions)
-                        destLinestring._fractions.push((outputFraction));
-                    if (needDerivatives)
+                    if (destLinestring._fractions)
+                        destLinestring._fractions.push(outputFraction);
+                    if (destLinestring._derivatives)
                         destLinestring._derivatives.push(vectorAB);
                 }
             }