@itwin/core-geometry 4.1.0-dev.8 → 4.1.0-dev.80

package/lib/esm/geometry3d/Plane3dByOriginAndVectors.js

@@ -18,10 +18,12 @@ import { Matrix3d } from "./Matrix3d";
  *   * are NOT required to be unit vectors.
  *   * are NOT required to be perpendicular vectors.
  * * The skewed, non-uniform scaling of the grid directions is the primary focus of this class.
- * * Queries of altitude, velocity, normalX, normalY, and normalZ use the NORMALIZED cross product of vectorU and vectorV as plane normal.
+ * * Queries of altitude, velocity, normalX, normalY, and normalZ use the NORMALIZED cross product of vectorU
+ * and vectorV as plane normal.
  *   * Hence these are cartesian distances.
  *   * If numerous calls to these are expected, the repeated normalization may be a performance issue.
- *   * Using a [[Plane3dByOriginAndUnitNormal]] or the rigid transform returned by [[toRigidFrame]] would provide better performance.
+ *   * Using a [[Plane3dByOriginAndUnitNormal]] or the rigid transform returned by [[toRigidFrame]] would provide
+ * better performance.
  * @public
  */
 export class Plane3dByOriginAndVectors extends Plane3d {
@@ -31,7 +33,7 @@ export class Plane3dByOriginAndVectors extends Plane3d {
         this.vectorU = vectorU;
         this.vectorV = vectorV;
     }
-    /** create a new plane from origin and 2 in-plane vectors. */
+    /** Create a new plane from origin and 2 in-plane vectors. */
     static createOriginAndVectors(origin, vectorU, vectorV, result) {
         if (result) {
             result.origin.setFrom(origin);
@@ -41,13 +43,14 @@ export class Plane3dByOriginAndVectors extends Plane3d {
         }
         return new Plane3dByOriginAndVectors(origin.clone(), vectorU.clone(), vectorV.clone());
     }
-    /** clone to a new plane. */
+    /** Clone to a new plane. */
     clone(result) {
         if (result !== undefined)
             result.setOriginAndVectors(this.origin, this.vectorU, this.vectorV);
         return new Plane3dByOriginAndVectors(this.origin.clone(), this.vectorU.clone(), this.vectorV.clone());
     }
-    /** create a new Plane3dByOriginAndVectors from a variety of plane types.
+    /**
+     * Create a new Plane3dByOriginAndVectors from a variety of plane types.
      * * The input is NOT captured.
      */
     static createFrom(source, result) {
@@ -106,7 +109,8 @@ export class Plane3dByOriginAndVectors extends Plane3d {
         this.vectorV.set(vx, vy, vz);
         return this;
     }
-    /** Set all origin and both vectors from coordinates in given origin and vectors.
+    /**
+     * Set all origin and both vectors from coordinates in given origin and vectors.
      * * Note that coordinates are copied out of the parameters -- the given parameters are NOT retained by reference.
      */
     setOriginAndVectors(origin, vectorU, vectorV) {
@@ -121,7 +125,8 @@ export class Plane3dByOriginAndVectors extends Plane3d {
             return result.setOriginAndVectorsXYZ(x0, y0, z0, ux, uy, uz, vx, vy, vz);
         return new Plane3dByOriginAndVectors(Point3d.create(x0, y0, z0), Vector3d.create(ux, uy, uz), Vector3d.create(vx, vy, vz));
     }
-    /** Define a plane by three points in the plane.
+    /**
+     * Define a plane by three points in the plane.
      * @param origin origin for the parameterization.
      * @param targetU target point for the vectorU starting at the origin.
      * @param targetV target point for the vectorV originating at the origin.
@@ -134,7 +139,8 @@ export class Plane3dByOriginAndVectors extends Plane3d {
     static createXYPlane(result) {
         return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(0, 0, 0, 1, 0, 0, 0, 1, 0, result);
     }
-    /** create a plane from data presented as Float64Arrays.
+    /**
+     * Create a plane from data presented as Float64Arrays.
      * @param origin x,y,z of origin.
      * @param vectorU x,y,z of vectorU
      * @param vectorV x,y,z of vectorV
@@ -142,7 +148,8 @@ export class Plane3dByOriginAndVectors extends Plane3d {
     static createOriginAndVectorsArrays(origin, vectorU, vectorV, result) {
         return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(origin[0], origin[1], origin[2], vectorU[0], vectorU[1], vectorU[2], vectorV[0], vectorV[1], vectorV[2], result);
     }
-    /** create a plane from data presented as Float64Array with weights
+    /**
+     * Create a plane from data presented as Float64Array with weights
      * @param origin x,y,z,w of origin.
      * @param vectorU x,y,z,w of vectorU
      * @param vectorV x,y,z,w of vectorV
@@ -206,7 +213,7 @@ export class Plane3dByOriginAndVectors extends Plane3d {
             vectorV: this.vectorV.toJSON(),
         };
     }
-    /** create a new plane.   See `setFromJSON` for layout example. */
+    /** Create a new plane.   See `setFromJSON` for layout example. */
     static fromJSON(json) {
         const result = Plane3dByOriginAndVectors.createXYPlane();
         result.setFromJSON(json);
@@ -218,7 +225,8 @@ export class Plane3dByOriginAndVectors extends Plane3d {
             && this.vectorU.isAlmostEqual(other.vectorU)
             && this.vectorV.isAlmostEqual(other.vectorV);
     }
-    /** Normalize both `vectorU` and `vectorV` in place.  This does NOT make them perpendicular.
+    /**
+     * Normalize both `vectorU` and `vectorV` in place. This does NOT make them perpendicular.
      * * Return true if both succeeded.
      */
     normalizeInPlace() {
@@ -226,9 +234,7 @@ export class Plane3dByOriginAndVectors extends Plane3d {
         const okV = this.vectorV.normalizeInPlace();
         return okU && okV;
     }
-    /**
-     * Return (if possible) a unit normal to the plane.
-     */
+    /** Return (if possible) a unit normal to the plane */
     getUnitNormal(result) {
         return this.vectorU.unitCrossProduct(this.vectorV, result);
     }
@@ -243,11 +249,11 @@ export class Plane3dByOriginAndVectors extends Plane3d {
      * Return some point on the plane.
      */
     getAnyPointOnPlane(result) {
+        // This function returns the plane origin. In general, a point x is on the plane if
+        // and only if x = o + a*u + b*v, where a and b are scalars.
         return this.origin.clone(result);
     }
-    /**
-     * Return (if possible) a ray with origin at plane origin, direction as unit normal to the plane.
-     */
+    /** Return (if possible) a ray with origin at plane origin, direction as unit normal to the plane */
     unitNormalRay(result) {
         if (!Plane3dByOriginAndVectors._workVector)
             Plane3dByOriginAndVectors._workVector = Vector3d.create();
@@ -267,27 +273,24 @@ export class Plane3dByOriginAndVectors extends Plane3d {
     toRigidFrame(result) {
         return Transform.createRigidFromOriginAndColumns(this.origin, this.vectorU, this.vectorV, AxisOrder.XYZ, result);
     }
-    /**
-     * Apply the transform to the origin and vectors in place.
-     */
+    /** Apply the transform to the origin and vectors in place */
     transformInPlace(transform) {
         transform.multiplyPoint3d(this.origin, this.origin);
         transform.multiplyVector(this.vectorU, this.vectorU);
         transform.multiplyVector(this.vectorV, this.vectorV);
     }
-    // Implement PlaneAltitudeEvaluator methods . . .
     /**
      * Return x component of the (normalized!) {vectorU CROSS vectorV}.
      * Return 0 if the cross product is zero.
-     * */
+     */
     normalX() {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         return unitNormal !== undefined ? unitNormal.x : 0.0;
     }
     /**
-  * Return y component of the (normalized!) {vectorU CROSS vectorV}.
-  * Return 0 if the cross product is zero.
-  * */
+     * Return y component of the (normalized!) {vectorU CROSS vectorV}.
+     * Return 0 if the cross product is zero.
+     */
     normalY() {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         return unitNormal !== undefined ? unitNormal.y : 0.0;
@@ -295,41 +298,43 @@ export class Plane3dByOriginAndVectors extends Plane3d {
     /**
      * Return z component of the (normalized!) {vectorU CROSS vectorV}.
      * Return 0 if the cross product is zero.
-     * */
+     */
     normalZ() {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         return unitNormal !== undefined ? unitNormal.z : 0.0;
     }
-    /** Return signed cartesian altitude perpendicular to the plane.  This uses the normalized cross product as normal. */
+    /** Return signed cartesian altitude perpendicular to the plane. This uses the normalized cross product as normal. */
     altitude(xyz) {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         if (unitNormal === undefined)
             return 0.0;
         return Geometry.dotProductXYZXYZ((xyz.x - this.origin.x), (xyz.y - this.origin.y), (xyz.z - this.origin.z), unitNormal.x, unitNormal.y, unitNormal.z);
     }
-    /** Return signed cartesian altitude perpendicular to the plane.  This uses the normalized cross product as normal. */
+    /** Return signed cartesian altitude perpendicular to the plane. This uses the normalized cross product as normal. */
     altitudeXYZ(x, y, z) {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         if (unitNormal === undefined)
             return 0.0;
         return Geometry.dotProductXYZXYZ((x - this.origin.x), (y - this.origin.y), (z - this.origin.z), unitNormal.x, unitNormal.y, unitNormal.z);
     }
-    /** Return signed projection of the input vector to the plane normal.  This uses the normalized cross product as normal. */
+    /** Return signed projection of the input vector to the plane normal. This uses the normalized cross product as normal. */
     velocity(xyzVector) {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         if (unitNormal === undefined)
             return 0.0;
         return Geometry.dotProductXYZXYZ(xyzVector.x, xyzVector.y, xyzVector.z, unitNormal.x, unitNormal.y, unitNormal.z);
     }
-    /** Return signed projection of the input vector to the plane normal.  This uses the normalized cross product as normal. */
+    /** Return signed projection of the input vector to the plane normal. This uses the normalized cross product as normal. */
     velocityXYZ(x, y, z) {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         if (unitNormal === undefined)
             return 0.0;
         return Geometry.dotProductXYZXYZ(x, y, z, unitNormal.x, unitNormal.y, unitNormal.z);
     }
-    /** Return triple product of homogeneous difference {(xyzw - w * origin)} with vectorU and vectorV.
-     * * In the usual manner of homogeneous calculations, this is proportional to true cartesian distance from the plane but is not a physical distance.
+    /**
+     * Return triple product of homogeneous difference {(xyzw - w * origin)} with vectorU and vectorV.
+     * * In the usual manner of homogeneous calculations, this is proportional to true cartesian distance from the
+     * plane but is not a physical distance.
      */
     weightedAltitude(xyzw) {
         const w = xyzw.w;

package/lib/esm/geometry3d/Plane3dByOriginAndVectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plane3dByOriginAndVectors.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndVectors.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,SAAS,EAAmB,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAA0B,SAAQ,OAAO;IAOpD,YAAoB,MAAe,EAAE,OAAiB,EAAE,OAAiB;QACvE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IACD,6DAA6D;IACtD,MAAM,CAAC,sBAAsB,CAAC,MAAe,EAAE,OAAiB,EAAE,OAAiB,EAAE,MAAkC;QAC5H,IAAI,MAAM,EAAE;YACV,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,MAAM,CAAC;SACf;QACD,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,4BAA4B;IACrB,KAAK,CAAC,MAAkC;QAC7C,IAAI,MAAM,KAAK,SAAS;YACtB,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,IAAI,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxG,CAAC;IACD;;OAEG;IACI,MAAM,CAAC,UAAU,CAAC,MAAe,EAAE,MAAkC;QAC1E,IAAI,MAAM,YAAY,yBAAyB;YAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS;YACtB,OAAO,SAAS,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,qCAAqC,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,mBAAmB,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,OAAO,KAAK,SAAS;gBACvB,OAAO,IAAI,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAClE;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,sCAAsC,CAAC,SAAoB,EACvE,OAA2B,EAAE,OAA2B,EACxD,MAAkC;QAClC,IAAI,MAAM,EAAE;YACV,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7C,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;SAC1C;aAAM;YACL,MAAM,GAAG,IAAI,yBAAyB,CACpC,SAAS,CAAC,SAAS,EAAE,EACrB,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAC1B,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;SAC/B;QACD,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,oDAAoD;IAC7C,MAAM,CAAC,aAAa,CAAC,MAAe,EAAE,OAAiB,EAAE,OAAiB,EAAE,MAAkC;QACnH,IAAI,CAAC,MAAM;YACT,OAAO,IAAI,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qEAAqE;IAC9D,sBAAsB,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACtI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD;;OAEG;IACI,mBAAmB,CAAC,MAAe,EAAE,OAAiB,EAAE,OAAiB;QAC9E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,wDAAwD;IACjD,MAAM,CAAC,yBAAyB,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,MAAkC;QACpL,IAAI,MAAM;YACR,OAAO,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7H,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,sBAAsB,CAAC,MAAe,EAAE,OAAgB,EAAE,OAAgB,EAAE,MAAkC;QAC1H,OAAO,yBAAyB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACvO,CAAC;IACD,2GAA2G;IACpG,MAAM,CAAC,aAAa,CAAC,MAAkC;QAC5D,OAAO,yBAAyB,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,4BAA4B,CAAC,MAAoB,EAAE,OAAqB,EAAE,OAAqB,EAAE,MAAkC;QAC/I,OAAO,yBAAyB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9K,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,oCAAoC,CAAC,OAAqB,EAAE,QAAsB,EAAE,QAAsB,EAAE,MAAkC;QAC1J,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,GAAG,yBAAyB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC;QAChB,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACjC,iDAAiD;QACjD,gCAAgC;QAChC,+BAA+B;QAC/B,+BAA+B;QAC/B,6BAA6B;QAC7B,yDAAyD;QACzD,mEAAmE;QACnE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACrE,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACjI,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACjI,OAAO,MAAM,CAAC;IAChB,CAAC;IACD;;;;;;;OAOG;IACI,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,MAAgB;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IACD,6EAA6E;IACtE,gBAAgB,CAAC,CAAS,EAAE,CAAS,EAAE,MAAiB;QAC7D,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IACD,sGAAsG;IAC/F,WAAW,CAAC,IAAU;QAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SAC3B;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACxC;IACH,CAAC;IACD;;;OAGG;IACI,MAAM;QACX,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;SAC/B,CAAC;IACJ,CAAC;IACD,kEAAkE;IAC3D,MAAM,CAAC,QAAQ,CAAC,IAAU;QAC/B,MAAM,MAAM,GAAG,yBAAyB,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,6DAA6D;IACtD,aAAa,CAAC,KAAgC;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;eACzC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;eACzC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD;;OAEG;IACI,gBAAgB;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC5C,OAAO,GAAG,IAAI,GAAG,CAAC;IACpB,CAAC;IACD;;OAEG;IACa,aAAa,CAAC,MAAiB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD;;;OAGG;IACI,UAAU,CAAC,MAAiB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACa,kBAAkB,CAAC,MAAgB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,MAAc;QACjC,IAAI,CAAC,yBAAyB,CAAC,WAAW;YACxC,yBAAyB,CAAC,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,WAAW,CAAC,CAAC;QACtG,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,SAAS,CAAC;QACnB,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACI,YAAY,CAAC,MAAkB;QACpC,OAAO,SAAS,CAAC,+BAA+B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnH,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,SAAoB;QAC1C,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IACD,iDAAiD;IACjD;;;SAGK;IACE,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,CAAC;IACD;;;MAGE;IACK,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,CAAC;IACD;;;SAGK;IACE,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,CAAC;IACD,sHAAsH;IAC/G,QAAQ,CAAC,GAAW;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,GAAG,CAAC;QACb,OAAO,QAAQ,CAAC,gBAAgB,CAC9B,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EACzE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,sHAAsH;IAC/G,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,GAAG,CAAC;QACb,OAAO,QAAQ,CAAC,gBAAgB,CAC9B,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAC7D,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,2HAA2H;IACpH,QAAQ,CAAC,SAAiB;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,GAAG,CAAC;QACb,OAAO,QAAQ,CAAC,gBAAgB,CAC9B,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EACrC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,2HAA2H;IACpH,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,GAAG,CAAC;QACb,OAAO,QAAQ,CAAC,gBAAgB,CAC9B,CAAC,EAAE,CAAC,EAAE,CAAC,EACP,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD;;OAEG;IACI,gBAAgB,CAAC,IAAa;QACnC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACjB,OAAO,QAAQ,CAAC,aAAa,CAC3B,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EACxF,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAC9C,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD;;;;OAIG;IACI,mBAAmB,CAAC,UAAmB,EAAE,MAAgB;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS,EAAE;YAC5B,MAAM,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACjE,OAAO,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;SACtD;QACD,qDAAqD;QACrD,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,KAAK,IAAI,KAAK,EAAE;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,SAAS;gBACjB,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;SACzD;aAAM;YACL,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,SAAS;gBACjB,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;SACzD;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,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 CartesianGeometry\r\n */\r\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { Plane3d } from \"./Plane3d\";\r\nimport { Point4d } from \"../geometry4d/Point4d\";\r\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\r\nimport { Ray3d } from \"./Ray3d\";\r\nimport { Transform } from \"./Transform\";\r\nimport { XYAndZ } from \"./XYZProps\";\r\nimport { Matrix3d } from \"./Matrix3d\";\r\n\r\n/**\r\n * A Plane3dByOriginAndVectors is an origin and a pair of vectors.\r\n * This defines a plane with a (possibly skewed) uv coordinate grid\r\n * * The grid directions (`vectorU` and `vectorV`)\r\n *   * are NOT required to be unit vectors.\r\n *   * are NOT required to be perpendicular vectors.\r\n * * The skewed, non-uniform scaling of the grid directions is the primary focus of this class.\r\n * * Queries of altitude, velocity, normalX, normalY, and normalZ use the NORMALIZED cross product of vectorU and vectorV as plane normal.\r\n *   * Hence these are cartesian distances.\r\n *   * If numerous calls to these are expected, the repeated normalization may be a performance issue.\r\n *   * Using a [[Plane3dByOriginAndUnitNormal]] or the rigid transform returned by [[toRigidFrame]] would provide better performance.\r\n * @public\r\n */\r\nexport class Plane3dByOriginAndVectors extends Plane3d implements BeJSONFunctions {\r\n  /** origin of plane grid */\r\n  public origin: Point3d;\r\n  /** u direction in plane grid */\r\n  public vectorU: Vector3d;\r\n  /** v direction in plane grid */\r\n  public vectorV: Vector3d;\r\n  private constructor(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d) {\r\n    super();\r\n    this.origin = origin;\r\n    this.vectorU = vectorU;\r\n    this.vectorV = vectorV;\r\n  }\r\n  /** create a new plane from origin and 2 in-plane vectors. */\r\n  public static createOriginAndVectors(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    if (result) {\r\n      result.origin.setFrom(origin);\r\n      result.vectorU.setFrom(vectorU);\r\n      result.vectorV.setFrom(vectorV);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndVectors(origin.clone(), vectorU.clone(), vectorV.clone());\r\n  }\r\n  /** clone to a new plane. */\r\n  public clone(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    if (result !== undefined)\r\n      result.setOriginAndVectors(this.origin, this.vectorU, this.vectorV);\r\n    return new Plane3dByOriginAndVectors(this.origin.clone(), this.vectorU.clone(), this.vectorV.clone());\r\n  }\r\n  /** create a new Plane3dByOriginAndVectors from a variety of plane types.\r\n   * * The input is NOT captured.\r\n   */\r\n  public static createFrom(source: Plane3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors | undefined {\r\n    if (source instanceof Plane3dByOriginAndVectors)\r\n      return source.clone(result);\r\n    const normal = source.getUnitNormal();\r\n    if (normal === undefined)\r\n      return undefined;\r\n    const origin = source.getAnyPointOnPlane();\r\n    const vectorU = Matrix3d.createPerpendicularVectorFavorXYPlane(normal);\r\n    if (vectorU.tryNormalizeInPlace()) {\r\n      const vectorV = normal.unitCrossProduct(vectorU);\r\n      if (vectorV !== undefined)\r\n        return new Plane3dByOriginAndVectors(origin, vectorU, vectorV);\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Return a Plane3dByOriginAndVectors, with\r\n   * * origin is the translation (aka origin) from the Transform\r\n   * * vectorU is the X column of the transform\r\n   * * vectorV is the Y column of the transform.\r\n   * @param transform source transform\r\n   * @param xLength optional length to impose on vectorU.\r\n   * @param yLength optional length to impose on vectorV.\r\n   * @param result optional preexisting result\r\n   */\r\n  public static createFromTransformColumnsXYAndLengths(transform: Transform,\r\n    xLength: number | undefined, yLength: number | undefined,\r\n    result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    if (result) {\r\n      result.origin.setFrom(transform.getOrigin());\r\n      transform.matrix.columnX(result.vectorU);\r\n      transform.matrix.columnY(result.vectorV);\r\n    } else {\r\n      result = new Plane3dByOriginAndVectors(\r\n        transform.getOrigin(),\r\n        transform.matrix.columnX(),\r\n        transform.matrix.columnY());\r\n    }\r\n    if (xLength !== undefined)\r\n      result.vectorU.scaleToLength(xLength, result.vectorU);\r\n    if (yLength !== undefined)\r\n      result.vectorV.scaleToLength(yLength, result.vectorV);\r\n    return result;\r\n  }\r\n  /** Capture origin and directions in a new plane. */\r\n  public static createCapture(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    if (!result)\r\n      return new Plane3dByOriginAndVectors(origin, vectorU, vectorV);\r\n    result.origin = origin;\r\n    result.vectorU = vectorU;\r\n    result.vectorV = vectorV;\r\n    return result;\r\n  }\r\n\r\n  /** Set all origin and both vectors from direct numeric parameters */\r\n  public setOriginAndVectorsXYZ(x0: number, y0: number, z0: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number): Plane3dByOriginAndVectors {\r\n    this.origin.set(x0, y0, z0);\r\n    this.vectorU.set(ux, uy, uz);\r\n    this.vectorV.set(vx, vy, vz);\r\n    return this;\r\n  }\r\n  /** Set all origin and both vectors from coordinates in given origin and vectors.\r\n   * * Note that coordinates are copied out of the parameters -- the given parameters are NOT retained by reference.\r\n   */\r\n  public setOriginAndVectors(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d): Plane3dByOriginAndVectors {\r\n    this.origin.setFrom(origin);\r\n    this.vectorU.setFrom(vectorU);\r\n    this.vectorV.setFrom(vectorV);\r\n    return this;\r\n  }\r\n  /** Create a new plane from direct numeric parameters */\r\n  public static createOriginAndVectorsXYZ(x0: number, y0: number, z0: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    if (result)\r\n      return result.setOriginAndVectorsXYZ(x0, y0, z0, ux, uy, uz, vx, vy, vz);\r\n    return new Plane3dByOriginAndVectors(Point3d.create(x0, y0, z0), Vector3d.create(ux, uy, uz), Vector3d.create(vx, vy, vz));\r\n  }\r\n  /** Define a plane by three points in the plane.\r\n   * @param origin origin for the parameterization.\r\n   * @param targetU target point for the vectorU starting at the origin.\r\n   * @param targetV target point for the vectorV originating at the origin.\r\n   * @param result optional result.\r\n   */\r\n  public static createOriginAndTargets(origin: Point3d, targetU: Point3d, targetV: Point3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(origin.x, origin.y, origin.z, targetU.x - origin.x, targetU.y - origin.y, targetU.z - origin.z, targetV.x - origin.x, targetV.y - origin.y, targetV.z - origin.z, result);\r\n  }\r\n  /** Create a plane with origin at 000, unit vectorU in x direction, and unit vectorV in the y direction. */\r\n  public static createXYPlane(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(0, 0, 0, 1, 0, 0, 0, 1, 0, result);\r\n  }\r\n  /** create a plane from data presented as Float64Arrays.\r\n   * @param origin x,y,z of origin.\r\n   * @param vectorU x,y,z of vectorU\r\n   * @param vectorV x,y,z of vectorV\r\n   */\r\n  public static createOriginAndVectorsArrays(origin: Float64Array, vectorU: Float64Array, vectorV: Float64Array, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(origin[0], origin[1], origin[2], vectorU[0], vectorU[1], vectorU[2], vectorV[0], vectorV[1], vectorV[2], result);\r\n  }\r\n  /** create a plane from data presented as Float64Array with weights\r\n   * @param origin x,y,z,w of origin.\r\n   * @param vectorU x,y,z,w of vectorU\r\n   * @param vectorV x,y,z,w of vectorV\r\n   */\r\n  public static createOriginAndVectorsWeightedArrays(originW: Float64Array, vectorUw: Float64Array, vectorVw: Float64Array, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\r\n    const w = originW[3];\r\n    result = Plane3dByOriginAndVectors.createXYPlane(result);\r\n    if (Geometry.isSmallMetricDistance(w))\r\n      return result;\r\n    const dw = 1.0 / w;\r\n    const au = vectorUw[3] * dw * dw;\r\n    const av = vectorVw[3] * dw * dw;\r\n    // for homogeneous function X, with w its weight:\r\n    // (X/w) is the cartesian point.\r\n    // (X/w)' = (X' w - X w')/(w*w)\r\n    //        = X'/w  - (X/w)(w'/w)\r\n    //        = X'/w  - X w'/w^2)\r\n    // The w parts of the formal xyzw sums are identically 0.\r\n    // Here the X' and its w' are taken from each vectorUw and vectorVw\r\n    result.origin.set(originW[0] * dw, originW[1] * dw, originW[2] * dw);\r\n    Vector3d.createAdd2ScaledXYZ(vectorUw[0], vectorUw[1], vectorUw[2], dw, originW[0], originW[1], originW[2], -au, result.vectorU);\r\n    Vector3d.createAdd2ScaledXYZ(vectorVw[0], vectorVw[1], vectorVw[2], dw, originW[0], originW[1], originW[2], -av, result.vectorV);\r\n    return result;\r\n  }\r\n  /**\r\n   * Evaluate a point a grid coordinates on the plane.\r\n   * * The computed point is `origin + vectorU * u + vectorV * v`\r\n   * @param u coordinate along vectorU\r\n   * @param v coordinate along vectorV\r\n   * @param result optional result destination.\r\n   * @returns Return the computed coordinate.\r\n   */\r\n  public fractionToPoint(u: number, v: number, result?: Point3d): Point3d {\r\n    return this.origin.plus2Scaled(this.vectorU, u, this.vectorV, v, result);\r\n  }\r\n  /** Return the vector from the plane origin to parametric coordinate (u.v) */\r\n  public fractionToVector(u: number, v: number, result?: Vector3d): Vector3d {\r\n    return Vector3d.createAdd2Scaled(this.vectorU, u, this.vectorV, v, result);\r\n  }\r\n  /** Set coordinates from a json object such as `{origin: [1,2,3], vectorU:[4,5,6], vectorV[3,2,1]}` */\r\n  public setFromJSON(json?: any) {\r\n    if (!json || !json.origin || !json.vectorV) {\r\n      this.origin.set(0, 0, 0);\r\n      this.vectorU.set(1, 0, 0);\r\n      this.vectorV.set(0, 1, 0);\r\n    } else {\r\n      this.origin.setFromJSON(json.origin);\r\n      this.vectorU.setFromJSON(json.vectorU);\r\n      this.vectorV.setFromJSON(json.vectorV);\r\n    }\r\n  }\r\n  /**\r\n   * Convert an Angle to a JSON object.\r\n   * @return {*} [origin,normal]\r\n   */\r\n  public toJSON(): any {\r\n    return {\r\n      origin: this.origin.toJSON(),\r\n      vectorU: this.vectorU.toJSON(),\r\n      vectorV: this.vectorV.toJSON(),\r\n    };\r\n  }\r\n  /** create a new plane.   See `setFromJSON` for layout example. */\r\n  public static fromJSON(json?: any): Plane3dByOriginAndVectors {\r\n    const result = Plane3dByOriginAndVectors.createXYPlane();\r\n    result.setFromJSON(json);\r\n    return result;\r\n  }\r\n  /** Test origin and vectors for isAlmostEqual with `other` */\r\n  public isAlmostEqual(other: Plane3dByOriginAndVectors): boolean {\r\n    return this.origin.isAlmostEqual(other.origin)\r\n      && this.vectorU.isAlmostEqual(other.vectorU)\r\n      && this.vectorV.isAlmostEqual(other.vectorV);\r\n  }\r\n  /** Normalize both `vectorU` and `vectorV` in place.  This does NOT make them perpendicular.\r\n   * * Return true if both succeeded.\r\n   */\r\n  public normalizeInPlace(): boolean {\r\n    const okU = this.vectorU.normalizeInPlace();\r\n    const okV = this.vectorV.normalizeInPlace();\r\n    return okU && okV;\r\n  }\r\n  /**\r\n   * Return (if possible) a unit normal to the plane.\r\n   */\r\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\r\n    return this.vectorU.unitCrossProduct(this.vectorV, result);\r\n  }\r\n  /**\r\n   * Return (if possible) a unit normal to the plane.\r\n   * * This method is the same as getUnitNormal, which was created later as part of the abstract base class Plane3d.\r\n   */\r\n  public unitNormal(result?: Vector3d): Vector3d | undefined {\r\n    return this.vectorU.unitCrossProduct(this.vectorV, result);\r\n  }\r\n\r\n  /**\r\n   * Return some point on the plane.\r\n   */\r\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\r\n    return this.origin.clone(result);\r\n  }\r\n  private static _workVector: Vector3d;\r\n  /**\r\n   * Return (if possible) a ray with origin at plane origin, direction as unit normal to the plane.\r\n   */\r\n  public unitNormalRay(result?: Ray3d): Ray3d | undefined {\r\n    if (!Plane3dByOriginAndVectors._workVector)\r\n      Plane3dByOriginAndVectors._workVector = Vector3d.create();\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV, Plane3dByOriginAndVectors._workVector);\r\n    if (unitNormal === undefined)\r\n      return undefined;\r\n    return Ray3d.create(this.origin, unitNormal, result);\r\n  }\r\n\r\n  /**\r\n   * Create a rigid frame (i.e. frenet frame) with\r\n   * * origin at the plane origin\r\n   * * x axis along the (normalized) vectorU\r\n   * * y axis normalized vectorU to vectorV plane, and perpendicular to x axis\r\n   * * z axis perpendicular to both.\r\n   * @param result optional result\r\n   */\r\n  public toRigidFrame(result?: Transform): Transform | undefined {\r\n    return Transform.createRigidFromOriginAndColumns(this.origin, this.vectorU, this.vectorV, AxisOrder.XYZ, result);\r\n  }\r\n\r\n  /**\r\n   * Apply the transform to the origin and vectors in place.\r\n   */\r\n  public transformInPlace(transform: Transform) {\r\n    transform.multiplyPoint3d(this.origin, this.origin);\r\n    transform.multiplyVector(this.vectorU, this.vectorU);\r\n    transform.multiplyVector(this.vectorV, this.vectorV);\r\n  }\r\n  // Implement PlaneAltitudeEvaluator methods . . .\r\n  /**\r\n   * Return x component of the (normalized!) {vectorU CROSS vectorV}.\r\n   * Return 0 if the cross product is zero.\r\n   * */\r\n  public normalX(): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    return unitNormal !== undefined ? unitNormal.x : 0.0;\r\n  }\r\n  /**\r\n* Return y component of the (normalized!) {vectorU CROSS vectorV}.\r\n* Return 0 if the cross product is zero.\r\n* */\r\n  public normalY(): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    return unitNormal !== undefined ? unitNormal.y : 0.0;\r\n  }\r\n  /**\r\n   * Return z component of the (normalized!) {vectorU CROSS vectorV}.\r\n   * Return 0 if the cross product is zero.\r\n   * */\r\n  public normalZ(): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    return unitNormal !== undefined ? unitNormal.z : 0.0;\r\n  }\r\n  /** Return signed cartesian altitude perpendicular to the plane.  This uses the normalized cross product as normal. */\r\n  public altitude(xyz: XYAndZ): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    if (unitNormal === undefined)\r\n      return 0.0;\r\n    return Geometry.dotProductXYZXYZ(\r\n      (xyz.x - this.origin.x), (xyz.y - this.origin.y), (xyz.z - this.origin.z),\r\n      unitNormal.x, unitNormal.y, unitNormal.z);\r\n  }\r\n  /** Return signed cartesian altitude perpendicular to the plane.  This uses the normalized cross product as normal. */\r\n  public altitudeXYZ(x: number, y: number, z: number): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    if (unitNormal === undefined)\r\n      return 0.0;\r\n    return Geometry.dotProductXYZXYZ(\r\n      (x - this.origin.x), (y - this.origin.y), (z - this.origin.z),\r\n      unitNormal.x, unitNormal.y, unitNormal.z);\r\n  }\r\n  /** Return signed projection of the input vector to the plane normal.  This uses the normalized cross product as normal. */\r\n  public velocity(xyzVector: XYAndZ): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    if (unitNormal === undefined)\r\n      return 0.0;\r\n    return Geometry.dotProductXYZXYZ(\r\n      xyzVector.x, xyzVector.y, xyzVector.z,\r\n      unitNormal.x, unitNormal.y, unitNormal.z);\r\n  }\r\n  /** Return signed projection of the input vector to the plane normal.  This uses the normalized cross product as normal. */\r\n  public velocityXYZ(x: number, y: number, z: number): number {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    if (unitNormal === undefined)\r\n      return 0.0;\r\n    return Geometry.dotProductXYZXYZ(\r\n      x, y, z,\r\n      unitNormal.x, unitNormal.y, unitNormal.z);\r\n  }\r\n  /** Return triple product of homogeneous difference {(xyzw - w * origin)} with vectorU and vectorV.\r\n   * * In the usual manner of homogeneous calculations, this is proportional to true cartesian distance from the plane but is not a physical distance.\r\n   */\r\n  public weightedAltitude(xyzw: Point4d) {\r\n    const w = xyzw.w;\r\n    return Geometry.tripleProduct(\r\n      (xyzw.x - this.origin.x * w), (xyzw.y - this.origin.y * w), (xyzw.z - this.origin.z * w),\r\n      this.vectorU.x, this.vectorU.y, this.vectorU.z,\r\n      this.vectorV.x, this.vectorV.y, this.vectorV.z);\r\n  }\r\n  /**\r\n   * Return the projection of spacePoint onto the plane.\r\n   * If the plane is degenerate to a ray, project to the ray.\r\n   * If the plane is degenerate to its origin, return the point\r\n   */\r\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\r\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\r\n    if (unitNormal !== undefined) {\r\n      const w = unitNormal.dotProductStartEnd(this.origin, spacePoint);\r\n      return spacePoint.plusScaled(unitNormal, -w, result);\r\n    }\r\n    // uh oh.   vectorU and vectorV are colinear or zero.\r\n    // project to ray defined by the longer one, or just to origin.\r\n    const dotUU = this.vectorU.magnitudeSquared();\r\n    const dotVV = this.vectorV.magnitudeSquared();\r\n    if (dotUU >= dotVV) {\r\n      const dotUW = this.vectorU.dotProductStartEnd(this.origin, spacePoint);\r\n      const f = Geometry.conditionalDivideCoordinate(dotUW, dotUU, 0.0);\r\n      if (f !== undefined)\r\n        return spacePoint.plusScaled(this.vectorU, f, result);\r\n    } else {\r\n      const dotVW = this.vectorV.dotProductStartEnd(this.origin, spacePoint);\r\n      const f = Geometry.conditionalDivideCoordinate(dotVW, dotVV, 0.0);\r\n      if (f !== undefined)\r\n        return spacePoint.plusScaled(this.vectorV, f, result);\r\n    }\r\n    return this.origin.clone(result);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Plane3dByOriginAndVectors.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndVectors.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\nimport { Plane3d } from \"./Plane3d\";\nimport { Point4d } from \"../geometry4d/Point4d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\nimport { Ray3d } from \"./Ray3d\";\nimport { Transform } from \"./Transform\";\nimport { XYAndZ } from \"./XYZProps\";\nimport { Matrix3d } from \"./Matrix3d\";\n\n/**\n * A Plane3dByOriginAndVectors is an origin and a pair of vectors.\n * This defines a plane with a (possibly skewed) uv coordinate grid\n * * The grid directions (`vectorU` and `vectorV`)\n *   * are NOT required to be unit vectors.\n *   * are NOT required to be perpendicular vectors.\n * * The skewed, non-uniform scaling of the grid directions is the primary focus of this class.\n * * Queries of altitude, velocity, normalX, normalY, and normalZ use the NORMALIZED cross product of vectorU\n * and vectorV as plane normal.\n *   * Hence these are cartesian distances.\n *   * If numerous calls to these are expected, the repeated normalization may be a performance issue.\n *   * Using a [[Plane3dByOriginAndUnitNormal]] or the rigid transform returned by [[toRigidFrame]] would provide\n * better performance.\n * @public\n */\nexport class Plane3dByOriginAndVectors extends Plane3d implements BeJSONFunctions {\n  /** Origin of plane grid */\n  public origin: Point3d;\n  /** u direction in plane grid */\n  public vectorU: Vector3d;\n  /** v direction in plane grid */\n  public vectorV: Vector3d;\n  private constructor(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d) {\n    super();\n    this.origin = origin;\n    this.vectorU = vectorU;\n    this.vectorV = vectorV;\n  }\n  /** Create a new plane from origin and 2 in-plane vectors. */\n  public static createOriginAndVectors(\n    origin: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    if (result) {\n      result.origin.setFrom(origin);\n      result.vectorU.setFrom(vectorU);\n      result.vectorV.setFrom(vectorV);\n      return result;\n    }\n    return new Plane3dByOriginAndVectors(origin.clone(), vectorU.clone(), vectorV.clone());\n  }\n  /** Clone to a new plane. */\n  public clone(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\n    if (result !== undefined)\n      result.setOriginAndVectors(this.origin, this.vectorU, this.vectorV);\n    return new Plane3dByOriginAndVectors(this.origin.clone(), this.vectorU.clone(), this.vectorV.clone());\n  }\n  /**\n   * Create a new Plane3dByOriginAndVectors from a variety of plane types.\n   * * The input is NOT captured.\n   */\n  public static createFrom(source: Plane3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors | undefined {\n    if (source instanceof Plane3dByOriginAndVectors)\n      return source.clone(result);\n    const normal = source.getUnitNormal();\n    if (normal === undefined)\n      return undefined;\n    const origin = source.getAnyPointOnPlane();\n    const vectorU = Matrix3d.createPerpendicularVectorFavorXYPlane(normal);\n    if (vectorU.tryNormalizeInPlace()) {\n      const vectorV = normal.unitCrossProduct(vectorU);\n      if (vectorV !== undefined)\n        return new Plane3dByOriginAndVectors(origin, vectorU, vectorV);\n    }\n    return undefined;\n  }\n\n  /**\n   * Return a Plane3dByOriginAndVectors, with\n   * * origin is the translation (aka origin) from the Transform\n   * * vectorU is the X column of the transform\n   * * vectorV is the Y column of the transform.\n   * @param transform source transform\n   * @param xLength optional length to impose on vectorU.\n   * @param yLength optional length to impose on vectorV.\n   * @param result optional preexisting result\n   */\n  public static createFromTransformColumnsXYAndLengths(\n    transform: Transform, xLength: number | undefined, yLength: number | undefined, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    if (result) {\n      result.origin.setFrom(transform.getOrigin());\n      transform.matrix.columnX(result.vectorU);\n      transform.matrix.columnY(result.vectorV);\n    } else {\n      result = new Plane3dByOriginAndVectors(\n        transform.getOrigin(),\n        transform.matrix.columnX(),\n        transform.matrix.columnY());\n    }\n    if (xLength !== undefined)\n      result.vectorU.scaleToLength(xLength, result.vectorU);\n    if (yLength !== undefined)\n      result.vectorV.scaleToLength(yLength, result.vectorV);\n    return result;\n  }\n  /** Capture origin and directions in a new plane. */\n  public static createCapture(\n    origin: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    if (!result)\n      return new Plane3dByOriginAndVectors(origin, vectorU, vectorV);\n    result.origin = origin;\n    result.vectorU = vectorU;\n    result.vectorV = vectorV;\n    return result;\n  }\n\n  /** Set all origin and both vectors from direct numeric parameters */\n  public setOriginAndVectorsXYZ(\n    x0: number, y0: number, z0: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number,\n  ): Plane3dByOriginAndVectors {\n    this.origin.set(x0, y0, z0);\n    this.vectorU.set(ux, uy, uz);\n    this.vectorV.set(vx, vy, vz);\n    return this;\n  }\n  /**\n   * Set all origin and both vectors from coordinates in given origin and vectors.\n   * * Note that coordinates are copied out of the parameters -- the given parameters are NOT retained by reference.\n   */\n  public setOriginAndVectors(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d): Plane3dByOriginAndVectors {\n    this.origin.setFrom(origin);\n    this.vectorU.setFrom(vectorU);\n    this.vectorV.setFrom(vectorV);\n    return this;\n  }\n  /** Create a new plane from direct numeric parameters */\n  public static createOriginAndVectorsXYZ(\n    x0: number, y0: number, z0: number,\n    ux: number, uy: number, uz: number,\n    vx: number, vy: number, vz: number,\n    result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    if (result)\n      return result.setOriginAndVectorsXYZ(x0, y0, z0, ux, uy, uz, vx, vy, vz);\n    return new Plane3dByOriginAndVectors(\n      Point3d.create(x0, y0, z0), Vector3d.create(ux, uy, uz), Vector3d.create(vx, vy, vz),\n    );\n  }\n  /**\n   * Define a plane by three points in the plane.\n   * @param origin origin for the parameterization.\n   * @param targetU target point for the vectorU starting at the origin.\n   * @param targetV target point for the vectorV originating at the origin.\n   * @param result optional result.\n   */\n  public static createOriginAndTargets(\n    origin: Point3d, targetU: Point3d, targetV: Point3d, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(\n      origin.x, origin.y, origin.z,\n      targetU.x - origin.x, targetU.y - origin.y, targetU.z - origin.z,\n      targetV.x - origin.x, targetV.y - origin.y, targetV.z - origin.z,\n      result,\n    );\n  }\n  /** Create a plane with origin at 000, unit vectorU in x direction, and unit vectorV in the y direction. */\n  public static createXYPlane(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors {\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(0, 0, 0, 1, 0, 0, 0, 1, 0, result);\n  }\n  /**\n   * Create a plane from data presented as Float64Arrays.\n   * @param origin x,y,z of origin.\n   * @param vectorU x,y,z of vectorU\n   * @param vectorV x,y,z of vectorV\n   */\n  public static createOriginAndVectorsArrays(\n    origin: Float64Array, vectorU: Float64Array, vectorV: Float64Array, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    return Plane3dByOriginAndVectors.createOriginAndVectorsXYZ(\n      origin[0], origin[1], origin[2],\n      vectorU[0], vectorU[1], vectorU[2],\n      vectorV[0], vectorV[1], vectorV[2],\n      result,\n    );\n  }\n  /**\n   * Create a plane from data presented as Float64Array with weights\n   * @param origin x,y,z,w of origin.\n   * @param vectorU x,y,z,w of vectorU\n   * @param vectorV x,y,z,w of vectorV\n   */\n  public static createOriginAndVectorsWeightedArrays(\n    originW: Float64Array, vectorUw: Float64Array, vectorVw: Float64Array, result?: Plane3dByOriginAndVectors,\n  ): Plane3dByOriginAndVectors {\n    const w = originW[3];\n    result = Plane3dByOriginAndVectors.createXYPlane(result);\n    if (Geometry.isSmallMetricDistance(w))\n      return result;\n    const dw = 1.0 / w;\n    const au = vectorUw[3] * dw * dw;\n    const av = vectorVw[3] * dw * dw;\n    // for homogeneous function X, with w its weight:\n    // (X/w) is the cartesian point.\n    // (X/w)' = (X' w - X w')/(w*w)\n    //        = X'/w  - (X/w)(w'/w)\n    //        = X'/w  - X w'/w^2)\n    // The w parts of the formal xyzw sums are identically 0.\n    // Here the X' and its w' are taken from each vectorUw and vectorVw\n    result.origin.set(originW[0] * dw, originW[1] * dw, originW[2] * dw);\n    Vector3d.createAdd2ScaledXYZ(\n      vectorUw[0], vectorUw[1], vectorUw[2], dw, originW[0], originW[1], originW[2], -au, result.vectorU,\n    );\n    Vector3d.createAdd2ScaledXYZ(\n      vectorVw[0], vectorVw[1], vectorVw[2], dw, originW[0], originW[1], originW[2], -av, result.vectorV,\n    );\n    return result;\n  }\n  /**\n   * Evaluate a point a grid coordinates on the plane.\n   * * The computed point is `origin + vectorU * u + vectorV * v`\n   * @param u coordinate along vectorU\n   * @param v coordinate along vectorV\n   * @param result optional result destination.\n   * @returns Return the computed coordinate.\n   */\n  public fractionToPoint(u: number, v: number, result?: Point3d): Point3d {\n    return this.origin.plus2Scaled(this.vectorU, u, this.vectorV, v, result);\n  }\n  /** Return the vector from the plane origin to parametric coordinate (u.v) */\n  public fractionToVector(u: number, v: number, result?: Vector3d): Vector3d {\n    return Vector3d.createAdd2Scaled(this.vectorU, u, this.vectorV, v, result);\n  }\n  /** Set coordinates from a json object such as `{origin: [1,2,3], vectorU:[4,5,6], vectorV[3,2,1]}` */\n  public setFromJSON(json?: any) {\n    if (!json || !json.origin || !json.vectorV) {\n      this.origin.set(0, 0, 0);\n      this.vectorU.set(1, 0, 0);\n      this.vectorV.set(0, 1, 0);\n    } else {\n      this.origin.setFromJSON(json.origin);\n      this.vectorU.setFromJSON(json.vectorU);\n      this.vectorV.setFromJSON(json.vectorV);\n    }\n  }\n  /**\n   * Convert an Angle to a JSON object.\n   * @return {*} [origin,normal]\n   */\n  public toJSON(): any {\n    return {\n      origin: this.origin.toJSON(),\n      vectorU: this.vectorU.toJSON(),\n      vectorV: this.vectorV.toJSON(),\n    };\n  }\n  /** Create a new plane.   See `setFromJSON` for layout example. */\n  public static fromJSON(json?: any): Plane3dByOriginAndVectors {\n    const result = Plane3dByOriginAndVectors.createXYPlane();\n    result.setFromJSON(json);\n    return result;\n  }\n  /** Test origin and vectors for isAlmostEqual with `other` */\n  public isAlmostEqual(other: Plane3dByOriginAndVectors): boolean {\n    return this.origin.isAlmostEqual(other.origin)\n      && this.vectorU.isAlmostEqual(other.vectorU)\n      && this.vectorV.isAlmostEqual(other.vectorV);\n  }\n  /**\n   * Normalize both `vectorU` and `vectorV` in place. This does NOT make them perpendicular.\n   * * Return true if both succeeded.\n   */\n  public normalizeInPlace(): boolean {\n    const okU = this.vectorU.normalizeInPlace();\n    const okV = this.vectorV.normalizeInPlace();\n    return okU && okV;\n  }\n  /** Return (if possible) a unit normal to the plane */\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\n    return this.vectorU.unitCrossProduct(this.vectorV, result);\n  }\n  /**\n   * Return (if possible) a unit normal to the plane.\n   * * This method is the same as getUnitNormal, which was created later as part of the abstract base class Plane3d.\n   */\n  public unitNormal(result?: Vector3d): Vector3d | undefined {\n    return this.vectorU.unitCrossProduct(this.vectorV, result);\n  }\n  /**\n   * Return some point on the plane.\n   */\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\n    // This function returns the plane origin. In general, a point x is on the plane if\n    // and only if x = o + a*u + b*v, where a and b are scalars.\n    return this.origin.clone(result);\n  }\n  private static _workVector: Vector3d;\n  /** Return (if possible) a ray with origin at plane origin, direction as unit normal to the plane */\n  public unitNormalRay(result?: Ray3d): Ray3d | undefined {\n    if (!Plane3dByOriginAndVectors._workVector)\n      Plane3dByOriginAndVectors._workVector = Vector3d.create();\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV, Plane3dByOriginAndVectors._workVector);\n    if (unitNormal === undefined)\n      return undefined;\n    return Ray3d.create(this.origin, unitNormal, result);\n  }\n  /**\n   * Create a rigid frame (i.e. frenet frame) with\n   * * origin at the plane origin\n   * * x axis along the (normalized) vectorU\n   * * y axis normalized vectorU to vectorV plane, and perpendicular to x axis\n   * * z axis perpendicular to both.\n   * @param result optional result\n   */\n  public toRigidFrame(result?: Transform): Transform | undefined {\n    return Transform.createRigidFromOriginAndColumns(this.origin, this.vectorU, this.vectorV, AxisOrder.XYZ, result);\n  }\n  /** Apply the transform to the origin and vectors in place */\n  public transformInPlace(transform: Transform) {\n    transform.multiplyPoint3d(this.origin, this.origin);\n    transform.multiplyVector(this.vectorU, this.vectorU);\n    transform.multiplyVector(this.vectorV, this.vectorV);\n  }\n  /**\n   * Return x component of the (normalized!) {vectorU CROSS vectorV}.\n   * Return 0 if the cross product is zero.\n   */\n  public normalX(): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    return unitNormal !== undefined ? unitNormal.x : 0.0;\n  }\n  /**\n   * Return y component of the (normalized!) {vectorU CROSS vectorV}.\n   * Return 0 if the cross product is zero.\n   */\n  public normalY(): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    return unitNormal !== undefined ? unitNormal.y : 0.0;\n  }\n  /**\n   * Return z component of the (normalized!) {vectorU CROSS vectorV}.\n   * Return 0 if the cross product is zero.\n   */\n  public normalZ(): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    return unitNormal !== undefined ? unitNormal.z : 0.0;\n  }\n  /** Return signed cartesian altitude perpendicular to the plane. This uses the normalized cross product as normal. */\n  public altitude(xyz: XYAndZ): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    if (unitNormal === undefined)\n      return 0.0;\n    return Geometry.dotProductXYZXYZ(\n      (xyz.x - this.origin.x), (xyz.y - this.origin.y), (xyz.z - this.origin.z),\n      unitNormal.x, unitNormal.y, unitNormal.z);\n  }\n  /** Return signed cartesian altitude perpendicular to the plane. This uses the normalized cross product as normal. */\n  public altitudeXYZ(x: number, y: number, z: number): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    if (unitNormal === undefined)\n      return 0.0;\n    return Geometry.dotProductXYZXYZ(\n      (x - this.origin.x), (y - this.origin.y), (z - this.origin.z),\n      unitNormal.x, unitNormal.y, unitNormal.z);\n  }\n  /** Return signed projection of the input vector to the plane normal. This uses the normalized cross product as normal. */\n  public velocity(xyzVector: XYAndZ): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    if (unitNormal === undefined)\n      return 0.0;\n    return Geometry.dotProductXYZXYZ(\n      xyzVector.x, xyzVector.y, xyzVector.z,\n      unitNormal.x, unitNormal.y, unitNormal.z);\n  }\n  /** Return signed projection of the input vector to the plane normal. This uses the normalized cross product as normal. */\n  public velocityXYZ(x: number, y: number, z: number): number {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    if (unitNormal === undefined)\n      return 0.0;\n    return Geometry.dotProductXYZXYZ(\n      x, y, z,\n      unitNormal.x, unitNormal.y, unitNormal.z);\n  }\n  /**\n   * Return triple product of homogeneous difference {(xyzw - w * origin)} with vectorU and vectorV.\n   * * In the usual manner of homogeneous calculations, this is proportional to true cartesian distance from the\n   * plane but is not a physical distance.\n   */\n  public weightedAltitude(xyzw: Point4d) {\n    const w = xyzw.w;\n    return Geometry.tripleProduct(\n      (xyzw.x - this.origin.x * w), (xyzw.y - this.origin.y * w), (xyzw.z - this.origin.z * w),\n      this.vectorU.x, this.vectorU.y, this.vectorU.z,\n      this.vectorV.x, this.vectorV.y, this.vectorV.z);\n  }\n  /**\n   * Return the projection of spacePoint onto the plane.\n   * If the plane is degenerate to a ray, project to the ray.\n   * If the plane is degenerate to its origin, return the point\n   */\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\n    const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);\n    if (unitNormal !== undefined) {\n      const w = unitNormal.dotProductStartEnd(this.origin, spacePoint);\n      return spacePoint.plusScaled(unitNormal, -w, result);\n    }\n    // uh oh.   vectorU and vectorV are colinear or zero.\n    // project to ray defined by the longer one, or just to origin.\n    const dotUU = this.vectorU.magnitudeSquared();\n    const dotVV = this.vectorV.magnitudeSquared();\n    if (dotUU >= dotVV) {\n      const dotUW = this.vectorU.dotProductStartEnd(this.origin, spacePoint);\n      const f = Geometry.conditionalDivideCoordinate(dotUW, dotUU, 0.0);\n      if (f !== undefined)\n        return spacePoint.plusScaled(this.vectorU, f, result);\n    } else {\n      const dotVW = this.vectorV.dotProductStartEnd(this.origin, spacePoint);\n      const f = Geometry.conditionalDivideCoordinate(dotVW, dotVV, 0.0);\n      if (f !== undefined)\n        return spacePoint.plusScaled(this.vectorV, f, result);\n    }\n    return this.origin.clone(result);\n  }\n}\n"]}

package/lib/esm/geometry3d/Point2dArrayCarrier.js.map

@@ -1 +1 @@
-{"version":3,"file":"Point2dArrayCarrier.js","sourceRoot":"","sources":["../../../src/geometry3d/Point2dArrayCarrier.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,mEAAmE;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAG1D;;;;;;EAME;AACF,MAAM,OAAO,mBAAoB,SAAQ,mBAAmB;IAG1D,wCAAwC;IACxC,YAAmB,IAAe;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,8BAA8B;IACvB,YAAY,CAAC,KAAa;QAC/B,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAChD,CAAC;IACD;;;;;;OAMG;IACa,6BAA6B,CAAC,KAAa,EAAE,MAAgB;QAC3E,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;SACnD;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;OAKG;IACa,+BAA+B,CAAC,KAAa,EAAE,MAAiB;QAC9E,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;SACpD;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;;OAMG;IACa,gBAAgB,CAAC,MAAc,EAAE,MAAc,EAAE,MAAiB;QAChF,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YACxD,OAAO,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;;OAMG;IACa,gBAAgB,CAAC,MAAa,EAAE,MAAc,EAAE,MAAiB;QAC/E,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAC3B,OAAO,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACa,2BAA2B,CAAC,MAAa,EAAE,MAAc,EAAE,MAAc;QACvF,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YACxD,OAAO,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;;;OAOG;IACa,2BAA2B,CAAC,WAAmB,EAAE,MAAc,EAAE,MAAc;QAC7F,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAC1F,OAAO,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,8DAA8D;IAC9D,IAAoB,MAAM;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACa,yBAAyB,CAAC,UAAkB;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACa,yBAAyB,CAAC,UAAkB;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,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/** @packageDocumentation\r\n * @module CartesianGeometry\r\n */\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\n\r\nimport { IndexedXYCollection } from \"./IndexedXYCollection\";\r\nimport { Point2d, Vector2d, XY } from \"./Point2dVector2d\";\r\nimport { XAndY } from \"./XYZProps\";\r\n\r\n/**\r\n * Helper object to access members of a Point2d[] in geometric calculations.\r\n * * The collection holds only a reference to the actual array.\r\n * * The actual array may be replaced by the user as needed.\r\n * * When replaced, there is no cached data to be updated.\r\n * @public\r\n*/\r\nexport class Point2dArrayCarrier extends IndexedXYCollection {\r\n  /** reference to array being queried. */\r\n  public data: Point2d[];\r\n  /** CAPTURE caller supplied array ... */\r\n  public constructor(data: Point2d[]) {\r\n    super();\r\n    this.data = data;\r\n  }\r\n  /** test if index is valid  */\r\n  public isValidIndex(index: number): boolean {\r\n    return index >= 0 && index < this.data.length;\r\n  }\r\n  /**\r\n   * Access by index, returning strongly typed Point2d\r\n   * * This returns the xy value but NOT reference to the point in the \"carried\" array.\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public override getPoint2dAtCheckedPointIndex(index: number, result?: Point2d): Point2d | undefined {\r\n    if (this.isValidIndex(index)) {\r\n      const source = this.data[index];\r\n      return Point2d.create(source.x, source.y, result);\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Access by index, returning strongly typed Vector2d\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public override getVector2dAtCheckedVectorIndex(index: number, result?: Vector2d): Vector2d | undefined {\r\n    if (this.isValidIndex(index)) {\r\n      const source = this.data[index];\r\n      return Vector2d.create(source.x, source.y, result);\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return a vector from the point at indexA to the point at indexB\r\n   * @param indexA index of point within the array\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public override vectorIndexIndex(indexA: number, indexB: number, result?: Vector2d): Vector2d | undefined {\r\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return Vector2d.createStartEnd(this.data[indexA], this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return a vector from given origin to point at indexB\r\n   * @param origin origin for vector\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if index is out of bounds\r\n   */\r\n  public override vectorXAndYIndex(origin: XAndY, indexB: number, result?: Vector2d): Vector2d | undefined {\r\n    if (this.isValidIndex(indexB))\r\n      return Vector2d.createStartEnd(origin, this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Return the cross product of vectors from origin to points at indexA and indexB\r\n   * @param origin origin for vector\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public override crossProductXAndYIndexIndex(origin: XAndY, indexA: number, indexB: number): number | undefined {\r\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return XY.crossProductToPoints(origin, this.data[indexA], this.data[indexB]);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return the cross product of vectors from point at originIndex to points at indexA and indexB\r\n   * @param originIndex index of origin\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns return true if indexA, indexB both valid\r\n   */\r\n  public override crossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number): number | undefined {\r\n    if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return XY.crossProductToPoints(this.data[originIndex], this.data[indexA], this.data[indexB]);\r\n    return undefined;\r\n  }\r\n  /** Read-only property for number of XYZ in the collection. */\r\n  public override get length(): number {\r\n    return this.data.length;\r\n  }\r\n\r\n  /**\r\n   * Get x coordinate by point index, with no index checking\r\n   * @param pointIndex index to access\r\n   */\r\n  public override getXAtUncheckedPointIndex(pointIndex: number): number {\r\n    return this.data[pointIndex].x;\r\n  }\r\n\r\n  /**\r\n   * Get y coordinate by point index, with no index checking\r\n   * @param pointIndex index to access\r\n   */\r\n  public override getYAtUncheckedPointIndex(pointIndex: number): number {\r\n    return this.data[pointIndex].y;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Point2dArrayCarrier.js","sourceRoot":"","sources":["../../../src/geometry3d/Point2dArrayCarrier.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module CartesianGeometry\n */\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\n\nimport { IndexedXYCollection } from \"./IndexedXYCollection\";\nimport { Point2d, Vector2d, XY } from \"./Point2dVector2d\";\nimport { XAndY } from \"./XYZProps\";\n\n/**\n * Helper object to access members of a Point2d[] in geometric calculations.\n * * The collection holds only a reference to the actual array.\n * * The actual array may be replaced by the user as needed.\n * * When replaced, there is no cached data to be updated.\n * @public\n*/\nexport class Point2dArrayCarrier extends IndexedXYCollection {\n  /** reference to array being queried. */\n  public data: Point2d[];\n  /** CAPTURE caller supplied array ... */\n  public constructor(data: Point2d[]) {\n    super();\n    this.data = data;\n  }\n  /** test if index is valid  */\n  public isValidIndex(index: number): boolean {\n    return index >= 0 && index < this.data.length;\n  }\n  /**\n   * Access by index, returning strongly typed Point2d\n   * * This returns the xy value but NOT reference to the point in the \"carried\" array.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public override getPoint2dAtCheckedPointIndex(index: number, result?: Point2d): Point2d | undefined {\n    if (this.isValidIndex(index)) {\n      const source = this.data[index];\n      return Point2d.create(source.x, source.y, result);\n    }\n    return undefined;\n  }\n  /**\n   * Access by index, returning strongly typed Vector2d\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public override getVector2dAtCheckedVectorIndex(index: number, result?: Vector2d): Vector2d | undefined {\n    if (this.isValidIndex(index)) {\n      const source = this.data[index];\n      return Vector2d.create(source.x, source.y, result);\n    }\n    return undefined;\n  }\n  /**\n   * Return a vector from the point at indexA to the point at indexB\n   * @param indexA index of point within the array\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public override vectorIndexIndex(indexA: number, indexB: number, result?: Vector2d): Vector2d | undefined {\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\n      return Vector2d.createStartEnd(this.data[indexA], this.data[indexB], result);\n    return undefined;\n  }\n  /**\n   * Return a vector from given origin to point at indexB\n   * @param origin origin for vector\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if index is out of bounds\n   */\n  public override vectorXAndYIndex(origin: XAndY, indexB: number, result?: Vector2d): Vector2d | undefined {\n    if (this.isValidIndex(indexB))\n      return Vector2d.createStartEnd(origin, this.data[indexB], result);\n    return undefined;\n  }\n\n  /**\n   * Return the cross product of vectors from origin to points at indexA and indexB\n   * @param origin origin for vector\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public override crossProductXAndYIndexIndex(origin: XAndY, indexA: number, indexB: number): number | undefined {\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\n      return XY.crossProductToPoints(origin, this.data[indexA], this.data[indexB]);\n    return undefined;\n  }\n  /**\n   * Return the cross product of vectors from point at originIndex to points at indexA and indexB\n   * @param originIndex index of origin\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns return true if indexA, indexB both valid\n   */\n  public override crossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number): number | undefined {\n    if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))\n      return XY.crossProductToPoints(this.data[originIndex], this.data[indexA], this.data[indexB]);\n    return undefined;\n  }\n  /** Read-only property for number of XYZ in the collection. */\n  public override get length(): number {\n    return this.data.length;\n  }\n\n  /**\n   * Get x coordinate by point index, with no index checking\n   * @param pointIndex index to access\n   */\n  public override getXAtUncheckedPointIndex(pointIndex: number): number {\n    return this.data[pointIndex].x;\n  }\n\n  /**\n   * Get y coordinate by point index, with no index checking\n   * @param pointIndex index to access\n   */\n  public override getYAtUncheckedPointIndex(pointIndex: number): number {\n    return this.data[pointIndex].y;\n  }\n}\n"]}

package/lib/esm/geometry3d/Point2dVector2d.d.ts

@@ -97,13 +97,13 @@ export declare class Point2d extends XY implements BeJSONFunctions {
     /** Create a Point2d with both coordinates zero. */
     static createZero(result?: Point2d): Point2d;
     /**
-     * Starting at this point, move along vector by tangentFraction of the vector length, and then
-     * to the left by leftFraction of the perpendicular vector length.
-     * @param tangentFraction distance to move along the vector, as a fraction of vector
-     * @param leftFraction distance to move perpendicular to the vector, as a fraction of the rotated vector
+     * Starting at this point, move along `vector` by `tangentFraction` of its length, and then
+     * by `leftFraction` of its length along the left perpendicular.
+     * @param tangentFraction distance to move along `vector`, as a fraction of its length
+     * @param leftFraction distance to move perpendicular to `vector`, as a fraction of its length
      * @param vector the other vector
      */
-    addForwardLeft(tangentFraction: number, leftFraction: number, vector: Vector2d): Point2d;
+    addForwardLeft(tangentFraction: number, leftFraction: number, vector: Vector2d, result?: Point2d): Point2d;
     /**
      * Interpolate at tangentFraction between this instance and point, and then Move by leftFraction
      * along the xy perpendicular of the vector between the points.
@@ -197,11 +197,10 @@ export declare class Vector2d extends XY implements BeJSONFunctions {
     /** Return a unit vector in direction of this instance (undefined if this instance has near zero length) */
     normalize(result?: Vector2d): Vector2d | undefined;
     /**
-     * Return fractional projection of target vector onto this
-     * * It's returning the signed projection magnitude divided by the target magnitude. In other words,
-     * it's returning the length of the projection as a fraction of the target magnitude.
+     * Return fractional length of the projection of the instance onto the target vector.
      * @param target the target vector
-     * @param defaultFraction the returned value in case magnitude square of target vector is very small
+     * @param defaultFraction the returned value in case the magnitude of `target` is too small
+     * @returns the signed length of the projection divided by the length of `target`
      */
     fractionOfProjectionToVector(target: Vector2d, defaultFraction?: number): number;
     /** Return a new vector with components negated from this instance. */

package/lib/esm/geometry3d/Point2dVector2d.d.ts.map

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

package/lib/esm/geometry3d/Point2dVector2d.js

@@ -202,16 +202,16 @@ export class Point2d extends XY {
         return Point2d.create(0, 0, result);
     }
     /**
-     * Starting at this point, move along vector by tangentFraction of the vector length, and then
-     * to the left by leftFraction of the perpendicular vector length.
-     * @param tangentFraction distance to move along the vector, as a fraction of vector
-     * @param leftFraction distance to move perpendicular to the vector, as a fraction of the rotated vector
+     * Starting at this point, move along `vector` by `tangentFraction` of its length, and then
+     * by `leftFraction` of its length along the left perpendicular.
+     * @param tangentFraction distance to move along `vector`, as a fraction of its length
+     * @param leftFraction distance to move perpendicular to `vector`, as a fraction of its length
      * @param vector the other vector
      */
-    addForwardLeft(tangentFraction, leftFraction, vector) {
+    addForwardLeft(tangentFraction, leftFraction, vector, result) {
         const dx = vector.x;
         const dy = vector.y;
-        return Point2d.create(this.x + tangentFraction * dx - leftFraction * dy, this.y + tangentFraction * dy + leftFraction * dx);
+        return Point2d.create(this.x + tangentFraction * dx - leftFraction * dy, this.y + tangentFraction * dy + leftFraction * dx, result);
     }
     /**
      * Interpolate at tangentFraction between this instance and point, and then Move by leftFraction
@@ -395,11 +395,10 @@ export class Vector2d extends XY {
         return this.safeDivideOrNull(mag, result);
     }
     /**
-     * Return fractional projection of target vector onto this
-     * * It's returning the signed projection magnitude divided by the target magnitude. In other words,
-     * it's returning the length of the projection as a fraction of the target magnitude.
+     * Return fractional length of the projection of the instance onto the target vector.
      * @param target the target vector
-     * @param defaultFraction the returned value in case magnitude square of target vector is very small
+     * @param defaultFraction the returned value in case the magnitude of `target` is too small
+     * @returns the signed length of the projection divided by the length of `target`
      */
     fractionOfProjectionToVector(target, defaultFraction) {
         /*