@itwin/core-geometry 3.0.0-dev.76 → 3.0.0-dev.80

package/lib/esm/curve/GeometryQuery.js

@@ -0,0 +1,68 @@
+import { Range3d } from "../geometry3d/Range";
+import { Transform } from "../geometry3d/Transform";
+/** Queries to be supported by Curve, Surface, and Solid objects */
+/**
+ * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh, and bspline surfaces
+ * @public
+ */
+export class GeometryQuery {
+    /** return the range of the entire (tree) GeometryQuery */
+    range(transform, result) {
+        if (result)
+            result.setNull();
+        const range = result ? result : Range3d.createNull();
+        this.extendRange(range, transform);
+        return range;
+    }
+    /** try to move the geometry by dx,dy,dz */
+    tryTranslateInPlace(dx, dy = 0.0, dz = 0.0) {
+        return this.tryTransformInPlace(Transform.createTranslationXYZ(dx, dy, dz));
+    }
+    /** return GeometryQuery children for recursive queries.
+     *
+     * * leaf classes do not need to implement.
+     */
+    get children() { return undefined; }
+    /** test for exact structure and nearly identical geometry.
+     *
+     * *  Leaf classes must implement !!!
+     * *  base class implementation recurses through children.
+     * *  base implementation is complete for classes with children and no properties.
+     * *  classes with both children and properties must implement for properties, call super for children.
+     */
+    isAlmostEqual(other) {
+        if (this.isSameGeometryClass(other)) {
+            const childrenA = this.children;
+            const childrenB = other.children;
+            if (childrenA && childrenB) {
+                if (childrenA.length !== childrenB.length)
+                    return false;
+                for (let i = 0; i < childrenA.length; i++) {
+                    if (!childrenA[i].isAlmostEqual(childrenB[i]))
+                        return false;
+                }
+                return true;
+            }
+            else if (childrenA || childrenB) { // CurveCollections start with empty arrays for children.  So these null pointer cases are never reached.
+                return false; // plainly different .
+            }
+            else {
+                // both children null. call it equal?   This class should probably have implemented.
+                return true;
+            }
+        }
+        return false;
+    }
+    /** apply instance method isAlmostEqual if both are defined.
+     * * both undefined returns true
+     * * single defined returns false
+     */
+    static areAlmostEqual(a, b) {
+        if (a instanceof GeometryQuery && b instanceof GeometryQuery)
+            return a.isAlmostEqual(b);
+        if ((a === undefined) && (b === undefined))
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=GeometryQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeometryQuery.js","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAmCpD,mEAAmE;AACnE;;;GAGG;AACH,MAAM,OAAgB,aAAa;IAIjC,0DAA0D;IACnD,KAAK,CAAC,SAAqB,EAAE,MAAgB;QAClD,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACrD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAYD,2CAA2C;IACpC,mBAAmB,CAAC,EAAU,EAAE,KAAa,GAAG,EAAE,KAAa,GAAG;QACvE,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAMD;;;OAGG;IACH,IAAW,QAAQ,KAAkC,OAAO,SAAS,CAAC,CAAC,CAAC;IAGxE;;;;;;OAMG;IACI,aAAa,CAAC,KAAoB;QACvC,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;YAChC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACjC,IAAI,SAAS,IAAI,SAAS,EAAE;gBAC1B,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;oBACvC,OAAO,KAAK,CAAC;gBACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACzC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;wBAAE,OAAO,KAAK,CAAC;iBAC7D;gBACD,OAAO,IAAI,CAAC;aACb;iBAAM,IAAI,SAAS,IAAI,SAAS,EAAE,EAAG,yGAAyG;gBAC7I,OAAO,KAAK,CAAC,CAAG,sBAAsB;aACvC;iBAAM;gBACL,oFAAoF;gBACpF,OAAO,IAAI,CAAC;aACb;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,cAAc,CAAC,CAA4B,EAAE,CAA4B;QACrF,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,YAAY,aAAa;YAC1D,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;CASF","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/** @packageDocumentation\r\n * @module Curve\r\n */\r\nimport { BSpline2dNd } from \"../bspline/BSplineSurface\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { Polyface } from \"../polyface/Polyface\";\r\nimport { SolidPrimitive } from \"../solid/SolidPrimitive\";\r\nimport { CoordinateXYZ } from \"./CoordinateXYZ\";\r\nimport { CurveCollection } from \"./CurveCollection\";\r\nimport { CurvePrimitive } from \"./CurvePrimitive\";\r\nimport { PointString3d } from \"./PointString3d\";\r\n\r\n/** Describes the category of a [[GeometryQuery]], enabling type-switching like:\r\n * ```ts\r\n *   function processGeometryQuery(q: GeometryQuery): void {\r\n *     if (\"solid\" === q.geometryCategory)\r\n *       alert(\"Solid type = \" + q.solidPrimitiveType; // compiler knows q is an instance of SolidPrimitive\r\n *    // ...etc...\r\n * ```\r\n *\r\n * Each string maps to a particular subclass of [[GeometryQuery]]:\r\n *  - \"polyface\" => [[Polyface]]\r\n *  - \"curvePrimitive\" => [[CurvePrimitive]]\r\n *  - \"curveCollection\" => [[CurveCollection]]\r\n *  - \"solid\" => [[SolidPrimitive]]\r\n *  - \"point\" => [[CoordinateXYZ]]\r\n *  - \"pointCollection\" => [[PointString3d]]\r\n *  - \"bsurf\" => [[BSpline2dNd]]  (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])\r\n *\r\n *  @see [[AnyGeometryQuery]]\r\n * @public\r\n */\r\nexport type GeometryQueryCategory = \"polyface\" | \"curvePrimitive\" | \"curveCollection\" | \"solid\" | \"point\" | \"pointCollection\" | \"bsurf\";\r\n\r\n/** Union type for subclasses of [[GeometryQuery]]. Specific subclasses can be discriminated at compile- or run-time using [[GeometryQuery.geometryCategory]].\r\n * @public\r\n */\r\nexport type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;\r\n\r\n/** Queries to be supported by Curve, Surface, and Solid objects */\r\n/**\r\n * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh, and bspline surfaces\r\n * @public\r\n */\r\nexport abstract class GeometryQuery {\r\n  /** Type discriminator. */\r\n  public abstract readonly geometryCategory: GeometryQueryCategory;\r\n\r\n  /** return the range of the entire (tree) GeometryQuery */\r\n  public range(transform?: Transform, result?: Range3d): Range3d {\r\n    if (result) result.setNull();\r\n    const range = result ? result : Range3d.createNull();\r\n    this.extendRange(range, transform);\r\n    return range;\r\n  }\r\n\r\n  /** extend rangeToExtend by the range of this geometry multiplied by the transform */\r\n  public abstract extendRange(rangeToExtend: Range3d, transform?: Transform): void;\r\n\r\n  /** Attempt to transform in place.\r\n   *\r\n   * * LineSegment3d, Arc3d, LineString3d, BsplineCurve3d always succeed.\r\n   * * Some geometry types may fail if scaling is non-uniform.\r\n   */\r\n  public abstract tryTransformInPlace(transform: Transform): boolean;\r\n\r\n  /** try to move the geometry by dx,dy,dz */\r\n  public tryTranslateInPlace(dx: number, dy: number = 0.0, dz: number = 0.0): boolean {\r\n    return this.tryTransformInPlace(Transform.createTranslationXYZ(dx, dy, dz));\r\n  }\r\n  /** return a transformed clone.\r\n   */\r\n  public abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;\r\n  /** return a clone */\r\n  public abstract clone(): GeometryQuery | undefined;\r\n  /** return GeometryQuery children for recursive queries.\r\n   *\r\n   * * leaf classes do not need to implement.\r\n   */\r\n  public get children(): GeometryQuery[] | undefined { return undefined; }\r\n  /** test if (other instanceof this.Type).  REQUIRED IN ALL CONCRETE CLASSES */\r\n  public abstract isSameGeometryClass(other: GeometryQuery): boolean;\r\n  /** test for exact structure and nearly identical geometry.\r\n   *\r\n   * *  Leaf classes must implement !!!\r\n   * *  base class implementation recurses through children.\r\n   * *  base implementation is complete for classes with children and no properties.\r\n   * *  classes with both children and properties must implement for properties, call super for children.\r\n   */\r\n  public isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (this.isSameGeometryClass(other)) {\r\n      const childrenA = this.children;\r\n      const childrenB = other.children;\r\n      if (childrenA && childrenB) {\r\n        if (childrenA.length !== childrenB.length)\r\n          return false;\r\n        for (let i = 0; i < childrenA.length; i++) {\r\n          if (!childrenA[i].isAlmostEqual(childrenB[i])) return false;\r\n        }\r\n        return true;\r\n      } else if (childrenA || childrenB) {  // CurveCollections start with empty arrays for children.  So these null pointer cases are never reached.\r\n        return false;   // plainly different .\r\n      } else {\r\n        // both children null. call it equal?   This class should probably have implemented.\r\n        return true;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n  /** apply instance method isAlmostEqual if both are defined.\r\n   * * both undefined returns true\r\n   * * single defined returns false\r\n   */\r\n  public static areAlmostEqual(a: GeometryQuery | undefined, b: GeometryQuery | undefined): boolean {\r\n    if (a instanceof GeometryQuery && b instanceof GeometryQuery)\r\n      return a.isAlmostEqual(b);\r\n    if ((a === undefined) && (b === undefined))\r\n      return true;\r\n    return false;\r\n  }\r\n  /**\r\n   * * \"double dispatch\" call pattern.\r\n   * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d` etc as relevant to its use case.\r\n   * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call such as `handler.handleLineSegment3d ()`\r\n   * * This allows each type-specific method to be called without a switch or `instanceof` test.\r\n   * @param handler handler to be called by the particular geometry class\r\n   */\r\n  public abstract dispatchToGeometryHandler(handler: GeometryHandler): any;\r\n}\r\n"]}

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

