@itwin/core-geometry 4.5.0-dev.3 → 4.5.0-dev.32

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

@@ -16,7 +16,7 @@ import { PointString3d } from "./PointString3d";
  * ```ts
  *   function processGeometryQuery(q: GeometryQuery): void {
  *     if ("solid" === q.geometryCategory)
- *       alert("Solid type = " + q.solidPrimitiveType; // compiler knows q is an instance of SolidPrimitive
+ *       alert("Solid type = " + q.solidPrimitiveType); // compiler knows q is an instance of SolidPrimitive
  *    // ...etc...
  * ```
  *
@@ -27,7 +27,7 @@ import { PointString3d } from "./PointString3d";
  *  - "solid" => [[SolidPrimitive]]
  *  - "point" => [[CoordinateXYZ]]
  *  - "pointCollection" => [[PointString3d]]
- *  - "bsurf" => [[BSpline2dNd]]  (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])
+ *  - "bsurf" => [[BSpline2dNd]] (which is an intermediate class shared by [[BSplineSurface3d]] and [[BSplineSurface3dH]])
  *
  *  @see [[AnyGeometryQuery]]
  * @public
@@ -40,17 +40,17 @@ export type GeometryQueryCategory = "polyface" | "curvePrimitive" | "curveCollec
  */
 export type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;
 /**
- * Queries to be supported by Curve, Surface, and Solid objects
+ * 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
+ * and bspline surfaces.
  * @public
  */
 export declare abstract class GeometryQuery {
     /** Type discriminator. */
     abstract readonly geometryCategory: GeometryQueryCategory;
-    /** Return the range of the entire GeometryQuery tree */
+    /** Return the range of the entire GeometryQuery tree. */
     range(transform?: Transform, result?: Range3d): Range3d;
-    /** Extend rangeToExtend by the range of this geometry multiplied by the transform */
+    /** Extend `rangeToExtend` by the range of this geometry multiplied by the `transform`. */
     abstract extendRange(rangeToExtend: Range3d, transform?: Transform): void;
     /**
      * Attempt to transform in place.
@@ -58,7 +58,7 @@ export declare abstract class GeometryQuery {
      * * Some geometry types may fail if scaling is non-uniform.
      */
     abstract tryTransformInPlace(transform: Transform): boolean;
-    /** Try to move the geometry by dx,dy,dz */
+    /** Try to move the geometry by dx,dy,dz. */
     tryTranslateInPlace(dx: number, dy?: number, dz?: number): boolean;
     /** Return a transformed clone. */
     abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;
@@ -69,28 +69,28 @@ export declare abstract class GeometryQuery {
      * * leaf classes do not need to implement.
      */
     get children(): GeometryQuery[] | undefined;
-    /** Test if (other instanceof this.Type).  REQUIRED IN ALL CONCRETE CLASSES */
+    /** Test `if (other instanceof this.Type)`. REQUIRED IN ALL CONCRETE CLASSES. */
     abstract isSameGeometryClass(other: GeometryQuery): boolean;
     /**
      * 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.
+     * *  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: GeometryQuery): boolean;
     /**
      * Apply instance method [[isAlmostEqual]] if both are defined.
-     * * both undefined returns true
-     * * single defined returns false
+     * * Both undefined returns true.
+     * * Single defined returns false.
      */
     static areAlmostEqual(a: GeometryQuery | undefined, b: GeometryQuery | undefined): boolean;
     /**
-     * * "double dispatch" call pattern.
-     * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d` etc as
+     * Double Dispatch call pattern.
+     * * User code implements a `GeometryHandler` with specialized methods to handle `LineSegment3d`, `Arc3d`, etc as
      * relevant to its use case.
      * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call
-     * such as `handler.handleLineSegment3d ()`
+     * such as `handler.handleLineSegment3d())`
      * * This allows each type-specific method to be called without a switch or `instanceof` test.
      * @param handler handler to be called by the particular geometry class
      */

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

@@ -1 +1 @@
-{"version":3,"file":"GeometryQuery.d.ts","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAExI;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1I;;;;;GAKG;AACH,8BAAsB,aAAa;IACjC,0BAA0B;IAC1B,kBAAyB,gBAAgB,EAAE,qBAAqB,CAAC;IACjE,wDAAwD;IACjD,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9D,qFAAqF;aACrE,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAChF;;;;OAIG;aACa,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAClE,2CAA2C;IACpC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,MAAY,EAAE,EAAE,GAAE,MAAY,GAAG,OAAO;IAGnF,kCAAkC;aAClB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IACjF,qBAAqB;aACL,KAAK,IAAI,aAAa,GAAG,SAAS;IAClD;;;OAGG;IACH,IAAW,QAAQ,IAAI,aAAa,EAAE,GAAG,SAAS,CAAsB;IACxE,8EAA8E;aAC9D,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAClE;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAoBnD;;;;OAIG;WACW,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO;IAOjG;;;;;;;;OAQG;aACa,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CACzE"}
+{"version":3,"file":"GeometryQuery.d.ts","sourceRoot":"","sources":["../../../src/curve/GeometryQuery.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAExI;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1I;;;;;GAKG;AACH,8BAAsB,aAAa;IACjC,0BAA0B;IAC1B,kBAAyB,gBAAgB,EAAE,qBAAqB,CAAC;IACjE,yDAAyD;IAClD,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAO9D,0FAA0F;aAC1E,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAChF;;;;OAIG;aACa,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAClE,4CAA4C;IACrC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,MAAY,EAAE,EAAE,GAAE,MAAY,GAAG,OAAO;IAGnF,kCAAkC;aAClB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IACjF,qBAAqB;aACL,KAAK,IAAI,aAAa,GAAG,SAAS;IAClD;;;OAGG;IACH,IAAW,QAAQ,IAAI,aAAa,EAAE,GAAG,SAAS,CAEjD;IACD,gFAAgF;aAChE,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAClE;;;;;;OAMG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAoBnD;;;;OAIG;WACW,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO;IAOjG;;;;;;;;OAQG;aACa,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CACzE"}

package/lib/esm/curve/GeometryQuery.js

@@ -1,13 +1,13 @@
 import { Range3d } from "../geometry3d/Range";
 import { Transform } from "../geometry3d/Transform";
 /**
- * Queries to be supported by Curve, Surface, and Solid objects
+ * 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
+ * and bspline surfaces.
  * @public
  */
 export class GeometryQuery {
-    /** Return the range of the entire GeometryQuery tree */
+    /** Return the range of the entire GeometryQuery tree. */
     range(transform, result) {
         if (result)
             result.setNull();
@@ -15,7 +15,7 @@ export class GeometryQuery {
         this.extendRange(range, transform);
         return range;
     }
-    /** Try to move the geometry by dx,dy,dz */
+    /** 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));
     }
@@ -23,13 +23,15 @@ export class GeometryQuery {
      * Return GeometryQuery children for recursive queries.
      * * leaf classes do not need to implement.
      */
-    get children() { return undefined; }
+    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.
+     * *  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)) {
@@ -44,20 +46,19 @@ export class GeometryQuery {
                 }
                 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 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 true; // both children null; call it equal
             }
         }
         return false;
     }
     /**
      * Apply instance method [[isAlmostEqual]] if both are defined.
-     * * both undefined returns true
-     * * single defined returns false
+     * * Both undefined returns true.
+     * * Single defined returns false.
      */
     static areAlmostEqual(a, b) {
         if (a instanceof GeometryQuery && b instanceof GeometryQuery)

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

@@ -1 +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;AAsCpD;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IAGjC,wDAAwD;IACjD,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;IASD,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;IAKD;;;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;;;;OAIG;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;CAWF","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/**\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/**\r\n * Union type for subclasses of [[GeometryQuery]]. Specific subclasses can be discriminated at compile- or run-time\r\n * using [[GeometryQuery.geometryCategory]].\r\n * @public\r\n */\r\nexport type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;\r\n\r\n/**\r\n * Queries to be supported by Curve, Surface, and Solid objects\r\n * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,\r\n * 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  /** Return the range of the entire GeometryQuery tree */\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  /** 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   * * 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  /** 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  public abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;\r\n  /** Return a clone */\r\n  public abstract clone(): GeometryQuery | undefined;\r\n  /**\r\n   * Return GeometryQuery children for recursive queries.\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  /**\r\n   * Test for exact structure and nearly identical geometry.\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  /**\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\r\n   * relevant to its use case.\r\n   * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call\r\n   * 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"]}
+{"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;AAsCpD;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IAGjC,yDAAyD;IAClD,KAAK,CAAC,SAAqB,EAAE,MAAgB;QAClD,IAAI,MAAM;YACR,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,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;IASD,4CAA4C;IACrC,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;IAKD;;;OAGG;IACH,IAAW,QAAQ;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD;;;;;;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;wBAC3C,OAAO,KAAK,CAAC;iBAChB;gBACD,OAAO,IAAI,CAAC;aACb;iBAAM,IAAI,SAAS,IAAI,SAAS,EAAE,EAAE,uGAAuG;gBAC1I,OAAO,KAAK,CAAC,CAAC,oBAAoB;aACnC;iBAAM;gBACL,OAAO,IAAI,CAAC,CAAC,oCAAoC;aAClD;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;OAIG;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;CAWF","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/**\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/**\r\n * Union type for subclasses of [[GeometryQuery]]. Specific subclasses can be discriminated at compile- or run-time\r\n * using [[GeometryQuery.geometryCategory]].\r\n * @public\r\n */\r\nexport type AnyGeometryQuery = Polyface | CurvePrimitive | CurveCollection | SolidPrimitive | CoordinateXYZ | PointString3d | BSpline2dNd;\r\n\r\n/**\r\n * Queries to be supported by Curve, Surface, and Solid objects.\r\n * * `GeometryQuery` is an abstract base class with (abstract) methods for querying curve, solid primitive, mesh,\r\n * 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  /** Return the range of the entire GeometryQuery tree. */\r\n  public range(transform?: Transform, result?: Range3d): Range3d {\r\n    if (result)\r\n      result.setNull();\r\n    const range = result ? result : Range3d.createNull();\r\n    this.extendRange(range, transform);\r\n    return range;\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   * * 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  /** 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  public abstract cloneTransformed(transform: Transform): GeometryQuery | undefined;\r\n  /** Return a clone */\r\n  public abstract clone(): GeometryQuery | undefined;\r\n  /**\r\n   * Return GeometryQuery children for recursive queries.\r\n   * * leaf classes do not need to implement.\r\n   */\r\n  public get children(): GeometryQuery[] | undefined {\r\n    return undefined;\r\n  }\r\n  /** Test `if (other instanceof this.Type)`. REQUIRED IN ALL CONCRETE CLASSES. */\r\n  public abstract isSameGeometryClass(other: GeometryQuery): boolean;\r\n  /**\r\n   * Test for exact structure and nearly identical geometry.\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]))\r\n            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        return true; // both children null; call it equal\r\n      }\r\n    }\r\n    return false;\r\n  }\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\r\n   * relevant to its use case.\r\n   * * Each such `GeometryQuery` class implements this method as a one-line method containing the appropriate call\r\n   * 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/PointString3d.d.ts

@@ -21,36 +21,40 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     /** Test if `other` is a PointString3d */
     isSameGeometryClass(other: GeometryQuery): boolean;
     private _points;
-    /** return a clone of the points array. */
+    /** Return a clone of the points array. */
     get points(): Point3d[];
     private constructor();
     /** Clone and apply a transform. */
     cloneTransformed(transform: Transform): PointString3d;
+    /**
+     * Turn any array (possibly nested) into a "flat" array of objects that are not arrays. This allows processing
+     * the objects without recursion into nested arrays.
+     */
     private static flattenArray;
     /** Create a PointString3d from points. */
     static create(...points: any[]): PointString3d;
-    /** Add multiple points to the PointString3d */
+    /** Add multiple points to the PointString3d. */
     addPoints(...points: any[]): void;
-    /** Add a single point to the PointString3d */
+    /** Add a single point to the PointString3d. */
     addPoint(point: Point3d): void;
-    /** Remove the last point added to the PointString3d */
+    /** Remove the last point added to the PointString3d. */
     popPoint(): void;
-    /** Replace this PointString3d's point array by a clone of the array in `other` */
+    /** Replace this PointString3d's point array by a clone of the array in `other`. */
     setFrom(other: PointString3d): void;
-    /** Create from an array of Point3d */
+    /** Create from an array of Point3d. */
     static createPoints(points: Point3d[]): PointString3d;
-    /** Create a PointString3d from xyz coordinates packed in a Float64Array */
+    /** Create a PointString3d from xyz coordinates packed in a Float64Array. */
     static createFloat64Array(xyzData: Float64Array): PointString3d;
     /** Return a deep clone. */
     clone(): PointString3d;
-    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     setFromJSON(json?: any): void;
     /**
      * Convert an PointString3d to a JSON object.
-     * @return {*} [[x,y,z],...[x,y,z]]
+     * @return {*} e.g., `[[1,2,3], [4,5,6]]`.
      */
     toJSON(): XYZProps[];
-    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     static fromJSON(json?: any): PointString3d;
     /** Access a single point by index. */
     pointAt(i: number, result?: Point3d): Point3d | undefined;
@@ -58,7 +62,7 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     numPoints(): number;
     /** Reverse the point order */
     reverseInPlace(): void;
-    /** Return the number of points. */
+    /** Apply transform on points in place. */
     tryTransformInPlace(transform: Transform): boolean;
     /** Return the index and coordinates of the closest point to spacePoint. */
     closestPoint(spacePoint: Point3d): {
@@ -67,13 +71,13 @@ export declare class PointString3d extends GeometryQuery implements BeJSONFuncti
     };
     /** Return true if all points are in the given plane. */
     isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean;
-    /** Extend a range to include the points in this PointString3d. */
+    /** Extend a range to include the points in this PointString3d (optionally transformed). */
     extendRange(rangeToExtend: Range3d, transform?: Transform): void;
     /** Return true if corresponding points are almost equal. */
     isAlmostEqual(other: GeometryQuery): boolean;
     /** Reduce to empty set of points. */
     clear(): void;
-    /** Second step of double dispatch:  call `handler.handlePointString(this)` */
+    /** Second step of double dispatch: call `handler.handlePointString(this)` */
     dispatchToGeometryHandler(handler: GeometryHandler): any;
 }
 //# sourceMappingURL=PointString3d.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PointString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/PointString3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,eAAe;IACzE,wCAAwC;IACxC,SAAgB,gBAAgB,qBAAqB;IAErD,yCAAyC;IAClC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IACzD,OAAO,CAAC,OAAO,CAAY;IAC3B,0CAA0C;IAC1C,IAAW,MAAM,IAAI,OAAO,EAAE,CAAyB;IACvD,OAAO;IAIP,mCAAmC;IAC5B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAK5D,OAAO,CAAC,MAAM,CAAC,YAAY;IAK3B,0CAA0C;WAC5B,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa;IAMrD,+CAA+C;IACxC,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE;IAOjC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAG9B,uDAAuD;IAChD,QAAQ;IAIf,kFAAkF;IAC3E,OAAO,CAAC,KAAK,EAAE,aAAa;IAGnC,sCAAsC;WACxB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa;IAK5D,2EAA2E;WAC7D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAMtE,2BAA2B;IACpB,KAAK,IAAI,aAAa;IAK7B,2FAA2F;IACpF,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAQ7B;;;OAGG;IACI,MAAM,IAAI,QAAQ,EAAE;IAK3B,0EAA0E;WAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,aAAa;IAGjD,sCAAsC;IAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAOhE,mCAAmC;IAC5B,SAAS,IAAI,MAAM;IAE1B,8BAA8B;IACvB,cAAc,IAAI,IAAI;IAa7B,mCAAmC;IAC5B,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,2EAA2E;IACpE,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE;IASzE,wDAAwD;IACjD,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO;IAG9D,kEAAkE;IAC3D,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAGvE,4DAA4D;IAC5C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAK5D,qCAAqC;IAC9B,KAAK;IACZ,8EAA8E;IACvE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAIhE"}
+{"version":3,"file":"PointString3d.d.ts","sourceRoot":"","sources":["../../../src/curve/PointString3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,eAAe;IACzE,wCAAwC;IACxC,SAAgB,gBAAgB,qBAAqB;IACrD,yCAAyC;IAClC,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAGzD,OAAO,CAAC,OAAO,CAAY;IAC3B,0CAA0C;IAC1C,IAAW,MAAM,IAAI,OAAO,EAAE,CAE7B;IACD,OAAO;IAIP,mCAAmC;IAC5B,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAK5D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAU3B,0CAA0C;WAC5B,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa;IAKrD,gDAAgD;IACzC,SAAS,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE;IAOjC,+CAA+C;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAG9B,wDAAwD;IACjD,QAAQ;IAGf,mFAAmF;IAC5E,OAAO,CAAC,KAAK,EAAE,aAAa;IAGnC,uCAAuC;WACzB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa;IAK5D,4EAA4E;WAC9D,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAMtE,2BAA2B;IACpB,KAAK,IAAI,aAAa;IAK7B,4FAA4F;IACrF,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAQ7B;;;OAGG;IACI,MAAM,IAAI,QAAQ,EAAE;IAM3B,2EAA2E;WAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,aAAa;IAKjD,sCAAsC;IAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAUhE,mCAAmC;IAC5B,SAAS,IAAI,MAAM;IAG1B,8BAA8B;IACvB,cAAc,IAAI,IAAI;IAa7B,0CAA0C;IACnC,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAIzD,2EAA2E;IACpE,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE;IASzE,wDAAwD;IACjD,SAAS,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO;IAG9D,2FAA2F;IACpF,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAGvE,4DAA4D;IAC5C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAK5D,qCAAqC;IAC9B,KAAK;IAGZ,6EAA6E;IACtE,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,GAAG;CAGhE"}

package/lib/esm/curve/PointString3d.js

@@ -18,9 +18,13 @@ import { GeometryQuery } from "./GeometryQuery";
  */
 export class PointString3d extends GeometryQuery {
     /** Test if `other` is a PointString3d */
-    isSameGeometryClass(other) { return other instanceof PointString3d; }
-    /** return a clone of the points array. */
-    get points() { return this._points; }
+    isSameGeometryClass(other) {
+        return other instanceof PointString3d;
+    }
+    /** Return a clone of the points array. */
+    get points() {
+        return this._points;
+    }
     constructor() {
         super();
         /** String name for schema properties */
@@ -30,11 +34,18 @@ export class PointString3d extends GeometryQuery {
     /** Clone and apply a transform. */
     cloneTransformed(transform) {
         const c = this.clone();
-        c.tryTransformInPlace(transform);
+        c.tryTransformInPlace(transform); // we know tryTransformInPlace succeeds
         return c;
     }
+    /**
+     * Turn any array (possibly nested) into a "flat" array of objects that are not arrays. This allows processing
+     * the objects without recursion into nested arrays.
+     */
     static flattenArray(arr) {
-        return arr.reduce((flat, toFlatten) => {
+        return arr.reduce(
+        // a callback function to execute for each element in the array. Its return value becomes
+        // the value of the "flat" parameter on the next invocation of the callback function.
+        (flat, toFlatten) => {
             return flat.concat(Array.isArray(toFlatten) ? PointString3d.flattenArray(toFlatten) : toFlatten);
         }, []);
     }
@@ -44,7 +55,7 @@ export class PointString3d extends GeometryQuery {
         result.addPoints(points);
         return result;
     }
-    /** Add multiple points to the PointString3d */
+    /** Add multiple points to the PointString3d. */
     addPoints(...points) {
         const toAdd = PointString3d.flattenArray(points);
         for (const p of toAdd) {
@@ -52,25 +63,25 @@ export class PointString3d extends GeometryQuery {
                 this._points.push(p);
         }
     }
-    /** Add a single point to the PointString3d */
+    /** Add a single point to the PointString3d. */
     addPoint(point) {
         this._points.push(point);
     }
-    /** Remove the last point added to the PointString3d */
+    /** Remove the last point added to the PointString3d. */
     popPoint() {
         this._points.pop();
     }
-    /** Replace this PointString3d's point array by a clone of the array in `other` */
+    /** Replace this PointString3d's point array by a clone of the array in `other`. */
     setFrom(other) {
         this._points = Point3dArray.clonePoint3dArray(other._points);
     }
-    /** Create from an array of Point3d */
+    /** Create from an array of Point3d. */
     static createPoints(points) {
         const ps = new PointString3d();
         ps._points = Point3dArray.clonePoint3dArray(points);
         return ps;
     }
-    /** Create a PointString3d from xyz coordinates packed in a Float64Array */
+    /** Create a PointString3d from xyz coordinates packed in a Float64Array. */
     static createFloat64Array(xyzData) {
         const ps = new PointString3d();
         for (let i = 0; i + 3 <= xyzData.length; i += 3)
@@ -83,7 +94,7 @@ export class PointString3d extends GeometryQuery {
         retVal.setFrom(this);
         return retVal;
     }
-    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     setFromJSON(json) {
         this._points.length = 0;
         if (Array.isArray(json)) {
@@ -94,7 +105,7 @@ export class PointString3d extends GeometryQuery {
     }
     /**
      * Convert an PointString3d to a JSON object.
-     * @return {*} [[x,y,z],...[x,y,z]]
+     * @return {*} e.g., `[[1,2,3], [4,5,6]]`.
      */
     toJSON() {
         const value = [];
@@ -102,7 +113,7 @@ export class PointString3d extends GeometryQuery {
             value.push(p.toJSON());
         return value;
     }
-    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,2,2]]` */
+    /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,5,6]]`. */
     static fromJSON(json) {
         const ps = new PointString3d();
         ps.setFromJSON(json);
@@ -120,14 +131,16 @@ export class PointString3d extends GeometryQuery {
         return undefined;
     }
     /** Return the number of points. */
-    numPoints() { return this._points.length; }
+    numPoints() {
+        return this._points.length;
+    }
     /** Reverse the point order */
     reverseInPlace() {
         if (this._points.length >= 2) {
             let i0 = 0;
             let i1 = this._points.length - 1;
             while (i0 < i1) {
-                const a = this._points[i0];
+                const a = this._points[i1];
                 this._points[i1] = this._points[i0];
                 this._points[i0] = a;
                 i0++;
@@ -135,7 +148,7 @@ export class PointString3d extends GeometryQuery {
             }
         }
     }
-    /** Return the number of points. */
+    /** Apply transform on points in place. */
     tryTransformInPlace(transform) {
         transform.multiplyPoint3dArrayInPlace(this._points);
         return true;
@@ -154,7 +167,7 @@ export class PointString3d extends GeometryQuery {
     isInPlane(plane) {
         return Point3dArray.isCloseToPlane(this._points, plane, Geometry.smallMetricDistance);
     }
-    /** Extend a range to include the points in this PointString3d. */
+    /** Extend a range to include the points in this PointString3d (optionally transformed). */
     extendRange(rangeToExtend, transform) {
         rangeToExtend.extendArray(this._points, transform);
     }
@@ -165,8 +178,10 @@ export class PointString3d extends GeometryQuery {
         return Point3dArray.isAlmostEqual(this._points, other._points);
     }
     /** Reduce to empty set of points. */
-    clear() { this._points.length = 0; }
-    /** Second step of double dispatch:  call `handler.handlePointString(this)` */
+    clear() {
+        this._points.length = 0;
+    }
+    /** Second step of double dispatch: call `handler.handlePointString(this)` */
     dispatchToGeometryHandler(handler) {
         return handler.handlePointString3d(this);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"PointString3d.js","sourceRoot":"","sources":["../../../src/curve/PointString3d.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 { BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Plane3dByOriginAndUnitNormal } from \"../geometry3d/Plane3dByOriginAndUnitNormal\";\r\nimport { Point3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Point3dArray } from \"../geometry3d/PointHelpers\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { XYZProps } from \"../geometry3d/XYZProps\";\r\nimport { GeometryQuery } from \"./GeometryQuery\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\n\r\n/**\r\n * A PointString3d is an array of points.\r\n * * PointString3D is first class (displayable, possibly persistent) geometry derived from the GeometryQuery base class.\r\n * * The various points in the PointString3d are NOT connected by line segments for display or other calculations.\r\n * @public\r\n */\r\nexport class PointString3d extends GeometryQuery implements BeJSONFunctions {\r\n  /** String name for schema properties */\r\n  public readonly geometryCategory = \"pointCollection\";\r\n\r\n  /** Test if `other` is a PointString3d */\r\n  public isSameGeometryClass(other: GeometryQuery): boolean { return other instanceof PointString3d; }\r\n  private _points: Point3d[];\r\n  /** return a clone of the points array. */\r\n  public get points(): Point3d[] { return this._points; }\r\n  private constructor() {\r\n    super();\r\n    this._points = [];\r\n  }\r\n  /** Clone and apply a transform. */\r\n  public cloneTransformed(transform: Transform): PointString3d {  // we know tryTransformInPlace succeeds.\r\n    const c = this.clone();\r\n    c.tryTransformInPlace(transform);\r\n    return c;\r\n  }\r\n  private static flattenArray(arr: any): any {\r\n    return arr.reduce((flat: any, toFlatten: any) => {\r\n      return flat.concat(Array.isArray(toFlatten) ? PointString3d.flattenArray(toFlatten) : toFlatten);\r\n    }, []);\r\n  }\r\n  /** Create a PointString3d from points. */\r\n  public static create(...points: any[]): PointString3d {\r\n    const result = new PointString3d();\r\n    result.addPoints(points);\r\n    return result;\r\n  }\r\n\r\n  /** Add multiple points to the PointString3d */\r\n  public addPoints(...points: any[]) {\r\n    const toAdd: any[] = PointString3d.flattenArray(points);\r\n    for (const p of toAdd) {\r\n      if (p instanceof Point3d)\r\n        this._points.push(p);\r\n    }\r\n  }\r\n  /** Add a single point to the PointString3d */\r\n  public addPoint(point: Point3d) {\r\n    this._points.push(point);\r\n  }\r\n  /** Remove the last point added to the PointString3d */\r\n  public popPoint() {\r\n    this._points.pop();\r\n  }\r\n\r\n  /** Replace this PointString3d's point array by a clone of the array in `other` */\r\n  public setFrom(other: PointString3d) {\r\n    this._points = Point3dArray.clonePoint3dArray(other._points);\r\n  }\r\n  /** Create from an array of Point3d */\r\n  public static createPoints(points: Point3d[]): PointString3d {\r\n    const ps = new PointString3d();\r\n    ps._points = Point3dArray.clonePoint3dArray(points);\r\n    return ps;\r\n  }\r\n  /** Create a PointString3d from xyz coordinates packed in a Float64Array */\r\n  public static createFloat64Array(xyzData: Float64Array): PointString3d {\r\n    const ps = new PointString3d();\r\n    for (let i = 0; i + 3 <= xyzData.length; i += 3)\r\n      ps._points.push(Point3d.create(xyzData[i], xyzData[i + 1], xyzData[i + 2]));\r\n    return ps;\r\n  }\r\n  /** Return a deep clone. */\r\n  public clone(): PointString3d {\r\n    const retVal = new PointString3d();\r\n    retVal.setFrom(this);\r\n    return retVal;\r\n  }\r\n  /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,2,2]]` */\r\n  public setFromJSON(json?: any) {\r\n    this._points.length = 0;\r\n    if (Array.isArray(json)) {\r\n      let xyz;\r\n      for (xyz of json)\r\n        this._points.push(Point3d.fromJSON(xyz));\r\n    }\r\n  }\r\n  /**\r\n   * Convert an PointString3d to a JSON object.\r\n   * @return {*} [[x,y,z],...[x,y,z]]\r\n   */\r\n  public toJSON(): XYZProps[] {\r\n    const value = [];\r\n    for (const p of this._points) value.push(p.toJSON());\r\n    return value;\r\n  }\r\n  /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,2,2]]` */\r\n  public static fromJSON(json?: any): PointString3d {\r\n    const ps = new PointString3d(); ps.setFromJSON(json); return ps;\r\n  }\r\n  /** Access a single point by index. */\r\n  public pointAt(i: number, result?: Point3d): Point3d | undefined {\r\n    if (i >= 0 && i < this._points.length) {\r\n      if (result) { result.setFrom(this._points[i]); return result; }\r\n      return this._points[i].clone();\r\n    }\r\n    return undefined;\r\n  }\r\n  /** Return the number of points. */\r\n  public numPoints(): number { return this._points.length; }\r\n\r\n  /** Reverse the point order */\r\n  public reverseInPlace(): void {\r\n    if (this._points.length >= 2) {\r\n      let i0 = 0;\r\n      let i1 = this._points.length - 1;\r\n      while (i0 < i1) {\r\n        const a = this._points[i0];\r\n        this._points[i1] = this._points[i0];\r\n        this._points[i0] = a;\r\n        i0++;\r\n        i1--;\r\n      }\r\n    }\r\n  }\r\n  /** Return the number of points. */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    transform.multiplyPoint3dArrayInPlace(this._points);\r\n    return true;\r\n  }\r\n  /** Return the index and coordinates of the closest point to spacePoint. */\r\n  public closestPoint(spacePoint: Point3d): { index: number, xyz: Point3d } {\r\n    const result = { index: -1, xyz: Point3d.create() };\r\n    const index = Point3dArray.closestPointIndex(this._points, spacePoint);\r\n    if (index >= 0) {\r\n      result.index = index;\r\n      result.xyz.setFrom(this._points[index]);\r\n    }\r\n    return result;\r\n  }\r\n  /** Return true if all points are in the given plane. */\r\n  public isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean {\r\n    return Point3dArray.isCloseToPlane(this._points, plane, Geometry.smallMetricDistance);\r\n  }\r\n  /** Extend a range to include the points in this PointString3d. */\r\n  public extendRange(rangeToExtend: Range3d, transform?: Transform): void {\r\n    rangeToExtend.extendArray(this._points, transform);\r\n  }\r\n  /** Return true if corresponding points are almost equal. */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (!(other instanceof PointString3d))\r\n      return false;\r\n    return Point3dArray.isAlmostEqual(this._points, other._points);\r\n  }\r\n  /** Reduce to empty set of points. */\r\n  public clear() { this._points.length = 0; }\r\n  /** Second step of double dispatch:  call `handler.handlePointString(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handlePointString3d(this);\r\n  }\r\n\r\n}\r\n"]}
+{"version":3,"file":"PointString3d.js","sourceRoot":"","sources":["../../../src/curve/PointString3d.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 { BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Plane3dByOriginAndUnitNormal } from \"../geometry3d/Plane3dByOriginAndUnitNormal\";\r\nimport { Point3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Point3dArray } from \"../geometry3d/PointHelpers\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { XYZProps } from \"../geometry3d/XYZProps\";\r\nimport { GeometryQuery } from \"./GeometryQuery\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\n\r\n/**\r\n * A PointString3d is an array of points.\r\n * * PointString3D is first class (displayable, possibly persistent) geometry derived from the GeometryQuery base class.\r\n * * The various points in the PointString3d are NOT connected by line segments for display or other calculations.\r\n * @public\r\n */\r\nexport class PointString3d extends GeometryQuery implements BeJSONFunctions {\r\n  /** String name for schema properties */\r\n  public readonly geometryCategory = \"pointCollection\";\r\n  /** Test if `other` is a PointString3d */\r\n  public isSameGeometryClass(other: GeometryQuery): boolean {\r\n    return other instanceof PointString3d;\r\n  }\r\n  private _points: Point3d[];\r\n  /** Return a clone of the points array. */\r\n  public get points(): Point3d[] {\r\n    return this._points;\r\n  }\r\n  private constructor() {\r\n    super();\r\n    this._points = [];\r\n  }\r\n  /** Clone and apply a transform. */\r\n  public cloneTransformed(transform: Transform): PointString3d {\r\n    const c = this.clone();\r\n    c.tryTransformInPlace(transform); // we know tryTransformInPlace succeeds\r\n    return c;\r\n  }\r\n  /**\r\n   * Turn any array (possibly nested) into a \"flat\" array of objects that are not arrays. This allows processing\r\n   * the objects without recursion into nested arrays.\r\n   */\r\n  private static flattenArray(arr: any): any {\r\n    return arr.reduce(\r\n      // a callback function to execute for each element in the array. Its return value becomes\r\n      // the value of the \"flat\" parameter on the next invocation of the callback function.\r\n      (flat: any, toFlatten: any) => {\r\n        return flat.concat(Array.isArray(toFlatten) ? PointString3d.flattenArray(toFlatten) : toFlatten);\r\n      },\r\n      [], // initial value (empty array)\r\n    );\r\n  }\r\n  /** Create a PointString3d from points. */\r\n  public static create(...points: any[]): PointString3d {\r\n    const result = new PointString3d();\r\n    result.addPoints(points);\r\n    return result;\r\n  }\r\n  /** Add multiple points to the PointString3d. */\r\n  public addPoints(...points: any[]) {\r\n    const toAdd: any[] = PointString3d.flattenArray(points);\r\n    for (const p of toAdd) {\r\n      if (p instanceof Point3d)\r\n        this._points.push(p);\r\n    }\r\n  }\r\n  /** Add a single point to the PointString3d. */\r\n  public addPoint(point: Point3d) {\r\n    this._points.push(point);\r\n  }\r\n  /** Remove the last point added to the PointString3d. */\r\n  public popPoint() {\r\n    this._points.pop();\r\n  }\r\n  /** Replace this PointString3d's point array by a clone of the array in `other`. */\r\n  public setFrom(other: PointString3d) {\r\n    this._points = Point3dArray.clonePoint3dArray(other._points);\r\n  }\r\n  /** Create from an array of Point3d. */\r\n  public static createPoints(points: Point3d[]): PointString3d {\r\n    const ps = new PointString3d();\r\n    ps._points = Point3dArray.clonePoint3dArray(points);\r\n    return ps;\r\n  }\r\n  /** Create a PointString3d from xyz coordinates packed in a Float64Array. */\r\n  public static createFloat64Array(xyzData: Float64Array): PointString3d {\r\n    const ps = new PointString3d();\r\n    for (let i = 0; i + 3 <= xyzData.length; i += 3)\r\n      ps._points.push(Point3d.create(xyzData[i], xyzData[i + 1], xyzData[i + 2]));\r\n    return ps;\r\n  }\r\n  /** Return a deep clone. */\r\n  public clone(): PointString3d {\r\n    const retVal = new PointString3d();\r\n    retVal.setFrom(this);\r\n    return retVal;\r\n  }\r\n  /** Replace this instance's points by those from a json array, e.g. `[[1,2,3], [4,5,6]]`. */\r\n  public setFromJSON(json?: any) {\r\n    this._points.length = 0;\r\n    if (Array.isArray(json)) {\r\n      let xyz;\r\n      for (xyz of json)\r\n        this._points.push(Point3d.fromJSON(xyz));\r\n    }\r\n  }\r\n  /**\r\n   * Convert an PointString3d to a JSON object.\r\n   * @return {*} e.g., `[[1,2,3], [4,5,6]]`.\r\n   */\r\n  public toJSON(): XYZProps[] {\r\n    const value = [];\r\n    for (const p of this._points)\r\n      value.push(p.toJSON());\r\n    return value;\r\n  }\r\n  /** Create a PointString3d from a json array, e.g. `[[1,2,3], [4,5,6]]`. */\r\n  public static fromJSON(json?: any): PointString3d {\r\n    const ps = new PointString3d();\r\n    ps.setFromJSON(json);\r\n    return ps;\r\n  }\r\n  /** Access a single point by index. */\r\n  public pointAt(i: number, result?: Point3d): Point3d | undefined {\r\n    if (i >= 0 && i < this._points.length) {\r\n      if (result) {\r\n        result.setFrom(this._points[i]);\r\n        return result;\r\n      }\r\n      return this._points[i].clone();\r\n    }\r\n    return undefined;\r\n  }\r\n  /** Return the number of points. */\r\n  public numPoints(): number {\r\n    return this._points.length;\r\n  }\r\n  /** Reverse the point order */\r\n  public reverseInPlace(): void {\r\n    if (this._points.length >= 2) {\r\n      let i0 = 0;\r\n      let i1 = this._points.length - 1;\r\n      while (i0 < i1) {\r\n        const a = this._points[i1];\r\n        this._points[i1] = this._points[i0];\r\n        this._points[i0] = a;\r\n        i0++;\r\n        i1--;\r\n      }\r\n    }\r\n  }\r\n  /** Apply transform on points in place. */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    transform.multiplyPoint3dArrayInPlace(this._points);\r\n    return true;\r\n  }\r\n  /** Return the index and coordinates of the closest point to spacePoint. */\r\n  public closestPoint(spacePoint: Point3d): { index: number, xyz: Point3d } {\r\n    const result = { index: -1, xyz: Point3d.create() };\r\n    const index = Point3dArray.closestPointIndex(this._points, spacePoint);\r\n    if (index >= 0) {\r\n      result.index = index;\r\n      result.xyz.setFrom(this._points[index]);\r\n    }\r\n    return result;\r\n  }\r\n  /** Return true if all points are in the given plane. */\r\n  public isInPlane(plane: Plane3dByOriginAndUnitNormal): boolean {\r\n    return Point3dArray.isCloseToPlane(this._points, plane, Geometry.smallMetricDistance);\r\n  }\r\n  /** Extend a range to include the points in this PointString3d (optionally transformed). */\r\n  public extendRange(rangeToExtend: Range3d, transform?: Transform): void {\r\n    rangeToExtend.extendArray(this._points, transform);\r\n  }\r\n  /** Return true if corresponding points are almost equal. */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (!(other instanceof PointString3d))\r\n      return false;\r\n    return Point3dArray.isAlmostEqual(this._points, other._points);\r\n  }\r\n  /** Reduce to empty set of points. */\r\n  public clear() {\r\n    this._points.length = 0;\r\n  }\r\n  /** Second step of double dispatch: call `handler.handlePointString(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handlePointString3d(this);\r\n  }\r\n}\r\n"]}

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.js

@@ -47,7 +47,7 @@ export class MXCubicAlongArcEvaluator extends CubicEvaluator {
         super.scaleInPlace(scaleFactor);
     }
     /** return a deep copy of the evaluator */
-    clone() { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }
+    clone() { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, this.axisLength, this.cubicM); }
     /** Member by member matchup ... */
     isAlmostEqual(other) {
         if (other instanceof MXCubicAlongArcEvaluator) {

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"MXCubicAlongArcSpiralEvaluator.js","sourceRoot":"","sources":["../../../../src/curve/spiral/MXCubicAlongArcSpiralEvaluator.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAI1D,uEAAuE;IACvE,YAAoB,OAAe,EAAE,OAAe,EAAE,UAAkB,EAAE,MAAc;QACtF,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,kCAAkC;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe;QAC1D,MAAM,UAAU,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnG,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IAC5C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YACjB,OAAO,SAAS,CAAC;QACnB,MAAM,IAAI,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7F,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAEe,YAAY,CAAC,WAAmB;QAC9C,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,0CAA0C;IACnC,KAAK,KAA+B,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3J,mCAAmC;IAC5B,aAAa,CAAC,KAAU;QAC7B,IAAI,KAAK,YAAY,wBAAwB,EAAE;YAC7C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;mBACtE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;SAC3E;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,2BAA2B,CAAC,cAAsB,EAAE,cAAsB,EAAE,oBAA4B;QACpH,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;QACvD,OAAO,oBAAoB,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;CACF","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\nimport { Geometry } from \"../../Geometry\";\r\nimport { CubicEvaluator } from \"./CubicEvaluator\";\r\n/**\r\n * MX Cubic along arc.\r\n * This is y= m*x^3 with\r\n * * x any point on the x axis\r\n * * `fraction` along the spiral goes to `x = fraction * Lx`\r\n * * m is (1/6RL)\r\n * * construction length L is nominal along the curve.\r\n * * x length Lx is along the axis, determined by two terms of the clothoid x series.\r\n * *\r\n * @param localToWorld\r\n * @param nominalL1\r\n * @param nominalR1\r\n * @param activeInterval\r\n * @internal\r\n */\r\nexport class MXCubicAlongArcEvaluator extends CubicEvaluator {\r\n  public nominalLength1: number;\r\n  public nominalRadius1: number;\r\n\r\n  /** Constructor is private.  Caller responsible for cubicM validity. */\r\n  private constructor(length1: number, radius1: number, axisLength: number, cubicM: number) {\r\n    super(axisLength, cubicM);\r\n    this.nominalLength1 = length1;\r\n    this.nominalRadius1 = radius1;\r\n  }\r\n\r\n  /** Compute the cubic constant. */\r\n  public static computeCubicM(length1: number, radius1: number): number | undefined {\r\n    const axisLength = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return 1.0 / (6.0 * radius1 * axisLength);\r\n  }\r\n\r\n  public static create(length1: number, radius1: number): MXCubicAlongArcEvaluator | undefined {\r\n    const m = this.computeCubicM(length1, radius1);\r\n    if (m === undefined)\r\n      return undefined;\r\n    const xMax = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return new MXCubicAlongArcEvaluator(length1, radius1, xMax, m);\r\n  }\r\n\r\n  public override scaleInPlace(scaleFactor: number) {\r\n    this.nominalLength1 *= scaleFactor;\r\n    this.nominalRadius1 *= scaleFactor;\r\n    super.scaleInPlace(scaleFactor);\r\n  }\r\n  /** return a deep copy of the evaluator */\r\n  public clone(): MXCubicAlongArcEvaluator { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }\r\n  /** Member by member matchup ... */\r\n  public isAlmostEqual(other: any): boolean {\r\n    if (other instanceof MXCubicAlongArcEvaluator) {\r\n      return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)\r\n        && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);\r\n    }\r\n    return false;\r\n  }\r\n  /**\r\n   * Return a (fast but mediocre) approximation of spiral x position as function of approximate distance along the curve.\r\n   * * This x-to-distance relation is not as precise as the CurvePrimitive method moveSignedDistanceFromFraction.\r\n   * * It is supported here for users interested in replicating the Czech distance mapping rather than the more accurate CurvePrimitive measurements.\r\n   * @param x distance along the x axis.\r\n   */\r\n  public static approximateDistanceAlongToX(nominalLength1: number, nominalRadius1: number, nominalDistanceAlong: number): number {\r\n    const l2 = nominalLength1 * nominalLength1;\r\n    const r2 = nominalRadius1 * nominalRadius1;\r\n    const xx = nominalDistanceAlong * nominalDistanceAlong;\r\n    return nominalDistanceAlong * (1.0 - xx * xx / (40.0 * r2 * l2));\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MXCubicAlongArcSpiralEvaluator.js","sourceRoot":"","sources":["../../../../src/curve/spiral/MXCubicAlongArcSpiralEvaluator.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAI1D,uEAAuE;IACvE,YAAoB,OAAe,EAAE,OAAe,EAAE,UAAkB,EAAE,MAAc;QACtF,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,kCAAkC;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe;QAC1D,MAAM,UAAU,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnG,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IAC5C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YACjB,OAAO,SAAS,CAAC;QACnB,MAAM,IAAI,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7F,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAEe,YAAY,CAAC,WAAmB;QAC9C,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,0CAA0C;IACnC,KAAK,KAA+B,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzJ,mCAAmC;IAC5B,aAAa,CAAC,KAAU;QAC7B,IAAI,KAAK,YAAY,wBAAwB,EAAE;YAC7C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;mBACtE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;SAC3E;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,2BAA2B,CAAC,cAAsB,EAAE,cAAsB,EAAE,oBAA4B;QACpH,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;QACvD,OAAO,oBAAoB,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;CACF","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\nimport { Geometry } from \"../../Geometry\";\r\nimport { CubicEvaluator } from \"./CubicEvaluator\";\r\n/**\r\n * MX Cubic along arc.\r\n * This is y= m*x^3 with\r\n * * x any point on the x axis\r\n * * `fraction` along the spiral goes to `x = fraction * Lx`\r\n * * m is (1/6RL)\r\n * * construction length L is nominal along the curve.\r\n * * x length Lx is along the axis, determined by two terms of the clothoid x series.\r\n * *\r\n * @param localToWorld\r\n * @param nominalL1\r\n * @param nominalR1\r\n * @param activeInterval\r\n * @internal\r\n */\r\nexport class MXCubicAlongArcEvaluator extends CubicEvaluator {\r\n  public nominalLength1: number;\r\n  public nominalRadius1: number;\r\n\r\n  /** Constructor is private.  Caller responsible for cubicM validity. */\r\n  private constructor(length1: number, radius1: number, axisLength: number, cubicM: number) {\r\n    super(axisLength, cubicM);\r\n    this.nominalLength1 = length1;\r\n    this.nominalRadius1 = radius1;\r\n  }\r\n\r\n  /** Compute the cubic constant. */\r\n  public static computeCubicM(length1: number, radius1: number): number | undefined {\r\n    const axisLength = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return 1.0 / (6.0 * radius1 * axisLength);\r\n  }\r\n\r\n  public static create(length1: number, radius1: number): MXCubicAlongArcEvaluator | undefined {\r\n    const m = this.computeCubicM(length1, radius1);\r\n    if (m === undefined)\r\n      return undefined;\r\n    const xMax = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return new MXCubicAlongArcEvaluator(length1, radius1, xMax, m);\r\n  }\r\n\r\n  public override scaleInPlace(scaleFactor: number) {\r\n    this.nominalLength1 *= scaleFactor;\r\n    this.nominalRadius1 *= scaleFactor;\r\n    super.scaleInPlace(scaleFactor);\r\n  }\r\n  /** return a deep copy of the evaluator */\r\n  public clone(): MXCubicAlongArcEvaluator { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, this.axisLength, this.cubicM); }\r\n  /** Member by member matchup ... */\r\n  public isAlmostEqual(other: any): boolean {\r\n    if (other instanceof MXCubicAlongArcEvaluator) {\r\n      return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)\r\n        && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);\r\n    }\r\n    return false;\r\n  }\r\n  /**\r\n   * Return a (fast but mediocre) approximation of spiral x position as function of approximate distance along the curve.\r\n   * * This x-to-distance relation is not as precise as the CurvePrimitive method moveSignedDistanceFromFraction.\r\n   * * It is supported here for users interested in replicating the Czech distance mapping rather than the more accurate CurvePrimitive measurements.\r\n   * @param x distance along the x axis.\r\n   */\r\n  public static approximateDistanceAlongToX(nominalLength1: number, nominalRadius1: number, nominalDistanceAlong: number): number {\r\n    const l2 = nominalLength1 * nominalLength1;\r\n    const r2 = nominalRadius1 * nominalRadius1;\r\n    const xx = nominalDistanceAlong * nominalDistanceAlong;\r\n    return nominalDistanceAlong * (1.0 - xx * xx / (40.0 * r2 * l2));\r\n  }\r\n}\r\n"]}

package/lib/esm/curve/spiral/PolishCubicSpiralEvaluator.js

@@ -48,7 +48,7 @@ export class PolishCubicEvaluator extends CubicEvaluator {
         super.scaleInPlace(scaleFactor);
     }
     /** return a deep copy of the evaluator */
-    clone() { return new PolishCubicEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }
+    clone() { return new PolishCubicEvaluator(this.nominalLength1, this.nominalRadius1, this.axisLength, this.cubicM); }
     /** Member by member matchup ... */
     isAlmostEqual(other) {
         if (other instanceof PolishCubicEvaluator) {

package/lib/esm/curve/spiral/PolishCubicSpiralEvaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"PolishCubicSpiralEvaluator.js","sourceRoot":"","sources":["../../../../src/curve/spiral/PolishCubicSpiralEvaluator.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IAItD,uEAAuE;IACvE,YAAoB,OAAe,EAAE,OAAe,EAAE,UAAkB,EAAE,MAAc;QACtF,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,wCAAwC;IACjC,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe;QAC1D,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YACjB,OAAO,SAAS,CAAC;QACnB,MAAM,IAAI,GAAG,oBAAoB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzF,IAAI,IAAI,KAAK,SAAS;YACpB,OAAO,SAAS,CAAC;QACnB,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEe,YAAY,CAAC,WAAmB;QAC9C,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,0CAA0C;IACnC,KAAK,KAA2B,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnJ,mCAAmC;IAC5B,aAAa,CAAC,KAAU;QAC7B,IAAI,KAAK,YAAY,oBAAoB,EAAE;YACzC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;mBACtE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;SAC3E;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2EAA2E;IACpE,MAAM,CAAC,0BAA0B,CAAC,OAAe,EAAE,OAAe;QACvE,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IAC7D,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,sBAAsB,CAAC,CAAS,EAAE,OAAe,EAAE,OAAe;QAC9E,mFAAmF;QACnF,MAAM,EAAE,GAAG,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACpG,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gCAAgC,CAAC,CAAS,EAAE,OAAe,EAAE,OAAe;QACxF,mFAAmF;QACnF,MAAM,EAAE,GAAG,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,sBAAsB;QACtB,sDAAsD;QACtD,mDAAmD;QACnD,aAAa;QACb,qBAAqB;QACrB,sBAAsB;QACtB,0BAA0B;QAC1B,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kDAAkD;IAC3C,MAAM,CAAC,2BAA2B,CAAC,CAAS,EAAE,OAAe,EAAE,OAAe;QACnF,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,EACrC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EACrE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;CACF","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\nimport { Geometry } from \"../../Geometry\";\r\nimport { SimpleNewton } from \"../../numerics/Newton\";\r\nimport { CubicEvaluator } from \"./CubicEvaluator\";\r\n/**\r\n * Polish Cubic.\r\n * * Construction takes nominal length and end radius.\r\n * curve is  is y= m*x^3 with\r\n * * x any point on the x axis\r\n * * m is (1/6RL)\r\n * * Lx = x length is along the axis, determined by inversion of a distance series at nominal length\r\n * *\r\n * @param localToWorld\r\n * @param nominalL1\r\n * @param nominalR1\r\n * @param activeInterval\r\n * @internal\r\n */\r\nexport class PolishCubicEvaluator extends CubicEvaluator {\r\n  public nominalLength1: number;\r\n  public nominalRadius1: number;\r\n\r\n  /** Constructor is private.  Caller responsible for cubicM validity. */\r\n  private constructor(length1: number, radius1: number, axisLength: number, cubicM: number) {\r\n    super(axisLength, cubicM);\r\n    this.nominalLength1 = length1;\r\n    this.nominalRadius1 = radius1;\r\n  }\r\n\r\n  /** Compute the czech cubic constant. */\r\n  public static computeCubicM(length1: number, radius1: number): number {\r\n    return 1.0 / (6.0 * length1 * radius1);\r\n  }\r\n\r\n  public static create(length1: number, radius1: number): PolishCubicEvaluator | undefined {\r\n    const m = this.computeCubicM(length1, radius1);\r\n    if (m === undefined)\r\n      return undefined;\r\n    const xMax = PolishCubicEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    if (xMax === undefined)\r\n      return undefined;\r\n    return new PolishCubicEvaluator(length1, radius1, xMax, m);\r\n  }\r\n\r\n  public override scaleInPlace(scaleFactor: number) {\r\n    this.nominalLength1 *= scaleFactor;\r\n    this.nominalRadius1 *= scaleFactor;\r\n    super.scaleInPlace(scaleFactor);\r\n  }\r\n  /** return a deep copy of the evaluator */\r\n  public clone(): PolishCubicEvaluator { return new PolishCubicEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }\r\n  /** Member by member matchup ... */\r\n  public isAlmostEqual(other: any): boolean {\r\n    if (other instanceof PolishCubicEvaluator) {\r\n      return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)\r\n        && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /** Compute the coefficient of x^4 in the x-to-distance series expansion */\r\n  public static computeX4SeriesCoefficient(length1: number, radius1: number): number {\r\n    return 1.0 / (4.0 * length1 * length1 * radius1 * radius1);\r\n  }\r\n  /**\r\n   * Evaluate a series approximation of distance along the true curve.\r\n   * @param x distance along x axis\r\n   * @param radius1 nominal end radius\r\n   * @param length1 nominal length along curve\r\n   * @returns\r\n   */\r\n  public static xToApproximateDistance(x: number, radius1: number, length1: number): number {\r\n    // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )\r\n    const a4 = this.computeX4SeriesCoefficient(length1, radius1);\r\n    const ax2 = a4 * x * x;\r\n    const ax3 = ax2 * x;\r\n    const ax4 = ax3 * x;\r\n    const s0 = x * (1.0 + ax4 * (0.1 + ax4 * (-1.0 / 72.0 + ax4 * (1.0 / 208.0 - 5.0 * ax4 / 2176.0))));\r\n    return s0;\r\n  }\r\n\r\n  /**\r\n   * Evaluate the derivative of the x-to-distance series.\r\n   * @param x distance along x axis\r\n   * @param radius1 nominal end radius\r\n   * @param length1 nominal length along curve\r\n   * @returns\r\n   */\r\n  public static xToApproximateDistanceDerivative(x: number, radius1: number, length1: number): number {\r\n    // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )\r\n    const a4 = this.computeX4SeriesCoefficient(length1, radius1);\r\n    const ax2 = a4 * x * x;\r\n    const ax3 = ax2 * x;\r\n    const ax4 = ax3 * x;\r\n    // derivative notes ..\r\n    // take away leading x -- this reduces each power by 1\r\n    // multiply each coefficient by its original power:\r\n    //  0.1==>0.5\r\n    // 1/72==> 9/72 = 1/8\r\n    // 1/208==>13/208=1/16\r\n    // 1/2176==>17/2176= 1/128\r\n    const ds = (1.0 + ax4 * (0.5 + ax4 * (-1.0 / 8.0 + ax4 * (1.0 / 16.0 - 5.0 * ax4 / 128.0))));\r\n    return ds;\r\n  }\r\n\r\n  /** Invert the xToApproximateDistance function. */\r\n  public static approximateDistanceAlongToX(s: number, radius1: number, length1: number): number | undefined {\r\n    const root = SimpleNewton.runNewton1D(s,\r\n      (x: number) => (this.xToApproximateDistance(x, radius1, length1) - s),\r\n      (x: number) => this.xToApproximateDistanceDerivative(x, radius1, length1));\r\n    return root;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PolishCubicSpiralEvaluator.js","sourceRoot":"","sources":["../../../../src/curve/spiral/PolishCubicSpiralEvaluator.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\nimport { Geometry } from \"../../Geometry\";\r\nimport { SimpleNewton } from \"../../numerics/Newton\";\r\nimport { CubicEvaluator } from \"./CubicEvaluator\";\r\n/**\r\n * Polish Cubic.\r\n * * Construction takes nominal length and end radius.\r\n * curve is  is y= m*x^3 with\r\n * * x any point on the x axis\r\n * * m is (1/6RL)\r\n * * Lx = x length is along the axis, determined by inversion of a distance series at nominal length\r\n * *\r\n * @param localToWorld\r\n * @param nominalL1\r\n * @param nominalR1\r\n * @param activeInterval\r\n * @internal\r\n */\r\nexport class PolishCubicEvaluator extends CubicEvaluator {\r\n  public nominalLength1: number;\r\n  public nominalRadius1: number;\r\n\r\n  /** Constructor is private.  Caller responsible for cubicM validity. */\r\n  private constructor(length1: number, radius1: number, axisLength: number, cubicM: number) {\r\n    super(axisLength, cubicM);\r\n    this.nominalLength1 = length1;\r\n    this.nominalRadius1 = radius1;\r\n  }\r\n\r\n  /** Compute the czech cubic constant. */\r\n  public static computeCubicM(length1: number, radius1: number): number {\r\n    return 1.0 / (6.0 * length1 * radius1);\r\n  }\r\n\r\n  public static create(length1: number, radius1: number): PolishCubicEvaluator | undefined {\r\n    const m = this.computeCubicM(length1, radius1);\r\n    if (m === undefined)\r\n      return undefined;\r\n    const xMax = PolishCubicEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    if (xMax === undefined)\r\n      return undefined;\r\n    return new PolishCubicEvaluator(length1, radius1, xMax, m);\r\n  }\r\n\r\n  public override scaleInPlace(scaleFactor: number) {\r\n    this.nominalLength1 *= scaleFactor;\r\n    this.nominalRadius1 *= scaleFactor;\r\n    super.scaleInPlace(scaleFactor);\r\n  }\r\n  /** return a deep copy of the evaluator */\r\n  public clone(): PolishCubicEvaluator { return new PolishCubicEvaluator(this.nominalLength1, this.nominalRadius1, this.axisLength, this.cubicM); }\r\n  /** Member by member matchup ... */\r\n  public isAlmostEqual(other: any): boolean {\r\n    if (other instanceof PolishCubicEvaluator) {\r\n      return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)\r\n        && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);\r\n    }\r\n    return false;\r\n  }\r\n\r\n  /** Compute the coefficient of x^4 in the x-to-distance series expansion */\r\n  public static computeX4SeriesCoefficient(length1: number, radius1: number): number {\r\n    return 1.0 / (4.0 * length1 * length1 * radius1 * radius1);\r\n  }\r\n  /**\r\n   * Evaluate a series approximation of distance along the true curve.\r\n   * @param x distance along x axis\r\n   * @param radius1 nominal end radius\r\n   * @param length1 nominal length along curve\r\n   * @returns\r\n   */\r\n  public static xToApproximateDistance(x: number, radius1: number, length1: number): number {\r\n    // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )\r\n    const a4 = this.computeX4SeriesCoefficient(length1, radius1);\r\n    const ax2 = a4 * x * x;\r\n    const ax3 = ax2 * x;\r\n    const ax4 = ax3 * x;\r\n    const s0 = x * (1.0 + ax4 * (0.1 + ax4 * (-1.0 / 72.0 + ax4 * (1.0 / 208.0 - 5.0 * ax4 / 2176.0))));\r\n    return s0;\r\n  }\r\n\r\n  /**\r\n   * Evaluate the derivative of the x-to-distance series.\r\n   * @param x distance along x axis\r\n   * @param radius1 nominal end radius\r\n   * @param length1 nominal length along curve\r\n   * @returns\r\n   */\r\n  public static xToApproximateDistanceDerivative(x: number, radius1: number, length1: number): number {\r\n    // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )\r\n    const a4 = this.computeX4SeriesCoefficient(length1, radius1);\r\n    const ax2 = a4 * x * x;\r\n    const ax3 = ax2 * x;\r\n    const ax4 = ax3 * x;\r\n    // derivative notes ..\r\n    // take away leading x -- this reduces each power by 1\r\n    // multiply each coefficient by its original power:\r\n    //  0.1==>0.5\r\n    // 1/72==> 9/72 = 1/8\r\n    // 1/208==>13/208=1/16\r\n    // 1/2176==>17/2176= 1/128\r\n    const ds = (1.0 + ax4 * (0.5 + ax4 * (-1.0 / 8.0 + ax4 * (1.0 / 16.0 - 5.0 * ax4 / 128.0))));\r\n    return ds;\r\n  }\r\n\r\n  /** Invert the xToApproximateDistance function. */\r\n  public static approximateDistanceAlongToX(s: number, radius1: number, length1: number): number | undefined {\r\n    const root = SimpleNewton.runNewton1D(s,\r\n      (x: number) => (this.xToApproximateDistance(x, radius1, length1) - s),\r\n      (x: number) => this.xToApproximateDistanceDerivative(x, radius1, length1));\r\n    return root;\r\n  }\r\n}\r\n"]}