@itwin/core-geometry 4.1.0-dev.4 → 4.1.0-dev.40

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

@@ -18,36 +18,38 @@ import { LineString3d } from "./LineString3d";
 import { StrokeOptions } from "./StrokeOptions";
 /**
  * A LineSegment3d is:
- *
  * * A 3d line segment represented by its start and end coordinates
  *   * startPoint
  *   * endPoint
- * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. either of these equivalent forms to map fraction `f` to a point `X(f)`
+ * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. each of these
+ * equivalent forms maps fraction `f` to a point `X(f)`:
  * ```
  * equation
- *  X(f) = P_0 + f * (P_1 - P_0)\newline
- *  X(f) = (1-f)*P_0  + f * P_0
+ *  X(f) = P_0 + f*(P_1 - P_0)\newline
+ *  X(f) = (1-f)*P_0 + f*P_1
  * ```
  * @public
  */
 export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunctions {
     /** String name for schema properties */
     readonly curvePrimitiveType = "lineSegment";
-    /** test if `other` is of class `LineSegment3d` */
+    /** Test if `other` is of class `LineSegment3d` */
     isSameGeometryClass(other: GeometryQuery): boolean;
+    /** Start point of the segment */
     private _point0;
+    /** End point of the segment */
     private _point1;
-    /** Return REFERENCE to the start point of this segment.
-     * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point
+    /**
+     * Return REFERENCE to the start point of this segment.
+     * * This is distinct from the `CurvePrimitive` abstract method `startPoint()` which creates a returned point.
      */
     get point0Ref(): Point3d;
-    /** Return REFERENCE to the end point of this segment.
-     * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point
-     */
-    get point1Ref(): Point3d;
     /**
-     * A LineSegment3d extends along its infinite line.
+     * Return REFERENCE to the end point of this segment.
+     * * This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point.
      */
+    get point1Ref(): Point3d;
+    /** A LineSegment3d extends along its infinite line. */
     get isExtensibleFractionSpace(): boolean;
     /**
      * CAPTURE point references as a `LineSegment3d`
@@ -59,15 +61,16 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
     setRefs(point0: Point3d, point1: Point3d): void;
     /** Set the start and endpoints by cloning the input parameters. */
     set(point0: Point3d, point1: Point3d): void;
-    /** copy (clone) data from other */
+    /** Copy (clone) data from other */
     setFrom(other: LineSegment3d): void;
-    /** Return a (clone of) the start point. (This is NOT a reference to the stored start point) */
+    /** Return a (clone of) the start point (This is NOT a reference to the stored start point) */
     startPoint(result?: Point3d): Point3d;
-    /** Return a (clone of) the end point. (This is NOT a reference to the stored end point) */
+    /** Return a (clone of) the end point (This is NOT a reference to the stored end point) */
     endPoint(result?: Point3d): Point3d;
     /** Return the point and derivative vector at fractional position along the line segment. */
     fractionToPointAndDerivative(fraction: number, result?: Ray3d): Ray3d;
-    /** Construct a plane with
+    /**
+     * Construct a plane with
      * * origin at the fractional position along the line segment
      * * x axis is the first derivative, i.e. along the line segment
      * * y axis is the second derivative, i.e. 000
@@ -81,7 +84,8 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
     static create(point0: Point3d, point1: Point3d, result?: LineSegment3d): LineSegment3d;
     /** Create with start and end points.  The point contents are CAPTURED into the result */
     static createCapture(point0: Point3d, point1: Point3d): LineSegment3d;
-    /** create a LineSegment3d from xy coordinates of start and end, with common z.
+    /**
+     * Create a LineSegment3d from xy coordinates of start and end, with common z.
      * @param x0 start point x coordinate.
      * @param y0 start point y coordinate.
      * @param x1 end point x coordinate.
@@ -90,7 +94,8 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
      * @param result optional existing LineSegment to be reinitialized.
      */
     static createXYXY(x0: number, y0: number, x1: number, y1: number, z?: number, result?: LineSegment3d): LineSegment3d;
-    /** create a LineSegment3d from xy coordinates of start and end, with common z.
+    /**
+     * Create a LineSegment3d from xy coordinates of start and end, with common z.
      * @param x0 start point x coordinate.
      * @param y0 start point y coordinate.
      * @param x1 end point x coordinate.
@@ -110,16 +115,18 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
     /**
      * Returns a curve location detail with both xyz and fractional coordinates of the closest point.
      * @param spacePoint point in space
-     * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on the unbounded line that contains the bounded segment.
+     * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on
+     * the unbounded line that contains the bounded segment.
      */
     closestPoint(spacePoint: Point3d, extend: VariantCurveExtendParameter, result?: CurveLocationDetail): CurveLocationDetail;
-    /** swap the endpoint references. */
+    /** Swap the endpoint references. */
     reverseInPlace(): void;
     /** Transform the two endpoints of this LinSegment. */
     tryTransformInPlace(transform: Transform): boolean;
     /** Test if both endpoints are in a plane (within tolerance) */
     isInPlane(plane: PlaneAltitudeEvaluator): boolean;
-    /** Compute points of simple (transverse) with a plane.
+    /**
+     * Compute points of simple (transverse) with a plane.
      * * Use isInPlane to test if the line segment is completely in the plane.
      */
     appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number;
@@ -156,19 +163,20 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
     /** Emit strokes to caller-supplied handler */
     emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void;
     /**
-     * return the stroke count required for given options.
+     * Return the stroke count required for given options.
      * @param options StrokeOptions that determine count
      */
     computeStrokeCountForOptions(options?: StrokeOptions): number;
-    /** Second step of double dispatch:  call `handler.handleLineSegment3d(this)` */
+    /** Second step of double dispatch: call `handler.handleLineSegment3d(this)` */
     dispatchToGeometryHandler(handler: GeometryHandler): any;
     /**
      * Find intervals of this curve primitive that are interior to a clipper
      * @param clipper clip structure (e.g. clip planes)
-     * @param announce function to be called announcing fractional intervals"  ` announce(fraction0, fraction1, curvePrimitive)`
+     * @param announce function to be called announcing fractional intervals `announce(fraction0, fraction1, curvePrimitive)`
      */
     announceClipIntervals(clipper: Clipper, announce?: AnnounceNumberNumberCurvePrimitive): boolean;
-    /** Return (if possible) a curve primitive which is a portion of this curve.
+    /**
+     * Return (if possible) a curve primitive which is a portion of this curve.
      * @param fractionA [in] start fraction
      * @param fractionB [in] end fraction
      */
@@ -183,10 +191,13 @@ export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunct
      * @param offsetDistanceOrOptions offset distance (positive to left of the instance curve), or options object
      */
     constructOffsetXY(offsetDistanceOrOptions: number | OffsetOptions): CurvePrimitive | CurvePrimitive[] | undefined;
-    /** Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.
+    /**
+     * Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of
+     * projection.
      * @param ray ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with zero origin.
      * @param lowHigh optional receiver for output
-     * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the end of the ray.
+     * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the
+     * end of the ray.
      */
     projectedParameterRange(ray: Vector3d | Ray3d, lowHigh?: Range1d): Range1d | undefined;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"LineSegment3d.d.ts","sourceRoot":"","sources":["../../../src/curve/LineSegment3d.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LineSegment3d.d.ts","sourceRoot":"","sources":["../../../src/curve/LineSegment3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAY,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAClE,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;AAEpD,OAAO,EAAsB,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAqB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,kCAAkC,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,cAAe,YAAW,eAAe;IAC1E,wCAAwC;IACxC,SAAgB,kBAAkB,iBAAiB;IACnD,kDAAkD;IAC3C,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD,iCAAiC;IACjC,OAAO,CAAC,OAAO,CAAU;IACzB,+BAA+B;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,uDAAuD;IACvD,IAAoB,yBAAyB,IAAI,OAAO,CAEvD;IACD;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAKtD,iEAAiE;IAC1D,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAI/C,mEAAmE;IAC5D,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAI3C,mCAAmC;IAC5B,OAAO,CAAC,KAAK,EAAE,aAAa;IAInC,8FAA8F;IAC9E,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAIrD,0FAA0F;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAInD,4FAA4F;IACrF,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK;IAM5E;;;;;OAKG;IACI,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAOtH,8BAA8B;IACvB,KAAK,IAAI,aAAa;IAG7B,8CAA8C;IACvC,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAK5D,+FAA+F;WACjF,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa;IAO7F,yFAAyF;WAC3E,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa;IAG5E;;;;;;;;OAQG;WACW,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,aAAa;IAQ9G;;;;;;;;OAQG;WACW,YAAY,CACxB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAC7F,aAAa;IAQhB,sEAAsE;IAC/D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAGnE,wCAAwC;IACxB,WAAW,IAAI,MAAM;IAGrC,kEAAkE;IAClD,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAGzF,wCAAwC;IACjC,WAAW,IAAI,MAAM;IAG5B;;;;;OAKG;IACa,YAAY,CAC1B,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,CAAC,EAAE,mBAAmB,GACrF,mBAAmB;IAYtB,oCAAoC;IAC7B,cAAc,IAAI,IAAI;IAK7B,sDAAsD;IAC/C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAKzD,+DAA+D;IACxD,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO;IAIxD;;;OAGG;IACa,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM;IAanH;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAS/D;;;;;;;;;OASG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAc7B,sEAAsE;IACtD,0BAA0B,IAAI,MAAM,GAAG,SAAS;IAGhE;;;OAGG;IACI,MAAM,IAAI,GAAG;IAGpB,yHAAyH;WAC3G,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,aAAa;IAKjD,uCAAuC;IACvB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAO5D,iDAAiD;IAC1C,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAIrE,8CAA8C;IACvC,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAMjF;;;OAGG;IACI,4BAA4B,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IASpE,+EAA+E;IACxE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;IAG/D;;;;OAIG;IACa,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,kCAAkC,GAAG,OAAO;IAI/G;;;;OAIG;IACa,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa;IAGtF;;;OAGG;IACa,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO;IAgB3G;;;OAGG;IACa,iBAAiB,CAC/B,uBAAuB,EAAE,MAAM,GAAG,aAAa,GAC9C,cAAc,GAAG,cAAc,EAAE,GAAG,SAAS;IAWhD;;;;;;;OAOG;IACa,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;CAGvG"}

package/lib/esm/curve/LineSegment3d.js

@@ -16,33 +16,41 @@ import { OffsetOptions } from "./internalContexts/PolygonOffsetContext";
 /* eslint-disable @typescript-eslint/naming-convention, no-empty */
 /**
  * A LineSegment3d is:
- *
  * * A 3d line segment represented by its start and end coordinates
  *   * startPoint
  *   * endPoint
- * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. either of these equivalent forms to map fraction `f` to a point `X(f)`
+ * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. each of these
+ * equivalent forms maps fraction `f` to a point `X(f)`:
  * ```
  * equation
- *  X(f) = P_0 + f * (P_1 - P_0)\newline
- *  X(f) = (1-f)*P_0  + f * P_0
+ *  X(f) = P_0 + f*(P_1 - P_0)\newline
+ *  X(f) = (1-f)*P_0 + f*P_1
  * ```
  * @public
  */
 export class LineSegment3d extends CurvePrimitive {
-    /** test if `other` is of class `LineSegment3d` */
-    isSameGeometryClass(other) { return other instanceof LineSegment3d; }
-    /** Return REFERENCE to the start point of this segment.
-     * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point
-     */
-    get point0Ref() { return this._point0; }
-    /** Return REFERENCE to the end point of this segment.
-     * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point
+    /** Test if `other` is of class `LineSegment3d` */
+    isSameGeometryClass(other) {
+        return other instanceof LineSegment3d;
+    }
+    /**
+     * Return REFERENCE to the start point of this segment.
+     * * This is distinct from the `CurvePrimitive` abstract method `startPoint()` which creates a returned point.
      */
-    get point1Ref() { return this._point1; }
+    get point0Ref() {
+        return this._point0;
+    }
     /**
-     * A LineSegment3d extends along its infinite line.
+     * Return REFERENCE to the end point of this segment.
+     * * This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point.
      */
-    get isExtensibleFractionSpace() { return true; }
+    get point1Ref() {
+        return this._point1;
+    }
+    /** A LineSegment3d extends along its infinite line. */
+    get isExtensibleFractionSpace() {
+        return true;
+    }
     /**
      * CAPTURE point references as a `LineSegment3d`
      * @param point0
@@ -56,12 +64,21 @@ export class LineSegment3d extends CurvePrimitive {
         this._point1 = point1;
     }
     /** Set the start and endpoints by capturing input references. */
-    setRefs(point0, point1) { this._point0 = point0; this._point1 = point1; }
+    setRefs(point0, point1) {
+        this._point0 = point0;
+        this._point1 = point1;
+    }
     /** Set the start and endpoints by cloning the input parameters. */
-    set(point0, point1) { this._point0 = point0.clone(); this._point1 = point1.clone(); }
-    /** copy (clone) data from other */
-    setFrom(other) { this._point0.setFrom(other._point0); this._point1.setFrom(other._point1); }
-    /** Return a (clone of) the start point. (This is NOT a reference to the stored start point) */
+    set(point0, point1) {
+        this._point0 = point0.clone();
+        this._point1 = point1.clone();
+    }
+    /** Copy (clone) data from other */
+    setFrom(other) {
+        this._point0.setFrom(other._point0);
+        this._point1.setFrom(other._point1);
+    }
+    /** Return a (clone of) the start point (This is NOT a reference to the stored start point) */
     startPoint(result) {
         if (result) {
             result.setFrom(this._point0);
@@ -69,7 +86,7 @@ export class LineSegment3d extends CurvePrimitive {
         }
         return this._point0.clone();
     }
-    /** Return a (clone of) the end point. (This is NOT a reference to the stored end point) */
+    /** Return a (clone of) the end point (This is NOT a reference to the stored end point) */
     endPoint(result) {
         if (result) {
             result.setFrom(this._point1);
@@ -84,7 +101,8 @@ export class LineSegment3d extends CurvePrimitive {
         this._point0.interpolate(fraction, this._point1, result.origin);
         return result;
     }
-    /** Construct a plane with
+    /**
+     * Construct a plane with
      * * origin at the fractional position along the line segment
      * * x axis is the first derivative, i.e. along the line segment
      * * y axis is the second derivative, i.e. 000
@@ -97,7 +115,9 @@ export class LineSegment3d extends CurvePrimitive {
         return result;
     }
     /** Clone the LineSegment3d */
-    clone() { return LineSegment3d.create(this._point0, this._point1); }
+    clone() {
+        return LineSegment3d.create(this._point0, this._point1);
+    }
     /** Clone and apply transform to the clone. */
     cloneTransformed(transform) {
         const c = this.clone();
@@ -116,7 +136,8 @@ export class LineSegment3d extends CurvePrimitive {
     static createCapture(point0, point1) {
         return new LineSegment3d(point0, point1);
     }
-    /** create a LineSegment3d from xy coordinates of start and end, with common z.
+    /**
+     * Create a LineSegment3d from xy coordinates of start and end, with common z.
      * @param x0 start point x coordinate.
      * @param y0 start point y coordinate.
      * @param x1 end point x coordinate.
@@ -132,7 +153,8 @@ export class LineSegment3d extends CurvePrimitive {
         }
         return new LineSegment3d(Point3d.create(x0, y0, z), Point3d.create(x1, y1, z));
     }
-    /** create a LineSegment3d from xy coordinates of start and end, with common z.
+    /**
+     * Create a LineSegment3d from xy coordinates of start and end, with common z.
      * @param x0 start point x coordinate.
      * @param y0 start point y coordinate.
      * @param x1 end point x coordinate.
@@ -149,19 +171,26 @@ export class LineSegment3d extends CurvePrimitive {
         return new LineSegment3d(Point3d.create(x0, y0, z0), Point3d.create(x1, y1, z1));
     }
     /** Return the point at fractional position along the line segment. */
-    fractionToPoint(fraction, result) { return this._point0.interpolate(fraction, this._point1, result); }
+    fractionToPoint(fraction, result) {
+        return this._point0.interpolate(fraction, this._point1, result);
+    }
     /** Return the length of the segment. */
-    curveLength() { return this._point0.distance(this._point1); }
+    curveLength() {
+        return this._point0.distance(this._point1);
+    }
     /** Return the length of the partial segment between fractions. */
     curveLengthBetweenFractions(fraction0, fraction1) {
         return Math.abs(fraction1 - fraction0) * this._point0.distance(this._point1);
     }
     /** Return the length of the segment. */
-    quickLength() { return this.curveLength(); }
+    quickLength() {
+        return this.curveLength();
+    }
     /**
      * Returns a curve location detail with both xyz and fractional coordinates of the closest point.
      * @param spacePoint point in space
-     * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on the unbounded line that contains the bounded segment.
+     * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on
+     * the unbounded line that contains the bounded segment.
      */
     closestPoint(spacePoint, extend, result) {
         let fraction = spacePoint.fractionOfProjectionToLine(this._point0, this._point1, 0.0);
@@ -175,7 +204,7 @@ export class LineSegment3d extends CurvePrimitive {
         result.a = result.point.distance(spacePoint);
         return result;
     }
-    /** swap the endpoint references. */
+    /** Swap the endpoint references. */
     reverseInPlace() {
         const a = this._point0;
         this._point0 = this._point1;
@@ -192,7 +221,8 @@ export class LineSegment3d extends CurvePrimitive {
         return Geometry.isSmallMetricDistance(plane.altitude(this._point0))
             && Geometry.isSmallMetricDistance(plane.altitude(this._point1));
     }
-    /** Compute points of simple (transverse) with a plane.
+    /**
+     * Compute points of simple (transverse) with a plane.
      * * Use isInPlane to test if the line segment is completely in the plane.
      */
     appendPlaneIntersectionPoints(plane, result) {
@@ -250,12 +280,16 @@ export class LineSegment3d extends CurvePrimitive {
         }
     }
     /** A simple line segment's fraction and distance are proportional. */
-    getFractionToDistanceScale() { return this.curveLength(); }
+    getFractionToDistanceScale() {
+        return this.curveLength();
+    }
     /**
      * Place the lineSegment3d start and points in a json object
      * @return {*} [[x,y,z],[x,y,z]]
      */
-    toJSON() { return [this._point0.toJSON(), this._point1.toJSON()]; }
+    toJSON() {
+        return [this._point0.toJSON(), this._point1.toJSON()];
+    }
     /** Create a new `LineSegment3d` with coordinates from json object.   See `setFromJSON` for object layout description. */
     static fromJSON(json) {
         const result = new LineSegment3d(Point3d.createZero(), Point3d.create());
@@ -283,7 +317,7 @@ export class LineSegment3d extends CurvePrimitive {
         handler.endCurvePrimitive(this);
     }
     /**
-     * return the stroke count required for given options.
+     * Return the stroke count required for given options.
      * @param options StrokeOptions that determine count
      */
     computeStrokeCountForOptions(options) {
@@ -295,19 +329,20 @@ export class LineSegment3d extends CurvePrimitive {
         }
         return numStroke;
     }
-    /** Second step of double dispatch:  call `handler.handleLineSegment3d(this)` */
+    /** Second step of double dispatch: call `handler.handleLineSegment3d(this)` */
     dispatchToGeometryHandler(handler) {
         return handler.handleLineSegment3d(this);
     }
     /**
      * Find intervals of this curve primitive that are interior to a clipper
      * @param clipper clip structure (e.g. clip planes)
-     * @param announce function to be called announcing fractional intervals"  ` announce(fraction0, fraction1, curvePrimitive)`
+     * @param announce function to be called announcing fractional intervals `announce(fraction0, fraction1, curvePrimitive)`
      */
     announceClipIntervals(clipper, announce) {
         return clipper.announceClippedSegmentIntervals(0.0, 1.0, this._point0, this._point1, announce ? (fraction0, fraction1) => announce(fraction0, fraction1, this) : undefined);
     }
-    /** Return (if possible) a curve primitive which is a portion of this curve.
+    /**
+     * Return (if possible) a curve primitive which is a portion of this curve.
      * @param fractionA [in] start fraction
      * @param fractionB [in] end fraction
      */
@@ -347,10 +382,13 @@ export class LineSegment3d extends CurvePrimitive {
         }
         return undefined;
     }
-    /** Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.
+    /**
+     * Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of
+     * projection.
      * @param ray ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with zero origin.
      * @param lowHigh optional receiver for output
-     * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the end of the ray.
+     * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the
+     * end of the ray.
      */
     projectedParameterRange(ray, lowHigh) {
         return PlaneAltitudeRangeContext.findExtremeFractionsAlongDirection(this, ray, lowHigh);

package/lib/esm/curve/LineSegment3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"LineSegment3d.js","sourceRoot":"","sources":["../../../src/curve/LineSegment3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Curve\r\n */\r\n\r\nimport { Clipper } from \"../clipping/ClipUtils\";\r\nimport { BeJSONFunctions, Geometry, PlaneAltitudeEvaluator } from \"../Geometry\";\r\nimport { GeometryHandler, IStrokeHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Plane3dByOriginAndVectors } from \"../geometry3d/Plane3dByOriginAndVectors\";\r\nimport { Point3d, Vector3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Range1d, Range3d } from \"../geometry3d/Range\";\r\nimport { Ray3d } from \"../geometry3d/Ray3d\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { Order2Bezier } from \"../numerics/BezierPolynomials\";\r\nimport { CurveExtendOptions, VariantCurveExtendParameter } from \"./CurveExtendMode\";\r\nimport { CurveIntervalRole, CurveLocationDetail } from \"./CurveLocationDetail\";\r\nimport { AnnounceNumberNumberCurvePrimitive, CurvePrimitive } from \"./CurvePrimitive\";\r\nimport { GeometryQuery } from \"./GeometryQuery\";\r\nimport { PlaneAltitudeRangeContext } from \"./internalContexts/PlaneAltitudeRangeContext\";\r\nimport { OffsetOptions } from \"./internalContexts/PolygonOffsetContext\";\r\nimport { LineString3d } from \"./LineString3d\";\r\nimport { StrokeOptions } from \"./StrokeOptions\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\n\r\n/**\r\n * A LineSegment3d is:\r\n *\r\n * * A 3d line segment represented by its start and end coordinates\r\n *   * startPoint\r\n *   * endPoint\r\n * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. either of these equivalent forms to map fraction `f` to a point `X(f)`\r\n * ```\r\n * equation\r\n *  X(f) = P_0 + f * (P_1 - P_0)\\newline\r\n *  X(f) = (1-f)*P_0  + f * P_0\r\n * ```\r\n * @public\r\n */\r\nexport class LineSegment3d extends CurvePrimitive implements BeJSONFunctions {\r\n  /** String name for schema properties */\r\n  public readonly curvePrimitiveType = \"lineSegment\";\r\n\r\n  /** test if `other` is of class `LineSegment3d` */\r\n  public isSameGeometryClass(other: GeometryQuery): boolean { return other instanceof LineSegment3d; }\r\n  private _point0: Point3d;\r\n  private _point1: Point3d;\r\n  /** Return REFERENCE to the start point of this segment.\r\n   * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point\r\n   */\r\n  public get point0Ref(): Point3d { return this._point0; }\r\n  /** Return REFERENCE to the end point of this segment.\r\n   * * (This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point\r\n   */\r\n  public get point1Ref(): Point3d { return this._point1; }\r\n  /**\r\n   * A LineSegment3d extends along its infinite line.\r\n   */\r\n  public override get isExtensibleFractionSpace(): boolean { return true; }\r\n\r\n  /**\r\n   * CAPTURE point references as a `LineSegment3d`\r\n   * @param point0\r\n   * @param point1\r\n   */\r\n  protected constructor(point0: Point3d, point1: Point3d) { super(); this._point0 = point0; this._point1 = point1; }\r\n  /** Set the start and endpoints by capturing input references. */\r\n  public setRefs(point0: Point3d, point1: Point3d) { this._point0 = point0; this._point1 = point1; }\r\n  /** Set the start and endpoints by cloning the input parameters. */\r\n  public set(point0: Point3d, point1: Point3d) { this._point0 = point0.clone(); this._point1 = point1.clone(); }\r\n  /** copy (clone) data from other */\r\n  public setFrom(other: LineSegment3d) { this._point0.setFrom(other._point0); this._point1.setFrom(other._point1); }\r\n  /** Return a (clone of) the start point. (This is NOT a reference to the stored start point) */\r\n  public override startPoint(result?: Point3d): Point3d {\r\n    if (result) { result.setFrom(this._point0); return result; }\r\n    return this._point0.clone();\r\n  }\r\n  /** Return a (clone of) the end point. (This is NOT a reference to the stored end point) */\r\n  public override endPoint(result?: Point3d): Point3d {\r\n    if (result) { result.setFrom(this._point1); return result; }\r\n    return this._point1.clone();\r\n  }\r\n  /** Return the point and derivative vector at fractional position along the line segment. */\r\n  public fractionToPointAndDerivative(fraction: number, result?: Ray3d): Ray3d {\r\n    result = result ? result : Ray3d.createZero();\r\n    result.direction.setStartEnd(this._point0, this._point1);\r\n    this._point0.interpolate(fraction, this._point1, result.origin);\r\n    return result;\r\n  }\r\n  /** Construct a plane with\r\n   * * origin at the fractional position along the line segment\r\n   * * x axis is the first derivative, i.e. along the line segment\r\n   * * y axis is the second derivative, i.e. 000\r\n   */\r\n  public fractionToPointAnd2Derivatives(fraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    result = result ? result : Plane3dByOriginAndVectors.createXYPlane();\r\n    result.vectorU.setStartEnd(this._point0, this._point1);\r\n    result.vectorV.set(0, 0, 0);\r\n    this._point0.interpolate(fraction, this._point1, result.origin);\r\n    return result;\r\n  }\r\n\r\n  /** Clone the LineSegment3d */\r\n  public clone(): LineSegment3d { return LineSegment3d.create(this._point0, this._point1); }\r\n  /** Clone and apply transform to the clone. */\r\n  public cloneTransformed(transform: Transform): LineSegment3d {  // we know tryTransformInPlace succeeds.\r\n    const c = this.clone();\r\n    c.tryTransformInPlace(transform);\r\n    return c;\r\n  }\r\n  /** Create with start and end points.  The point contents are cloned into the LineSegment3d. */\r\n  public static create(point0: Point3d, point1: Point3d, result?: LineSegment3d): LineSegment3d {\r\n    if (result) {\r\n      result.set(point0, point1);  // and this will clone them !!\r\n      return result;\r\n    }\r\n    return new LineSegment3d(point0.clone(), point1.clone());\r\n  }\r\n\r\n  /** Create with start and end points.  The point contents are CAPTURED into the result */\r\n  public static createCapture(point0: Point3d, point1: Point3d): LineSegment3d {\r\n    return new LineSegment3d(point0, point1);\r\n  }\r\n  /** create a LineSegment3d from xy coordinates of start and end, with common z.\r\n   * @param x0 start point x coordinate.\r\n   * @param y0 start point y coordinate.\r\n   * @param x1 end point x coordinate.\r\n   * @param y1 end point y coordinate.\r\n   * @param z z coordinate to use for both points.\r\n   * @param result optional existing LineSegment to be reinitialized.\r\n   */\r\n  public static createXYXY(x0: number, y0: number, x1: number, y1: number, z: number = 0, result?: LineSegment3d) {\r\n    if (result) {\r\n      result._point0.set(x0, y0, z);\r\n      result._point1.set(x1, y1, z);\r\n      return result;\r\n    }\r\n    return new LineSegment3d(Point3d.create(x0, y0, z), Point3d.create(x1, y1, z));\r\n  }\r\n\r\n  /** create a LineSegment3d from xy coordinates of start and end, with common z.\r\n   * @param x0 start point x coordinate.\r\n   * @param y0 start point y coordinate.\r\n   * @param x1 end point x coordinate.\r\n   * @param y1 end point y coordinate.\r\n   * @param z z coordinate to use for both points.\r\n   * @param result optional existing LineSegment to be reinitialized.\r\n   */\r\n  public static createXYZXYZ(x0: number, y0: number, z0: number, x1: number, y1: number, z1: number, result?: LineSegment3d) {\r\n    if (result) {\r\n      result._point0.set(x0, y0, z0);\r\n      result._point1.set(x1, y1, z1);\r\n      return result;\r\n    }\r\n    return new LineSegment3d(Point3d.create(x0, y0, z0), Point3d.create(x1, y1, z1));\r\n  }\r\n\r\n  /** Return the point at fractional position along the line segment. */\r\n  public fractionToPoint(fraction: number, result?: Point3d): Point3d { return this._point0.interpolate(fraction, this._point1, result); }\r\n  /** Return the length of the segment. */\r\n  public override curveLength(): number { return this._point0.distance(this._point1); }\r\n  /** Return the length of the partial segment between fractions. */\r\n  public override curveLengthBetweenFractions(fraction0: number, fraction1: number): number {\r\n    return Math.abs(fraction1 - fraction0) * this._point0.distance(this._point1);\r\n  }\r\n  /** Return the length of the segment. */\r\n  public quickLength(): number { return this.curveLength(); }\r\n\r\n  /**\r\n   * Returns a curve location detail with both xyz and fractional coordinates of the closest point.\r\n   * @param spacePoint point in space\r\n   * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on the unbounded line that contains the bounded segment.\r\n   */\r\n  public override closestPoint(spacePoint: Point3d, extend: VariantCurveExtendParameter, result?: CurveLocationDetail): CurveLocationDetail {\r\n    let fraction = spacePoint.fractionOfProjectionToLine(this._point0, this._point1, 0.0);\r\n    fraction = CurveExtendOptions.correctFraction(extend, fraction);\r\n    result = CurveLocationDetail.create(this, result);\r\n    // remark: This can be done by result.setFP (fraction, thePoint, undefined, a)\r\n    //   but that creates a temporary point.\r\n    result.fraction = fraction;\r\n    this._point0.interpolate(fraction, this._point1, result.point);\r\n    result.vectorInCurveLocationDetail = undefined;\r\n    result.a = result.point.distance(spacePoint);\r\n    return result;\r\n  }\r\n  /** swap the endpoint references. */\r\n  public reverseInPlace(): void {\r\n    const a = this._point0;\r\n    this._point0 = this._point1;\r\n    this._point1 = a;\r\n  }\r\n  /** Transform the two endpoints of this LinSegment. */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    this._point0 = transform.multiplyPoint3d(this._point0, this._point0);\r\n    this._point1 = transform.multiplyPoint3d(this._point1, this._point1);\r\n    return true;\r\n  }\r\n  /** Test if both endpoints are in a plane (within tolerance) */\r\n  public isInPlane(plane: PlaneAltitudeEvaluator): boolean {\r\n    return Geometry.isSmallMetricDistance(plane.altitude(this._point0))\r\n      && Geometry.isSmallMetricDistance(plane.altitude(this._point1));\r\n  }\r\n  /** Compute points of simple (transverse) with a plane.\r\n   * * Use isInPlane to test if the line segment is completely in the plane.\r\n   */\r\n  public override appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number {\r\n    const h0 = plane.altitude(this._point0);\r\n    const h1 = plane.altitude(this._point1);\r\n    const fraction = Order2Bezier.solveCoffs(h0, h1);\r\n    let numIntersection = 0;\r\n    if (fraction !== undefined) {\r\n      numIntersection++;\r\n      const detail = CurveLocationDetail.createCurveFractionPoint(this, fraction, this.fractionToPoint(fraction));\r\n      detail.intervalRole = CurveIntervalRole.isolated;\r\n      result.push(detail);\r\n    }\r\n    return numIntersection;\r\n  }\r\n  /**\r\n   * Extend a range to include the (optionally transformed) line segment\r\n   * @param range range to extend\r\n   * @param transform optional transform to apply to the end points\r\n   */\r\n  public extendRange(range: Range3d, transform?: Transform): void {\r\n    if (transform) {\r\n      range.extendTransformedPoint(transform, this._point0);\r\n      range.extendTransformedPoint(transform, this._point1);\r\n    } else {\r\n      range.extendPoint(this._point0);\r\n      range.extendPoint(this._point1);\r\n    }\r\n  }\r\n  /**\r\n   * Construct a line from either of these json forms:\r\n   *\r\n   * * object with named start and end:\r\n   * `{startPoint: pointValue, endPoint: pointValue}`\r\n   * * array of two point values:\r\n   * `[pointValue, pointValue]`\r\n   * The point values are any values accepted by the Point3d method setFromJSON.\r\n   * @param json data to parse.\r\n   */\r\n  public setFromJSON(json?: any) {\r\n    if (!json) {\r\n      this._point0.set(0, 0, 0);\r\n      this._point1.set(1, 0, 0);\r\n      return;\r\n    } else if (json.startPoint && json.endPoint) { // {startPoint:json point, endPoint:json point}\r\n      this._point0.setFromJSON(json.startPoint);\r\n      this._point1.setFromJSON(json.endPoint);\r\n    } else if (Array.isArray(json)\r\n      && json.length > 1) { // [json point, json point]\r\n      this._point0.setFromJSON(json[0]);\r\n      this._point1.setFromJSON(json[1]);\r\n    }\r\n  }\r\n  /** A simple line segment's fraction and distance are proportional. */\r\n  public override getFractionToDistanceScale(): number | undefined { return this.curveLength(); }\r\n  /**\r\n   * Place the lineSegment3d start and points in a json object\r\n   * @return {*} [[x,y,z],[x,y,z]]\r\n   */\r\n  public toJSON(): any { return [this._point0.toJSON(), this._point1.toJSON()]; }\r\n  /** Create a new `LineSegment3d` with coordinates from json object.   See `setFromJSON` for object layout description. */\r\n  public static fromJSON(json?: any): LineSegment3d {\r\n    const result = new LineSegment3d(Point3d.createZero(), Point3d.create());\r\n    result.setFromJSON(json);\r\n    return result;\r\n  }\r\n  /** Near equality test with `other`. */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (other instanceof LineSegment3d) {\r\n      const ls = other;\r\n      return this._point0.isAlmostEqual(ls._point0) && this._point1.isAlmostEqual(ls._point1);\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /** Emit strokes to caller-supplied linestring */\r\n  public emitStrokes(dest: LineString3d, options?: StrokeOptions): void {\r\n    const numStroke = this.computeStrokeCountForOptions(options);\r\n    dest.appendFractionalStrokePoints(this, numStroke, 0.0, 1.0);\r\n  }\r\n  /** Emit strokes to caller-supplied handler */\r\n  public emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void {\r\n    handler.startCurvePrimitive(this);\r\n    const numStroke = this.computeStrokeCountForOptions(options);\r\n    handler.announceSegmentInterval(this, this._point0, this._point1, numStroke, 0.0, 1.0);\r\n    handler.endCurvePrimitive(this);\r\n  }\r\n\r\n  /**\r\n   * return the stroke count required for given options.\r\n   * @param options StrokeOptions that determine count\r\n   */\r\n  public computeStrokeCountForOptions(options?: StrokeOptions): number {\r\n    let numStroke = 1;\r\n    if (options) {\r\n      if (options.maxEdgeLength)\r\n        numStroke = options.applyMaxEdgeLength(numStroke, this.curveLength());\r\n      numStroke = options.applyMinStrokesPerPrimitive(numStroke);\r\n    }\r\n    return numStroke;\r\n  }\r\n  /** Second step of double dispatch:  call `handler.handleLineSegment3d(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handleLineSegment3d(this);\r\n  }\r\n\r\n  /**\r\n   * Find intervals of this curve primitive that are interior to a clipper\r\n   * @param clipper clip structure (e.g. clip planes)\r\n   * @param announce function to be called announcing fractional intervals\"  ` announce(fraction0, fraction1, curvePrimitive)`\r\n   */\r\n  public override announceClipIntervals(clipper: Clipper, announce?: AnnounceNumberNumberCurvePrimitive): boolean {\r\n    return clipper.announceClippedSegmentIntervals(0.0, 1.0, this._point0, this._point1,\r\n      announce ? (fraction0: number, fraction1: number) => announce(fraction0, fraction1, this) : undefined);\r\n  }\r\n\r\n  /** Return (if possible) a curve primitive which is a portion of this curve.\r\n   * @param fractionA [in] start fraction\r\n   * @param fractionB [in] end fraction\r\n   */\r\n  public override clonePartialCurve(fractionA: number, fractionB: number): LineSegment3d {\r\n    return LineSegment3d.create(this.fractionToPoint(fractionA), this.fractionToPoint(fractionB));\r\n  }\r\n  /**\r\n   * Returns a (high accuracy) range of the curve between fractional positions\r\n   * * Default implementation returns teh range of the curve from clonePartialCurve\r\n   */\r\n   public override rangeBetweenFractions(fraction0: number, fraction1: number, transform?: Transform): Range3d {\r\n    // (This is cheap -- don't bother testing for fraction0===fraction1)\r\n    if (!transform){\r\n      const range = Range3d.create();\r\n      range.extendInterpolated (this._point0, fraction0, this._point1);\r\n      range.extendInterpolated (this._point0, fraction1, this._point1);\r\n      return range;\r\n    }\r\n    const point0 = this.fractionToPoint (fraction0);\r\n    const point1 = this.fractionToPoint (fraction1);\r\n    if (transform){\r\n      transform.multiplyPoint3d (point0, point0);\r\n      transform.multiplyPoint3d (point1, point1);\r\n    }\r\n    return Range3d.create (point0, point1);\r\n  }\r\n\r\n  /**\r\n   * Construct an offset of the instance curve as viewed in the xy-plane (ignoring z).\r\n   * @param offsetDistanceOrOptions offset distance (positive to left of the instance curve), or options object\r\n   */\r\n  public override constructOffsetXY(offsetDistanceOrOptions: number | OffsetOptions): CurvePrimitive | CurvePrimitive[] | undefined {\r\n    const offsetVec = Vector3d.createStartEnd(this._point0, this._point1);\r\n    if (offsetVec.normalizeInPlace()) {\r\n      offsetVec.rotate90CCWXY(offsetVec);\r\n      const offsetDist = OffsetOptions.getOffsetDistance(offsetDistanceOrOptions);\r\n      return LineSegment3d.create(this._point0.plusScaled(offsetVec, offsetDist), this._point1.plusScaled(offsetVec, offsetDist));\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /** Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of projection.\r\n   * @param ray ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with zero origin.\r\n   * @param lowHigh optional receiver for output\r\n   * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the end of the ray.\r\n   */\r\n  public override projectedParameterRange(ray: Vector3d | Ray3d, lowHigh?: Range1d): Range1d | undefined {\r\n    return PlaneAltitudeRangeContext.findExtremeFractionsAlongDirection(this, ray, lowHigh);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"LineSegment3d.js","sourceRoot":"","sources":["../../../src/curve/LineSegment3d.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\n/** @packageDocumentation\n * @module Curve\n */\n\nimport { Clipper } from \"../clipping/ClipUtils\";\nimport { BeJSONFunctions, Geometry, PlaneAltitudeEvaluator } from \"../Geometry\";\nimport { GeometryHandler, IStrokeHandler } from \"../geometry3d/GeometryHandler\";\nimport { Plane3dByOriginAndVectors } from \"../geometry3d/Plane3dByOriginAndVectors\";\nimport { Point3d, Vector3d } from \"../geometry3d/Point3dVector3d\";\nimport { Range1d, Range3d } from \"../geometry3d/Range\";\nimport { Ray3d } from \"../geometry3d/Ray3d\";\nimport { Transform } from \"../geometry3d/Transform\";\nimport { Order2Bezier } from \"../numerics/BezierPolynomials\";\nimport { CurveExtendOptions, VariantCurveExtendParameter } from \"./CurveExtendMode\";\nimport { CurveIntervalRole, CurveLocationDetail } from \"./CurveLocationDetail\";\nimport { AnnounceNumberNumberCurvePrimitive, CurvePrimitive } from \"./CurvePrimitive\";\nimport { GeometryQuery } from \"./GeometryQuery\";\nimport { PlaneAltitudeRangeContext } from \"./internalContexts/PlaneAltitudeRangeContext\";\nimport { OffsetOptions } from \"./internalContexts/PolygonOffsetContext\";\nimport { LineString3d } from \"./LineString3d\";\nimport { StrokeOptions } from \"./StrokeOptions\";\n\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\n\n/**\n * A LineSegment3d is:\n * * A 3d line segment represented by its start and end coordinates\n *   * startPoint\n *   * endPoint\n * * The segment is parameterized with fraction 0 at the start and fraction 1 at the end, i.e. each of these\n * equivalent forms maps fraction `f` to a point `X(f)`:\n * ```\n * equation\n *  X(f) = P_0 + f*(P_1 - P_0)\\newline\n *  X(f) = (1-f)*P_0 + f*P_1\n * ```\n * @public\n */\nexport class LineSegment3d extends CurvePrimitive implements BeJSONFunctions {\n  /** String name for schema properties */\n  public readonly curvePrimitiveType = \"lineSegment\";\n  /** Test if `other` is of class `LineSegment3d` */\n  public isSameGeometryClass(other: GeometryQuery): boolean {\n    return other instanceof LineSegment3d;\n  }\n  /** Start point of the segment */\n  private _point0: Point3d;\n  /** End point of the segment */\n  private _point1: Point3d;\n  /**\n   * Return REFERENCE to the start point of this segment.\n   * * This is distinct from the `CurvePrimitive` abstract method `startPoint()` which creates a returned point.\n   */\n  public get point0Ref(): Point3d {\n    return this._point0;\n  }\n  /**\n   * Return REFERENCE to the end point of this segment.\n   * * This is distinct from the `CurvePrimitive` abstract method `endPoint()` which creates a returned point.\n   */\n  public get point1Ref(): Point3d {\n    return this._point1;\n  }\n  /** A LineSegment3d extends along its infinite line. */\n  public override get isExtensibleFractionSpace(): boolean {\n    return true;\n  }\n  /**\n   * CAPTURE point references as a `LineSegment3d`\n   * @param point0\n   * @param point1\n   */\n  protected constructor(point0: Point3d, point1: Point3d) {\n    super();\n    this._point0 = point0;\n    this._point1 = point1;\n  }\n  /** Set the start and endpoints by capturing input references. */\n  public setRefs(point0: Point3d, point1: Point3d) {\n    this._point0 = point0;\n    this._point1 = point1;\n  }\n  /** Set the start and endpoints by cloning the input parameters. */\n  public set(point0: Point3d, point1: Point3d) {\n    this._point0 = point0.clone();\n    this._point1 = point1.clone();\n  }\n  /** Copy (clone) data from other */\n  public setFrom(other: LineSegment3d) {\n    this._point0.setFrom(other._point0);\n    this._point1.setFrom(other._point1);\n  }\n  /** Return a (clone of) the start point (This is NOT a reference to the stored start point) */\n  public override startPoint(result?: Point3d): Point3d {\n    if (result) { result.setFrom(this._point0); return result; }\n    return this._point0.clone();\n  }\n  /** Return a (clone of) the end point (This is NOT a reference to the stored end point) */\n  public override endPoint(result?: Point3d): Point3d {\n    if (result) { result.setFrom(this._point1); return result; }\n    return this._point1.clone();\n  }\n  /** Return the point and derivative vector at fractional position along the line segment. */\n  public fractionToPointAndDerivative(fraction: number, result?: Ray3d): Ray3d {\n    result = result ? result : Ray3d.createZero();\n    result.direction.setStartEnd(this._point0, this._point1);\n    this._point0.interpolate(fraction, this._point1, result.origin);\n    return result;\n  }\n  /**\n   * Construct a plane with\n   * * origin at the fractional position along the line segment\n   * * x axis is the first derivative, i.e. along the line segment\n   * * y axis is the second derivative, i.e. 000\n   */\n  public fractionToPointAnd2Derivatives(fraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\n    result = result ? result : Plane3dByOriginAndVectors.createXYPlane();\n    result.vectorU.setStartEnd(this._point0, this._point1);\n    result.vectorV.set(0, 0, 0);\n    this._point0.interpolate(fraction, this._point1, result.origin);\n    return result;\n  }\n  /** Clone the LineSegment3d */\n  public clone(): LineSegment3d {\n    return LineSegment3d.create(this._point0, this._point1);\n  }\n  /** Clone and apply transform to the clone. */\n  public cloneTransformed(transform: Transform): LineSegment3d {  // we know tryTransformInPlace succeeds.\n    const c = this.clone();\n    c.tryTransformInPlace(transform);\n    return c;\n  }\n  /** Create with start and end points.  The point contents are cloned into the LineSegment3d. */\n  public static create(point0: Point3d, point1: Point3d, result?: LineSegment3d): LineSegment3d {\n    if (result) {\n      result.set(point0, point1);  // and this will clone them !!\n      return result;\n    }\n    return new LineSegment3d(point0.clone(), point1.clone());\n  }\n  /** Create with start and end points.  The point contents are CAPTURED into the result */\n  public static createCapture(point0: Point3d, point1: Point3d): LineSegment3d {\n    return new LineSegment3d(point0, point1);\n  }\n  /**\n   * Create a LineSegment3d from xy coordinates of start and end, with common z.\n   * @param x0 start point x coordinate.\n   * @param y0 start point y coordinate.\n   * @param x1 end point x coordinate.\n   * @param y1 end point y coordinate.\n   * @param z z coordinate to use for both points.\n   * @param result optional existing LineSegment to be reinitialized.\n   */\n  public static createXYXY(x0: number, y0: number, x1: number, y1: number, z: number = 0, result?: LineSegment3d) {\n    if (result) {\n      result._point0.set(x0, y0, z);\n      result._point1.set(x1, y1, z);\n      return result;\n    }\n    return new LineSegment3d(Point3d.create(x0, y0, z), Point3d.create(x1, y1, z));\n  }\n  /**\n   * Create a LineSegment3d from xy coordinates of start and end, with common z.\n   * @param x0 start point x coordinate.\n   * @param y0 start point y coordinate.\n   * @param x1 end point x coordinate.\n   * @param y1 end point y coordinate.\n   * @param z z coordinate to use for both points.\n   * @param result optional existing LineSegment to be reinitialized.\n   */\n  public static createXYZXYZ(\n    x0: number, y0: number, z0: number, x1: number, y1: number, z1: number, result?: LineSegment3d\n  ): LineSegment3d {\n    if (result) {\n      result._point0.set(x0, y0, z0);\n      result._point1.set(x1, y1, z1);\n      return result;\n    }\n    return new LineSegment3d(Point3d.create(x0, y0, z0), Point3d.create(x1, y1, z1));\n  }\n  /** Return the point at fractional position along the line segment. */\n  public fractionToPoint(fraction: number, result?: Point3d): Point3d {\n    return this._point0.interpolate(fraction, this._point1, result);\n  }\n  /** Return the length of the segment. */\n  public override curveLength(): number {\n    return this._point0.distance(this._point1);\n  }\n  /** Return the length of the partial segment between fractions. */\n  public override curveLengthBetweenFractions(fraction0: number, fraction1: number): number {\n    return Math.abs(fraction1 - fraction0) * this._point0.distance(this._point1);\n  }\n  /** Return the length of the segment. */\n  public quickLength(): number {\n    return this.curveLength();\n  }\n  /**\n   * Returns a curve location detail with both xyz and fractional coordinates of the closest point.\n   * @param spacePoint point in space\n   * @param extend if false, only return points within the bounded line segment. If true, allow the point to be on\n   * the unbounded line that contains the bounded segment.\n   */\n  public override closestPoint(\n    spacePoint: Point3d, extend: VariantCurveExtendParameter, result?: CurveLocationDetail\n  ): CurveLocationDetail {\n    let fraction = spacePoint.fractionOfProjectionToLine(this._point0, this._point1, 0.0);\n    fraction = CurveExtendOptions.correctFraction(extend, fraction);\n    result = CurveLocationDetail.create(this, result);\n    // remark: This can be done by result.setFP (fraction, thePoint, undefined, a)\n    //   but that creates a temporary point.\n    result.fraction = fraction;\n    this._point0.interpolate(fraction, this._point1, result.point);\n    result.vectorInCurveLocationDetail = undefined;\n    result.a = result.point.distance(spacePoint);\n    return result;\n  }\n  /** Swap the endpoint references. */\n  public reverseInPlace(): void {\n    const a = this._point0;\n    this._point0 = this._point1;\n    this._point1 = a;\n  }\n  /** Transform the two endpoints of this LinSegment. */\n  public tryTransformInPlace(transform: Transform): boolean {\n    this._point0 = transform.multiplyPoint3d(this._point0, this._point0);\n    this._point1 = transform.multiplyPoint3d(this._point1, this._point1);\n    return true;\n  }\n  /** Test if both endpoints are in a plane (within tolerance) */\n  public isInPlane(plane: PlaneAltitudeEvaluator): boolean {\n    return Geometry.isSmallMetricDistance(plane.altitude(this._point0))\n      && Geometry.isSmallMetricDistance(plane.altitude(this._point1));\n  }\n  /**\n   * Compute points of simple (transverse) with a plane.\n   * * Use isInPlane to test if the line segment is completely in the plane.\n   */\n  public override appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number {\n    const h0 = plane.altitude(this._point0);\n    const h1 = plane.altitude(this._point1);\n    const fraction = Order2Bezier.solveCoffs(h0, h1);\n    let numIntersection = 0;\n    if (fraction !== undefined) {\n      numIntersection++;\n      const detail = CurveLocationDetail.createCurveFractionPoint(this, fraction, this.fractionToPoint(fraction));\n      detail.intervalRole = CurveIntervalRole.isolated;\n      result.push(detail);\n    }\n    return numIntersection;\n  }\n  /**\n   * Extend a range to include the (optionally transformed) line segment\n   * @param range range to extend\n   * @param transform optional transform to apply to the end points\n   */\n  public extendRange(range: Range3d, transform?: Transform): void {\n    if (transform) {\n      range.extendTransformedPoint(transform, this._point0);\n      range.extendTransformedPoint(transform, this._point1);\n    } else {\n      range.extendPoint(this._point0);\n      range.extendPoint(this._point1);\n    }\n  }\n  /**\n   * Construct a line from either of these json forms:\n   *\n   * * object with named start and end:\n   * `{startPoint: pointValue, endPoint: pointValue}`\n   * * array of two point values:\n   * `[pointValue, pointValue]`\n   * The point values are any values accepted by the Point3d method setFromJSON.\n   * @param json data to parse.\n   */\n  public setFromJSON(json?: any) {\n    if (!json) {\n      this._point0.set(0, 0, 0);\n      this._point1.set(1, 0, 0);\n      return;\n    } else if (json.startPoint && json.endPoint) { // {startPoint:json point, endPoint:json point}\n      this._point0.setFromJSON(json.startPoint);\n      this._point1.setFromJSON(json.endPoint);\n    } else if (Array.isArray(json)\n      && json.length > 1) { // [json point, json point]\n      this._point0.setFromJSON(json[0]);\n      this._point1.setFromJSON(json[1]);\n    }\n  }\n  /** A simple line segment's fraction and distance are proportional. */\n  public override getFractionToDistanceScale(): number | undefined {\n    return this.curveLength();\n  }\n  /**\n   * Place the lineSegment3d start and points in a json object\n   * @return {*} [[x,y,z],[x,y,z]]\n   */\n  public toJSON(): any {\n    return [this._point0.toJSON(), this._point1.toJSON()];\n  }\n  /** Create a new `LineSegment3d` with coordinates from json object.   See `setFromJSON` for object layout description. */\n  public static fromJSON(json?: any): LineSegment3d {\n    const result = new LineSegment3d(Point3d.createZero(), Point3d.create());\n    result.setFromJSON(json);\n    return result;\n  }\n  /** Near equality test with `other`. */\n  public override isAlmostEqual(other: GeometryQuery): boolean {\n    if (other instanceof LineSegment3d) {\n      const ls = other;\n      return this._point0.isAlmostEqual(ls._point0) && this._point1.isAlmostEqual(ls._point1);\n    }\n    return false;\n  }\n  /** Emit strokes to caller-supplied linestring */\n  public emitStrokes(dest: LineString3d, options?: StrokeOptions): void {\n    const numStroke = this.computeStrokeCountForOptions(options);\n    dest.appendFractionalStrokePoints(this, numStroke, 0.0, 1.0);\n  }\n  /** Emit strokes to caller-supplied handler */\n  public emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void {\n    handler.startCurvePrimitive(this);\n    const numStroke = this.computeStrokeCountForOptions(options);\n    handler.announceSegmentInterval(this, this._point0, this._point1, numStroke, 0.0, 1.0);\n    handler.endCurvePrimitive(this);\n  }\n  /**\n   * Return the stroke count required for given options.\n   * @param options StrokeOptions that determine count\n   */\n  public computeStrokeCountForOptions(options?: StrokeOptions): number {\n    let numStroke = 1;\n    if (options) {\n      if (options.maxEdgeLength)\n        numStroke = options.applyMaxEdgeLength(numStroke, this.curveLength());\n      numStroke = options.applyMinStrokesPerPrimitive(numStroke);\n    }\n    return numStroke;\n  }\n  /** Second step of double dispatch: call `handler.handleLineSegment3d(this)` */\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\n    return handler.handleLineSegment3d(this);\n  }\n  /**\n   * Find intervals of this curve primitive that are interior to a clipper\n   * @param clipper clip structure (e.g. clip planes)\n   * @param announce function to be called announcing fractional intervals `announce(fraction0, fraction1, curvePrimitive)`\n   */\n  public override announceClipIntervals(clipper: Clipper, announce?: AnnounceNumberNumberCurvePrimitive): boolean {\n    return clipper.announceClippedSegmentIntervals(0.0, 1.0, this._point0, this._point1,\n      announce ? (fraction0: number, fraction1: number) => announce(fraction0, fraction1, this) : undefined);\n  }\n  /**\n   * Return (if possible) a curve primitive which is a portion of this curve.\n   * @param fractionA [in] start fraction\n   * @param fractionB [in] end fraction\n   */\n  public override clonePartialCurve(fractionA: number, fractionB: number): LineSegment3d {\n    return LineSegment3d.create(this.fractionToPoint(fractionA), this.fractionToPoint(fractionB));\n  }\n  /**\n   * Returns a (high accuracy) range of the curve between fractional positions\n   * * Default implementation returns teh range of the curve from clonePartialCurve\n   */\n  public override rangeBetweenFractions(fraction0: number, fraction1: number, transform?: Transform): Range3d {\n    // (This is cheap -- don't bother testing for fraction0===fraction1)\n    if (!transform) {\n      const range = Range3d.create();\n      range.extendInterpolated(this._point0, fraction0, this._point1);\n      range.extendInterpolated(this._point0, fraction1, this._point1);\n      return range;\n    }\n    const point0 = this.fractionToPoint(fraction0);\n    const point1 = this.fractionToPoint(fraction1);\n    if (transform) {\n      transform.multiplyPoint3d(point0, point0);\n      transform.multiplyPoint3d(point1, point1);\n    }\n    return Range3d.create(point0, point1);\n  }\n  /**\n   * Construct an offset of the instance curve as viewed in the xy-plane (ignoring z).\n   * @param offsetDistanceOrOptions offset distance (positive to left of the instance curve), or options object\n   */\n  public override constructOffsetXY(\n    offsetDistanceOrOptions: number | OffsetOptions\n  ): CurvePrimitive | CurvePrimitive[] | undefined {\n    const offsetVec = Vector3d.createStartEnd(this._point0, this._point1);\n    if (offsetVec.normalizeInPlace()) {\n      offsetVec.rotate90CCWXY(offsetVec);\n      const offsetDist = OffsetOptions.getOffsetDistance(offsetDistanceOrOptions);\n      return LineSegment3d.create(\n        this._point0.plusScaled(offsetVec, offsetDist), this._point1.plusScaled(offsetVec, offsetDist)\n      );\n    }\n    return undefined;\n  }\n  /**\n   * Project instance geometry (via dispatch) onto the given ray, and return the extreme fractional parameters of\n   * projection.\n   * @param ray ray onto which the instance is projected. A `Vector3d` is treated as a `Ray3d` with zero origin.\n   * @param lowHigh optional receiver for output\n   * @returns range of fractional projection parameters onto the ray, where 0.0 is start of the ray and 1.0 is the\n   * end of the ray.\n   */\n  public override projectedParameterRange(ray: Vector3d | Ray3d, lowHigh?: Range1d): Range1d | undefined {\n    return PlaneAltitudeRangeContext.findExtremeFractionsAlongDirection(this, ray, lowHigh);\n  }\n}\n"]}