@@ -0,0 +1,176 @@
+/** @packageDocumentation
+ * @module Curve
+ */
+import { Clipper } from "../clipping/ClipUtils";
+import { BeJSONFunctions, PlaneAltitudeEvaluator } from "../Geometry";
+import { GeometryHandler, IStrokeHandler } from "../geometry3d/GeometryHandler";
+import { Plane3dByOriginAndVectors } from "../geometry3d/Plane3dByOriginAndVectors";
+import { Point3d } from "../geometry3d/Point3dVector3d";
+import { Range3d } from "../geometry3d/Range";
+import { Ray3d } from "../geometry3d/Ray3d";
+import { Transform } from "../geometry3d/Transform";
+import { VariantCurveExtendParameter } from "./CurveExtendMode";
+import { CurveLocationDetail } from "./CurveLocationDetail";
+import { AnnounceNumberNumberCurvePrimitive, CurvePrimitive } from "./CurvePrimitive";
+import { GeometryQuery } from "./GeometryQuery";
+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)`
+ * ```
+ * equation
+ *  X(f) = P_0 + f * (P_1 - P_0)\newline
+ *  X(f) = (1-f)*P_0  + f * P_0
+ * ```
+ * @public
+ */
+export declare class LineSegment3d extends CurvePrimitive implements BeJSONFunctions {
+    /** String name for schema properties */
+    readonly curvePrimitiveType = "lineSegment";
+    /** test if `other` is of class `LineSegment3d` */
+    isSameGeometryClass(other: GeometryQuery): boolean;
+    private _point0;
+    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
+     */
+    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.
+     */
+    get isExtensibleFractionSpace(): boolean;
+    /**
+     * CAPTURE point references as a `LineSegment3d`
+     * @param point0
+     * @param point1
+     */
+    protected constructor(point0: Point3d, point1: Point3d);
+    /** Set the start and endpoints by capturing input references. */
+    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 */
+    setFrom(other: LineSegment3d): void;
+    /** 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) */
+    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
+     * * 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
+     */
+    fractionToPointAnd2Derivatives(fraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
+    /** Clone the LineSegment3d */
+    clone(): LineSegment3d;
+    /** Clone and apply transform to the clone. */
+    cloneTransformed(transform: Transform): CurvePrimitive;
+    /** Create with start and end points.  The point contents are cloned into the LineSegment3d. */
+    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.
+     * @param x0 start point x coordinate.
+     * @param y0 start point y coordinate.
+     * @param x1 end point x coordinate.
+     * @param y1 end point y coordinate.
+     * @param z z coordinate to use for both points.
+     * @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.
+     * @param x0 start point x coordinate.
+     * @param y0 start point y coordinate.
+     * @param x1 end point x coordinate.
+     * @param y1 end point y coordinate.
+     * @param z z coordinate to use for both points.
+     * @param result optional existing LineSegment to be reinitialized.
+     */
+    static createXYZXYZ(x0: number, y0: number, z0: number, x1: number, y1: number, z1: number, result?: LineSegment3d): LineSegment3d;
+    /** Return the point at fractional position along the line segment. */
+    fractionToPoint(fraction: number, result?: Point3d): Point3d;
+    /** Return the length of the segment. */
+    curveLength(): number;
+    /** Return the length of the partial segment between fractions. */
+    curveLengthBetweenFractions(fraction0: number, fraction1: number): number;
+    /** Return the length of the segment. */
+    quickLength(): number;
+    /**
+     * 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.
+     */
+    closestPoint(spacePoint: Point3d, extend: VariantCurveExtendParameter, result?: CurveLocationDetail): CurveLocationDetail;
+    /** 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.
+     * * Use isInPlane to test if the line segment is completely in the plane.
+     */
+    appendPlaneIntersectionPoints(plane: PlaneAltitudeEvaluator, result: CurveLocationDetail[]): number;
+    /**
+     * Extend a range to include the (optionally transformed) line segment
+     * @param range range to extend
+     * @param transform optional transform to apply to the end points
+     */
+    extendRange(range: Range3d, transform?: Transform): void;
+    /**
+     * Construct a line from either of these json forms:
+     *
+     * * object with named start and end:
+     * `{startPoint: pointValue, endPoint: pointValue}`
+     * * array of two point values:
+     * `[pointValue, pointValue]`
+     * The point values are any values accepted by the Point3d method setFromJSON.
+     * @param json data to parse.
+     */
+    setFromJSON(json?: any): void;
+    /** A simple line segment's fraction and distance are proportional. */
+    getFractionToDistanceScale(): number | undefined;
+    /**
+     * Place the lineSegment3d start and points in a json object
+     * @return {*} [[x,y,z],[x,y,z]]
+     */
+    toJSON(): any;
+    /** Create a new `LineSegment3d` with coordinates from json object.   See `setFromJSON` for object layout description. */
+    static fromJSON(json?: any): LineSegment3d;
+    /** Near equality test with `other`. */
+    isAlmostEqual(other: GeometryQuery): boolean;
+    /** Emit strokes to caller-supplied linestring */
+    emitStrokes(dest: LineString3d, options?: StrokeOptions): void;
+    /** Emit strokes to caller-supplied handler */
+    emitStrokableParts(handler: IStrokeHandler, options?: StrokeOptions): void;
+    /**
+     * 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)` */
+    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)`
+     */
+    announceClipIntervals(clipper: Clipper, announce?: AnnounceNumberNumberCurvePrimitive): boolean;
+    /** Return (if possible) a curve primitive which is a portion of this curve.
+     * @param fractionA [in] start fraction
+     * @param fractionB [in] end fraction
+     */
+    clonePartialCurve(fractionA: number, fractionB: number): CurvePrimitive | undefined;
+}
+//# sourceMappingURL=LineSegment3d.d.ts.map

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

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

package/lib/esm/curve/LineSegment3d.js

@@ -0,0 +1,315 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Geometry } from "../Geometry";
+import { Plane3dByOriginAndVectors } from "../geometry3d/Plane3dByOriginAndVectors";
+import { Point3d } from "../geometry3d/Point3dVector3d";
+import { Ray3d } from "../geometry3d/Ray3d";
+import { Order2Bezier } from "../numerics/BezierPolynomials";
+import { CurveExtendOptions } from "./CurveExtendMode";
+import { CurveIntervalRole, CurveLocationDetail } from "./CurveLocationDetail";
+import { CurvePrimitive } from "./CurvePrimitive";
+/* 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)`
+ * ```
+ * equation
+ *  X(f) = P_0 + f * (P_1 - P_0)\newline
+ *  X(f) = (1-f)*P_0  + f * P_0
+ * ```
+ * @public
+ */
+export class LineSegment3d extends CurvePrimitive {
+    /**
+     * CAPTURE point references as a `LineSegment3d`
+     * @param point0
+     * @param point1
+     */
+    constructor(point0, point1) {
+        super();
+        /** String name for schema properties */
+        this.curvePrimitiveType = "lineSegment";
+        this._point0 = point0;
+        this._point1 = point1;
+    }
+    /** 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
+     */
+    get point1Ref() { return this._point1; }
+    /**
+     * A LineSegment3d extends along its infinite line.
+     */
+    get isExtensibleFractionSpace() { return true; }
+    /** Set the start and endpoints by capturing input references. */
+    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) */
+    startPoint(result) {
+        if (result) {
+            result.setFrom(this._point0);
+            return result;
+        }
+        return this._point0.clone();
+    }
+    /** 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);
+            return result;
+        }
+        return this._point1.clone();
+    }
+    /** Return the point and derivative vector at fractional position along the line segment. */
+    fractionToPointAndDerivative(fraction, result) {
+        result = result ? result : Ray3d.createZero();
+        result.direction.setStartEnd(this._point0, this._point1);
+        this._point0.interpolate(fraction, this._point1, result.origin);
+        return result;
+    }
+    /** 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
+     */
+    fractionToPointAnd2Derivatives(fraction, result) {
+        result = result ? result : Plane3dByOriginAndVectors.createXYPlane();
+        result.vectorU.setStartEnd(this._point0, this._point1);
+        result.vectorV.set(0, 0, 0);
+        this._point0.interpolate(fraction, this._point1, result.origin);
+        return result;
+    }
+    /** Clone the LineSegment3d */
+    clone() { return LineSegment3d.create(this._point0, this._point1); }
+    /** Clone and apply transform to the clone. */
+    cloneTransformed(transform) {
+        const c = this.clone();
+        c.tryTransformInPlace(transform);
+        return c;
+    }
+    /** Create with start and end points.  The point contents are cloned into the LineSegment3d. */
+    static create(point0, point1, result) {
+        if (result) {
+            result.set(point0, point1); // and this will clone them !!
+            return result;
+        }
+        return new LineSegment3d(point0.clone(), point1.clone());
+    }
+    /** Create with start and end points.  The point contents are CAPTURED into the result */
+    static createCapture(point0, point1) {
+        return new LineSegment3d(point0, point1);
+    }
+    /** 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.
+     * @param y1 end point y coordinate.
+     * @param z z coordinate to use for both points.
+     * @param result optional existing LineSegment to be reinitialized.
+     */
+    static createXYXY(x0, y0, x1, y1, z = 0, result) {
+        if (result) {
+            result._point0.set(x0, y0, z);
+            result._point1.set(x1, y1, z);
+            return result;
+        }
+        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.
+     * @param x0 start point x coordinate.
+     * @param y0 start point y coordinate.
+     * @param x1 end point x coordinate.
+     * @param y1 end point y coordinate.
+     * @param z z coordinate to use for both points.
+     * @param result optional existing LineSegment to be reinitialized.
+     */
+    static createXYZXYZ(x0, y0, z0, x1, y1, z1, result) {
+        if (result) {
+            result._point0.set(x0, y0, z0);
+            result._point1.set(x1, y1, z1);
+            return result;
+        }
+        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); }
+    /** Return the length of the segment. */
+    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(); }
+    /**
+     * 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.
+     */
+    closestPoint(spacePoint, extend, result) {
+        let fraction = spacePoint.fractionOfProjectionToLine(this._point0, this._point1, 0.0);
+        fraction = CurveExtendOptions.correctFraction(extend, fraction);
+        result = CurveLocationDetail.create(this, result);
+        // remark: This can be done by result.setFP (fraction, thePoint, undefined, a)
+        //   but that creates a temporary point.
+        result.fraction = fraction;
+        this._point0.interpolate(fraction, this._point1, result.point);
+        result.vectorInCurveLocationDetail = undefined;
+        result.a = result.point.distance(spacePoint);
+        return result;
+    }
+    /** swap the endpoint references. */
+    reverseInPlace() {
+        const a = this._point0;
+        this._point0 = this._point1;
+        this._point1 = a;
+    }
+    /** Transform the two endpoints of this LinSegment. */
+    tryTransformInPlace(transform) {
+        this._point0 = transform.multiplyPoint3d(this._point0, this._point0);
+        this._point1 = transform.multiplyPoint3d(this._point1, this._point1);
+        return true;
+    }
+    /** Test if both endpoints are in a plane (within tolerance) */
+    isInPlane(plane) {
+        return Geometry.isSmallMetricDistance(plane.altitude(this._point0))
+            && Geometry.isSmallMetricDistance(plane.altitude(this._point1));
+    }
+    /** Compute points of simple (transverse) with a plane.
+     * * Use isInPlane to test if the line segment is completely in the plane.
+     */
+    appendPlaneIntersectionPoints(plane, result) {
+        const h0 = plane.altitude(this._point0);
+        const h1 = plane.altitude(this._point1);
+        const fraction = Order2Bezier.solveCoffs(h0, h1);
+        let numIntersection = 0;
+        if (fraction !== undefined) {
+            numIntersection++;
+            const detail = CurveLocationDetail.createCurveFractionPoint(this, fraction, this.fractionToPoint(fraction));
+            detail.intervalRole = CurveIntervalRole.isolated;
+            result.push(detail);
+        }
+        return numIntersection;
+    }
+    /**
+     * Extend a range to include the (optionally transformed) line segment
+     * @param range range to extend
+     * @param transform optional transform to apply to the end points
+     */
+    extendRange(range, transform) {
+        if (transform) {
+            range.extendTransformedPoint(transform, this._point0);
+            range.extendTransformedPoint(transform, this._point1);
+        }
+        else {
+            range.extendPoint(this._point0);
+            range.extendPoint(this._point1);
+        }
+    }
+    /**
+     * Construct a line from either of these json forms:
+     *
+     * * object with named start and end:
+     * `{startPoint: pointValue, endPoint: pointValue}`
+     * * array of two point values:
+     * `[pointValue, pointValue]`
+     * The point values are any values accepted by the Point3d method setFromJSON.
+     * @param json data to parse.
+     */
+    setFromJSON(json) {
+        if (!json) {
+            this._point0.set(0, 0, 0);
+            this._point1.set(1, 0, 0);
+            return;
+        }
+        else if (json.startPoint && json.endPoint) { // {startPoint:json point, endPoint:json point}
+            this._point0.setFromJSON(json.startPoint);
+            this._point1.setFromJSON(json.endPoint);
+        }
+        else if (Array.isArray(json)
+            && json.length > 1) { // [json point, json point]
+            this._point0.setFromJSON(json[0]);
+            this._point1.setFromJSON(json[1]);
+        }
+    }
+    /** A simple line segment's fraction and distance are proportional. */
+    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()]; }
+    /** 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());
+        result.setFromJSON(json);
+        return result;
+    }
+    /** Near equality test with `other`. */
+    isAlmostEqual(other) {
+        if (other instanceof LineSegment3d) {
+            const ls = other;
+            return this._point0.isAlmostEqual(ls._point0) && this._point1.isAlmostEqual(ls._point1);
+        }
+        return false;
+    }
+    /** Emit strokes to caller-supplied linestring */
+    emitStrokes(dest, options) {
+        const numStroke = this.computeStrokeCountForOptions(options);
+        dest.appendFractionalStrokePoints(this, numStroke, 0.0, 1.0);
+    }
+    /** Emit strokes to caller-supplied handler */
+    emitStrokableParts(handler, options) {
+        handler.startCurvePrimitive(this);
+        const numStroke = this.computeStrokeCountForOptions(options);
+        handler.announceSegmentInterval(this, this._point0, this._point1, numStroke, 0.0, 1.0);
+        handler.endCurvePrimitive(this);
+    }
+    /**
+     * return the stroke count required for given options.
+     * @param options StrokeOptions that determine count
+     */
+    computeStrokeCountForOptions(options) {
+        let numStroke = 1;
+        if (options) {
+            if (options.maxEdgeLength)
+                numStroke = options.applyMaxEdgeLength(numStroke, this.curveLength());
+            numStroke = options.applyMinStrokesPerPrimitive(numStroke);
+        }
+        return numStroke;
+    }
+    /** 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)`
+     */
+    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.
+     * @param fractionA [in] start fraction
+     * @param fractionB [in] end fraction
+     */
+    clonePartialCurve(fractionA, fractionB) {
+        return LineSegment3d.create(this.fractionToPoint(fractionA), this.fractionToPoint(fractionB));
+    }
+}
+//# sourceMappingURL=LineSegment3d.js.map

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

@@ -0,0 +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 } from \"../geometry3d/Point3dVector3d\";\r\nimport { 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 { LineString3d } from \"./LineString3d\";\r\nimport { StrokeOptions } from \"./StrokeOptions\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\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): CurvePrimitive {  // 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): CurvePrimitive | undefined {\r\n    return LineSegment3d.create(this.fractionToPoint(fractionA), this.fractionToPoint(fractionB));\r\n  }\r\n}\r\n"]}