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

package/lib/esm/geometry3d/Plane3dByOriginAndUnitNormal.js

@@ -54,7 +54,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
             return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 1, 0);
         return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 1, 0);
     }
-    /** Create a new Plane3dByOriginAndUnitNormal with given origin and normal.
+    /**
+     * Create a new Plane3dByOriginAndUnitNormal with given origin and normal.
      * * The inputs are NOT captured.
      * * Returns undefined if `normal.normalize()` returns undefined.
      */
@@ -70,7 +71,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
             return undefined;
         return new Plane3dByOriginAndUnitNormal(origin.clone(), normalized);
     }
-    /** Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.
+    /**
+     * Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.
      * * The inputs are NOT captured.
      * * Returns undefined if `source.getUnitNormal()` returns undefined.
      */
@@ -89,7 +91,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         const origin = source.getAnyPointOnPlane();
         return new Plane3dByOriginAndUnitNormal(origin, normal);
     }
-    /** create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.
+    /**
+     * Create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.
      * * Returns undefined if the normal vector is all zeros.
      * * If unable to normalize return undefined. (And if result is given it is left unchanged)
      */
@@ -104,7 +107,9 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         }
         return new Plane3dByOriginAndUnitNormal(Point3d.create(ax, ay, az), Vector3d.create(ux / magU, uy / magU, uz / magU));
     }
-    /** create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line defined by xy parts of origin to target.
+    /**
+     * Create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line
+     * defined by xy parts of origin to target.
      * * origin and normal both have z = 0.
      * * The inputs are NOT captured.
      * * Returns undefined if the normal vector is all zeros.
@@ -114,7 +119,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         const uy = target.y - origin.y;
         return this.createXYZUVW(origin.x, origin.y, 0.0, uy, -ux, 0.0, result);
     }
-    /** create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.
+    /**
+     * Create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.
      * * Returns undefined if the normal vector is all zeros.
      */
     static createXYAngle(x, y, normalAngleFromX, result) {
@@ -125,7 +131,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         }
         return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, 0), Vector3d.create(normalAngleFromX.cos(), normalAngleFromX.sin()));
     }
-    /** Create a plane defined by two points and an in-plane vector.
+    /**
+     * Create a plane defined by two points and an in-plane vector.
      * @param pointA any point in the plane
      * @param pointB any other point in the plane
      * @param vector any vector in the plane but not parallel to the vector from pointA to pointB
@@ -136,7 +143,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
             return new Plane3dByOriginAndUnitNormal(pointA, cross);
         return undefined;
     }
-    /** Create a plane defined by three points.
+    /**
+     * Create a plane defined by three points.
      * @param pointA any point in the plane.  This will be the origin.
      * @param pointB any other point in the plane
      * @param pointC any third point in the plane but not on the line of pointA and pointB
@@ -147,7 +155,8 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
             return new Plane3dByOriginAndUnitNormal(pointA, cross);
         return undefined;
     }
-    /** Create a plane defined by a point and two vectors in the plane
+    /**
+     * Create a plane defined by a point and two vectors in the plane
      * @param pointA any point in the plane
      * @param vectorB any vector in the plane
      * @param vectorC any vector in the plane but not parallel to vectorB
@@ -158,7 +167,7 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
             return new Plane3dByOriginAndUnitNormal(pointA, cross);
         return undefined;
     }
-    /** test for (toleranced) equality with `other` */
+    /** Test for (toleranced) equality with `other` */
     isAlmostEqual(other) {
         return this._origin.isAlmostEqual(other._origin) && this._normal.isAlmostEqual(other._normal);
     }
@@ -177,8 +186,11 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
      * Convert to a JSON object.
      * @return {*} [origin,normal]
      */
-    toJSON() { return { origin: this._origin.toJSON(), normal: this._normal.toJSON() }; }
-    /**  create a new Plane3dByOriginAndUnitNormal from json fragment.
+    toJSON() {
+        return { origin: this._origin.toJSON(), normal: this._normal.toJSON() };
+    }
+    /**
+     * Create a new Plane3dByOriginAndUnitNormal from json fragment.
      * * See `Plane3dByOriginAndUnitNormal.setFromJSON`
      */
     static fromJSON(json) {
@@ -187,10 +199,15 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         return result;
     }
     /** Return a reference to the origin. */
-    getOriginRef() { return this._origin; }
+    getOriginRef() {
+        return this._origin;
+    }
     /** Return a reference to the unit normal. */
-    getNormalRef() { return this._normal; }
-    /** Return coordinate axes (as a transform) with
+    getNormalRef() {
+        return this._normal;
+    }
+    /**
+     * Return coordinate axes (as a transform) with
      * * origin at plane origin
      * * z axis in direction of plane normal.
      * * x,y axes in plane.
@@ -199,8 +216,7 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         const axes = Matrix3d.createRigidHeadsUp(this._normal, AxisOrder.ZXY);
         return Transform.createRefs(this._origin.clone(), axes);
     }
-    /** Return a (singular) transform which projects points to this plane.
-     */
+    /** Return a (singular) transform which projects points to this plane. */
     getProjectionToPlane() {
         const axes = Matrix3d.createIdentity();
         axes.addScaledOuterProductInPlace(this._normal, this._normal, -1.0);
@@ -212,7 +228,7 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         this._origin.setFrom(origin);
         this._normal.setFrom(normal);
     }
-    /** return a deep clone (point and normal cloned) */
+    /** Return a deep clone (point and normal cloned) */
     clone(result) {
         if (result) {
             result.set(this._origin, this._normal);
@@ -242,51 +258,56 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
         this.set(source._origin, source._normal);
     }
     /** Return the altitude of spacePoint above or below the plane.  (Below is negative) */
-    altitude(spacePoint) { return this._normal.dotProductStartEnd(this._origin, spacePoint); }
+    altitude(spacePoint) {
+        return this._normal.dotProductStartEnd(this._origin, spacePoint);
+    }
     /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */
     altitudeXY(x, y) {
         return (x - this._origin.x) * this._normal.x + (y - this._origin.y) * this._normal.y;
     }
-    /**
-     * Return the x component of the normal used to evaluate altitude.
-     */
-    normalX() { return this._normal.x; }
-    /**
-     * Return the x component of the normal used to evaluate altitude.
-     */
-    normalY() { return this._normal.y; }
-    /**
-     * Return the z component of the normal used to evaluate altitude.
-     */
-    normalZ() { return this._normal.z; }
-    /**
-     * Return (a clone of) the unit normal.
-     */
+    /** Return the x component of the normal used to evaluate altitude. */
+    normalX() {
+        return this._normal.x;
+    }
+    /** Return the x component of the normal used to evaluate altitude. */
+    normalY() {
+        return this._normal.y;
+    }
+    /** Return the z component of the normal used to evaluate altitude. */
+    normalZ() {
+        return this._normal.z;
+    }
+    /** Return (a clone of) the unit normal. */
     getUnitNormal(result) {
         return this._normal.clone(result);
     }
-    /**
-     * Return (a clone of) the origin.
-     */
+    /** Return (a clone of) the origin. */
     getAnyPointOnPlane(result) {
+        // This function returns the plane origin. In general, a point x is on the plane if and only if (x-o).n = 0.
         return this._origin.clone(result);
     }
     /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */
     weightedAltitude(spacePoint) {
         return this._normal.dotProductStart3dEnd4d(this._origin, spacePoint);
     }
-    /** return any point at specified (signed) altitude. */
+    /** Return any point at specified (signed) altitude. */
     altitudeToPoint(altitude, result) {
         return this._origin.plusScaled(this._normal, altitude, result);
     }
-    /** Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude
+    /**
+     * Return the dot product of spaceVector with the plane's unit normal. This tells the rate of change of altitude
      * for a point moving at speed one along the spaceVector.
      */
-    velocityXYZ(x, y, z) { return this._normal.dotProductXYZ(x, y, z); }
-    /** Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude
+    velocityXYZ(x, y, z) {
+        return this._normal.dotProductXYZ(x, y, z);
+    }
+    /**
+     * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude
      * for a point moving at speed one along the spaceVector.
      */
-    velocity(spaceVector) { return this._normal.dotProduct(spaceVector); }
+    velocity(spaceVector) {
+        return this._normal.dotProduct(spaceVector);
+    }
     /** Return the altitude of a point given as separate x,y,z components. */
     altitudeXYZ(x, y, z) {
         return this._normal.dotProductStartEndXYZ(this._origin, x, y, z);
@@ -299,9 +320,10 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
     projectPointToPlane(spacePoint, result) {
         return spacePoint.plusScaled(this._normal, -this._normal.dotProductStartEnd(this._origin, spacePoint), result);
     }
-    /** Returns true if spacePoint is within distance tolerance of the plane.
+    /**
+     * Returns true if spacePoint is within distance tolerance of the plane.
      * * This logic is identical to the [[Plane3d]] method but avoids a level of function call.
-    */
+     */
     isPointInPlane(spacePoint, tolerance = Geometry.smallMetricDistance) {
         const altitude = this._normal.dotProductStartEnd(this._origin, spacePoint);
         return Math.abs(altitude) <= tolerance;

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

@@ -1 +1 @@
-{"version":3,"file":"Plane3dByOriginAndUnitNormal.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndUnitNormal.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 CartesianGeometry\r\n */\r\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { Plane3d } from \"./Plane3d\";\r\nimport { Point4d } from \"../geometry4d/Point4d\";\r\nimport { Angle } from \"./Angle\";\r\nimport { Matrix3d } from \"./Matrix3d\";\r\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\r\nimport { Transform } from \"./Transform\";\r\nimport { XAndY } from \"./XYZProps\";\r\n\r\n/**\r\n * A plane defined by\r\n * * Any point on the plane.\r\n * * a unit normal.\r\n * @public\r\n */\r\nexport class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJSONFunctions {\r\n  private _origin: Point3d;\r\n  private _normal: Vector3d;\r\n  // constructor captures references !!!\r\n  private constructor(origin: Point3d, normal: Vector3d) {\r\n    super();\r\n    this._origin = origin;\r\n    this._normal = normal;\r\n  }\r\n  // This is private because it does not check validity of the unit vector.\r\n  private static _create(x: number, y: number, z: number, u: number, v: number, w: number) {\r\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, z), Vector3d.create(u, v, w));\r\n  }\r\n  /**\r\n   * Create a plane parallel to the XY plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createXYPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 0, 1);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 0, 1);\r\n  }\r\n  /**\r\n   * Create a plane parallel to the YZ plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createYZPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 1, 0, 0);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 1, 0, 0);\r\n  }\r\n  /**\r\n   * Create a plane parallel to the ZX plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createZXPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 1, 0);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 1, 0);\r\n  }\r\n  /** Create a new Plane3dByOriginAndUnitNormal with given origin and normal.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if `normal.normalize()` returns undefined.\r\n   */\r\n  public static create(origin: Point3d, normal: Vector3d, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined {\r\n    if (result) {\r\n      if (normal.normalize(result._normal) === undefined)\r\n        return undefined;\r\n      origin.clone(result._origin);\r\n      return result;\r\n    }\r\n    const normalized = normal.normalize();\r\n    if (normalized === undefined)\r\n      return undefined;\r\n    return new Plane3dByOriginAndUnitNormal(origin.clone(), normalized);\r\n  }\r\n  /** Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if `source.getUnitNormal()` returns undefined.\r\n   */\r\n  public static createFrom(source: Plane3d, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined {\r\n    if (source instanceof Plane3dByOriginAndUnitNormal)\r\n      return source.clone(result);\r\n    if (result) {\r\n      if (source.getUnitNormal(result._normal) === undefined)\r\n        return undefined;\r\n      source.getAnyPointOnPlane(result._origin);\r\n      return result;\r\n    }\r\n    const normal = source.getUnitNormal();\r\n    if (normal === undefined)\r\n      return undefined;\r\n    const origin = source.getAnyPointOnPlane();\r\n    return new Plane3dByOriginAndUnitNormal(origin, normal);\r\n  }\r\n\r\n  /** create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   * * If unable to normalize return undefined. (And if result is given it is left unchanged)\r\n   */\r\n  public static createXYZUVW(ax: number, ay: number, az: number, ux: number, uy: number, uz: number, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined {\r\n    const magU = Geometry.hypotenuseXYZ(ux, uy, uz);\r\n    if (magU < Geometry.smallMetricDistance)\r\n      return undefined;\r\n    if (result) {\r\n      result._origin.set(ax, ay, az);\r\n      result._normal.set(ux / magU, uy / magU, uz / magU);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(ax, ay, az), Vector3d.create(ux / magU, uy / magU, uz / magU));\r\n  }\r\n  /** create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line defined by xy parts of origin to target.\r\n   * * origin and normal both have z = 0.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   */\r\n  public static createOriginAndTargetXY(origin: XAndY, target: XAndY, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined {\r\n    const ux = target.x - origin.x;\r\n    const uy = target.y - origin.y;\r\n    return this.createXYZUVW(origin.x, origin.y, 0.0, uy, -ux, 0.0, result);\r\n  }\r\n\r\n  /** create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   */\r\n  public static createXYAngle(x: number, y: number, normalAngleFromX: Angle, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal {\r\n    if (result) {\r\n      result._origin.set(x, y, 0.0);\r\n      result._normal.set(normalAngleFromX.cos(), normalAngleFromX.sin(), 0.0);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, 0), Vector3d.create(normalAngleFromX.cos(), normalAngleFromX.sin()));\r\n  }\r\n\r\n  /** Create a plane defined by two points and an in-plane vector.\r\n   * @param pointA any point in the plane\r\n   * @param pointB any other point in the plane\r\n   * @param vector any vector in the plane but not parallel to the vector from pointA to pointB\r\n   */\r\n  public static createPointPointVectorInPlane(pointA: Point3d, pointB: Point3d, vector: Vector3d): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = vector.crossProductStartEnd(pointA, pointB);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n\r\n  /** Create a plane defined by three points.\r\n   * @param pointA any point in the plane.  This will be the origin.\r\n   * @param pointB any other point in the plane\r\n   * @param pointC any third point in the plane but not on the line of pointA and pointB\r\n   */\r\n  public static createOriginAndTargets(pointA: Point3d, pointB: Point3d, pointC: Point3d): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = pointA.crossProductToPoints(pointB, pointC);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n\r\n  /** Create a plane defined by a point and two vectors in the plane\r\n   * @param pointA any point in the plane\r\n   * @param vectorB any vector in the plane\r\n   * @param vectorC any vector in the plane but not parallel to vectorB\r\n   */\r\n  public static createOriginAndVectors(pointA: Point3d, vectorB: Vector3d, vectorC: Vector3d): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = vectorB.crossProduct(vectorC);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n\r\n  /** test for (toleranced) equality with `other` */\r\n  public isAlmostEqual(other: Plane3dByOriginAndUnitNormal): boolean {\r\n    return this._origin.isAlmostEqual(other._origin) && this._normal.isAlmostEqual(other._normal);\r\n  }\r\n  /** Parse a json fragment `{origin: [x,y,z], normal: [ux,uy,uz]}`  */\r\n  public setFromJSON(json?: any) {\r\n    if (!json) {\r\n      this._origin.set(0, 0, 0);\r\n      this._normal.set(0, 0, 1);\r\n    } else {\r\n      this._origin.setFromJSON(json.origin);\r\n      this._normal.setFromJSON(json.normal);\r\n    }\r\n  }\r\n  /**\r\n   * Convert to a JSON object.\r\n   * @return {*} [origin,normal]\r\n   */\r\n  public toJSON(): any { return { origin: this._origin.toJSON(), normal: this._normal.toJSON() }; }\r\n  /**  create a new Plane3dByOriginAndUnitNormal from json fragment.\r\n   * * See `Plane3dByOriginAndUnitNormal.setFromJSON`\r\n   */\r\n  public static fromJSON(json?: any): Plane3dByOriginAndUnitNormal {\r\n    const result = Plane3dByOriginAndUnitNormal.createXYPlane();\r\n    result.setFromJSON(json);\r\n    return result;\r\n  }\r\n  /** Return a reference to the origin. */\r\n  public getOriginRef(): Point3d { return this._origin; }\r\n  /** Return a reference to the unit normal. */\r\n  public getNormalRef(): Vector3d { return this._normal; }\r\n\r\n  /** Return coordinate axes (as a transform) with\r\n   * * origin at plane origin\r\n   * * z axis in direction of plane normal.\r\n   * * x,y axes in plane.\r\n   */\r\n  public getLocalToWorld(): Transform {\r\n    const axes = Matrix3d.createRigidHeadsUp(this._normal, AxisOrder.ZXY);\r\n    return Transform.createRefs(this._origin.clone(), axes);\r\n  }\r\n  /** Return a (singular) transform which projects points to this plane.\r\n   */\r\n  public getProjectionToPlane(): Transform {\r\n    const axes = Matrix3d.createIdentity();\r\n    axes.addScaledOuterProductInPlace(this._normal, this._normal, -1.0);\r\n    axes.markSingular();\r\n    return Transform.createFixedPointAndMatrix(this._origin, axes);\r\n  }\r\n\r\n  /** Copy coordinates from the given origin and normal. */\r\n  public set(origin: Point3d, normal: Vector3d): void {\r\n    this._origin.setFrom(origin);\r\n    this._normal.setFrom(normal);\r\n  }\r\n  /** return a deep clone (point and normal cloned) */\r\n  public clone(result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal {\r\n    if (result) {\r\n      result.set(this._origin, this._normal);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(this._origin.clone(), this._normal.clone());\r\n  }\r\n  /** Create a clone and return the transform of the clone. */\r\n  public cloneTransformed(transform: Transform, inverse: boolean = false): Plane3dByOriginAndUnitNormal | undefined {\r\n    const result = this.clone();\r\n    if (inverse) {\r\n      transform.multiplyInversePoint3d(result._origin, result._origin);\r\n      if (transform.matrix.multiplyTransposeVector(result._normal, result._normal) !== undefined\r\n        && result._normal.normalizeInPlace())\r\n        return result;\r\n    } else {\r\n      transform.multiplyPoint3d(result._origin, result._origin);\r\n      if (transform.matrix.multiplyInverseTranspose(result._normal, result._normal) !== undefined\r\n        && result._normal.normalizeInPlace())\r\n        return result;\r\n    }\r\n    return undefined;\r\n  }\r\n  /** Copy data from the given plane. */\r\n  public setFrom(source: Plane3dByOriginAndUnitNormal): void {\r\n    this.set(source._origin, source._normal);\r\n  }\r\n  /** Return the altitude of spacePoint above or below the plane.  (Below is negative) */\r\n  public altitude(spacePoint: Point3d): number { return this._normal.dotProductStartEnd(this._origin, spacePoint); }\r\n  /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */\r\n  public altitudeXY(x: number, y: number): number {\r\n    return (x - this._origin.x) * this._normal.x + (y - this._origin.y) * this._normal.y;\r\n  }\r\n  /**\r\n   * Return the x component of the normal used to evaluate altitude.\r\n   */\r\n  public normalX(): number { return this._normal.x; }\r\n  /**\r\n   * Return the x component of the normal used to evaluate altitude.\r\n   */\r\n  public normalY(): number { return this._normal.y; }\r\n  /**\r\n   * Return the z component of the normal used to evaluate altitude.\r\n   */\r\n  public normalZ(): number { return this._normal.z; }\r\n  /**\r\n   * Return (a clone of) the unit normal.\r\n   */\r\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\r\n    return this._normal.clone(result);\r\n  }\r\n  /**\r\n   * Return (a clone of) the origin.\r\n   */\r\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\r\n    return this._origin.clone(result);\r\n  }\r\n  /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */\r\n  public weightedAltitude(spacePoint: Point4d): number {\r\n    return this._normal.dotProductStart3dEnd4d(this._origin, spacePoint);\r\n  }\r\n\r\n  /** return any point at specified (signed) altitude. */\r\n  public altitudeToPoint(altitude: number, result?: Point3d): Point3d {\r\n    return this._origin.plusScaled(this._normal, altitude, result);\r\n  }\r\n  /** Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\r\n   * for a point moving at speed one along the spaceVector.\r\n   */\r\n  public velocityXYZ(x: number, y: number, z: number): number { return this._normal.dotProductXYZ(x, y, z); }\r\n  /** Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\r\n   * for a point moving at speed one along the spaceVector.\r\n   */\r\n  public velocity(spaceVector: Vector3d): number { return this._normal.dotProduct(spaceVector); }\r\n  /** Return the altitude of a point given as separate x,y,z components. */\r\n  public altitudeXYZ(x: number, y: number, z: number): number {\r\n    return this._normal.dotProductStartEndXYZ(this._origin, x, y, z);\r\n  }\r\n  /** Return the altitude of a point given as separate x,y,z,w components. */\r\n  public altitudeXYZW(x: number, y: number, z: number, w: number): number {\r\n    return this._normal.dotProductStartEndXYZW(this._origin, x, y, z, w);\r\n  }\r\n  /** Return the projection of spacePoint onto the plane. */\r\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\r\n    return spacePoint.plusScaled(this._normal, -this._normal.dotProductStartEnd(this._origin, spacePoint), result);\r\n  }\r\n  /** Returns true if spacePoint is within distance tolerance of the plane.\r\n   * * This logic is identical to the [[Plane3d]] method but avoids a level of function call.\r\n  */\r\n  public override isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\r\n    const altitude = this._normal.dotProductStartEnd(this._origin, spacePoint);\r\n    return Math.abs(altitude) <= tolerance;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Plane3dByOriginAndUnitNormal.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndUnitNormal.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 CartesianGeometry\r\n */\r\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\r\nimport { Plane3d } from \"./Plane3d\";\r\nimport { Point4d } from \"../geometry4d/Point4d\";\r\nimport { Angle } from \"./Angle\";\r\nimport { Matrix3d } from \"./Matrix3d\";\r\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\r\nimport { Transform } from \"./Transform\";\r\nimport { XAndY } from \"./XYZProps\";\r\n\r\n/**\r\n * A plane defined by\r\n * * Any point on the plane.\r\n * * a unit normal.\r\n * @public\r\n */\r\nexport class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJSONFunctions {\r\n  private _origin: Point3d;\r\n  private _normal: Vector3d;\r\n  // constructor captures references !!!\r\n  private constructor(origin: Point3d, normal: Vector3d) {\r\n    super();\r\n    this._origin = origin;\r\n    this._normal = normal;\r\n  }\r\n  // This is private because it does not check validity of the unit vector.\r\n  private static _create(x: number, y: number, z: number, u: number, v: number, w: number) {\r\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, z), Vector3d.create(u, v, w));\r\n  }\r\n  /**\r\n   * Create a plane parallel to the XY plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createXYPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 0, 1);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 0, 1);\r\n  }\r\n  /**\r\n   * Create a plane parallel to the YZ plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createYZPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 1, 0, 0);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 1, 0, 0);\r\n  }\r\n  /**\r\n   * Create a plane parallel to the ZX plane\r\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\r\n   */\r\n  public static createZXPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\r\n    if (origin)\r\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 1, 0);\r\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 1, 0);\r\n  }\r\n  /**\r\n   * Create a new Plane3dByOriginAndUnitNormal with given origin and normal.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if `normal.normalize()` returns undefined.\r\n   */\r\n  public static create(\r\n    origin: Point3d, normal: Vector3d, result?: Plane3dByOriginAndUnitNormal,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    if (result) {\r\n      if (normal.normalize(result._normal) === undefined)\r\n        return undefined;\r\n      origin.clone(result._origin);\r\n      return result;\r\n    }\r\n    const normalized = normal.normalize();\r\n    if (normalized === undefined)\r\n      return undefined;\r\n    return new Plane3dByOriginAndUnitNormal(origin.clone(), normalized);\r\n  }\r\n  /**\r\n   * Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if `source.getUnitNormal()` returns undefined.\r\n   */\r\n  public static createFrom(\r\n    source: Plane3d, result?: Plane3dByOriginAndUnitNormal,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    if (source instanceof Plane3dByOriginAndUnitNormal)\r\n      return source.clone(result);\r\n    if (result) {\r\n      if (source.getUnitNormal(result._normal) === undefined)\r\n        return undefined;\r\n      source.getAnyPointOnPlane(result._origin);\r\n      return result;\r\n    }\r\n    const normal = source.getUnitNormal();\r\n    if (normal === undefined)\r\n      return undefined;\r\n    const origin = source.getAnyPointOnPlane();\r\n    return new Plane3dByOriginAndUnitNormal(origin, normal);\r\n  }\r\n  /**\r\n   * Create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   * * If unable to normalize return undefined. (And if result is given it is left unchanged)\r\n   */\r\n  public static createXYZUVW(\r\n    ax: number, ay: number, az: number, ux: number, uy: number, uz: number, result?: Plane3dByOriginAndUnitNormal,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    const magU = Geometry.hypotenuseXYZ(ux, uy, uz);\r\n    if (magU < Geometry.smallMetricDistance)\r\n      return undefined;\r\n    if (result) {\r\n      result._origin.set(ax, ay, az);\r\n      result._normal.set(ux / magU, uy / magU, uz / magU);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(ax, ay, az), Vector3d.create(ux / magU, uy / magU, uz / magU));\r\n  }\r\n  /**\r\n   * Create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line\r\n   * defined by xy parts of origin to target.\r\n   * * origin and normal both have z = 0.\r\n   * * The inputs are NOT captured.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   */\r\n  public static createOriginAndTargetXY(\r\n    origin: XAndY, target: XAndY, result?: Plane3dByOriginAndUnitNormal,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    const ux = target.x - origin.x;\r\n    const uy = target.y - origin.y;\r\n    return this.createXYZUVW(origin.x, origin.y, 0.0, uy, -ux, 0.0, result);\r\n  }\r\n  /**\r\n   * Create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.\r\n   * * Returns undefined if the normal vector is all zeros.\r\n   */\r\n  public static createXYAngle(\r\n    x: number, y: number, normalAngleFromX: Angle, result?: Plane3dByOriginAndUnitNormal,\r\n  ): Plane3dByOriginAndUnitNormal {\r\n    if (result) {\r\n      result._origin.set(x, y, 0.0);\r\n      result._normal.set(normalAngleFromX.cos(), normalAngleFromX.sin(), 0.0);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(\r\n      Point3d.create(x, y, 0), Vector3d.create(normalAngleFromX.cos(), normalAngleFromX.sin()),\r\n    );\r\n  }\r\n  /**\r\n   * Create a plane defined by two points and an in-plane vector.\r\n   * @param pointA any point in the plane\r\n   * @param pointB any other point in the plane\r\n   * @param vector any vector in the plane but not parallel to the vector from pointA to pointB\r\n   */\r\n  public static createPointPointVectorInPlane(\r\n    pointA: Point3d, pointB: Point3d, vector: Vector3d,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = vector.crossProductStartEnd(pointA, pointB);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Create a plane defined by three points.\r\n   * @param pointA any point in the plane.  This will be the origin.\r\n   * @param pointB any other point in the plane\r\n   * @param pointC any third point in the plane but not on the line of pointA and pointB\r\n   */\r\n  public static createOriginAndTargets(\r\n    pointA: Point3d, pointB: Point3d, pointC: Point3d,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = pointA.crossProductToPoints(pointB, pointC);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Create a plane defined by a point and two vectors in the plane\r\n   * @param pointA any point in the plane\r\n   * @param vectorB any vector in the plane\r\n   * @param vectorC any vector in the plane but not parallel to vectorB\r\n   */\r\n  public static createOriginAndVectors(\r\n    pointA: Point3d, vectorB: Vector3d, vectorC: Vector3d,\r\n  ): Plane3dByOriginAndUnitNormal | undefined {\r\n    const cross = vectorB.crossProduct(vectorC);\r\n    if (cross.tryNormalizeInPlace())\r\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\r\n    return undefined;\r\n  }\r\n  /** Test for (toleranced) equality with `other` */\r\n  public isAlmostEqual(other: Plane3dByOriginAndUnitNormal): boolean {\r\n    return this._origin.isAlmostEqual(other._origin) && this._normal.isAlmostEqual(other._normal);\r\n  }\r\n  /** Parse a json fragment `{origin: [x,y,z], normal: [ux,uy,uz]}`  */\r\n  public setFromJSON(json?: any): void {\r\n    if (!json) {\r\n      this._origin.set(0, 0, 0);\r\n      this._normal.set(0, 0, 1);\r\n    } else {\r\n      this._origin.setFromJSON(json.origin);\r\n      this._normal.setFromJSON(json.normal);\r\n    }\r\n  }\r\n  /**\r\n   * Convert to a JSON object.\r\n   * @return {*} [origin,normal]\r\n   */\r\n  public toJSON(): any {\r\n    return { origin: this._origin.toJSON(), normal: this._normal.toJSON() };\r\n  }\r\n  /**\r\n   * Create a new Plane3dByOriginAndUnitNormal from json fragment.\r\n   * * See `Plane3dByOriginAndUnitNormal.setFromJSON`\r\n   */\r\n  public static fromJSON(json?: any): Plane3dByOriginAndUnitNormal {\r\n    const result = Plane3dByOriginAndUnitNormal.createXYPlane();\r\n    result.setFromJSON(json);\r\n    return result;\r\n  }\r\n  /** Return a reference to the origin. */\r\n  public getOriginRef(): Point3d {\r\n    return this._origin;\r\n  }\r\n  /** Return a reference to the unit normal. */\r\n  public getNormalRef(): Vector3d {\r\n    return this._normal;\r\n  }\r\n  /**\r\n   * Return coordinate axes (as a transform) with\r\n   * * origin at plane origin\r\n   * * z axis in direction of plane normal.\r\n   * * x,y axes in plane.\r\n   */\r\n  public getLocalToWorld(): Transform {\r\n    const axes = Matrix3d.createRigidHeadsUp(this._normal, AxisOrder.ZXY);\r\n    return Transform.createRefs(this._origin.clone(), axes);\r\n  }\r\n  /** Return a (singular) transform which projects points to this plane. */\r\n  public getProjectionToPlane(): Transform {\r\n    const axes = Matrix3d.createIdentity();\r\n    axes.addScaledOuterProductInPlace(this._normal, this._normal, -1.0);\r\n    axes.markSingular();\r\n    return Transform.createFixedPointAndMatrix(this._origin, axes);\r\n  }\r\n  /** Copy coordinates from the given origin and normal. */\r\n  public set(origin: Point3d, normal: Vector3d): void {\r\n    this._origin.setFrom(origin);\r\n    this._normal.setFrom(normal);\r\n  }\r\n  /** Return a deep clone (point and normal cloned) */\r\n  public clone(result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal {\r\n    if (result) {\r\n      result.set(this._origin, this._normal);\r\n      return result;\r\n    }\r\n    return new Plane3dByOriginAndUnitNormal(this._origin.clone(), this._normal.clone());\r\n  }\r\n  /** Create a clone and return the transform of the clone. */\r\n  public cloneTransformed(transform: Transform, inverse: boolean = false): Plane3dByOriginAndUnitNormal | undefined {\r\n    const result = this.clone();\r\n    if (inverse) {\r\n      transform.multiplyInversePoint3d(result._origin, result._origin);\r\n      if (transform.matrix.multiplyTransposeVector(result._normal, result._normal) !== undefined\r\n        && result._normal.normalizeInPlace())\r\n        return result;\r\n    } else {\r\n      transform.multiplyPoint3d(result._origin, result._origin);\r\n      if (transform.matrix.multiplyInverseTranspose(result._normal, result._normal) !== undefined\r\n        && result._normal.normalizeInPlace())\r\n        return result;\r\n    }\r\n    return undefined;\r\n  }\r\n  /** Copy data from the given plane. */\r\n  public setFrom(source: Plane3dByOriginAndUnitNormal): void {\r\n    this.set(source._origin, source._normal);\r\n  }\r\n  /** Return the altitude of spacePoint above or below the plane.  (Below is negative) */\r\n  public altitude(spacePoint: Point3d): number {\r\n    return this._normal.dotProductStartEnd(this._origin, spacePoint);\r\n  }\r\n  /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */\r\n  public altitudeXY(x: number, y: number): number {\r\n    return (x - this._origin.x) * this._normal.x + (y - this._origin.y) * this._normal.y;\r\n  }\r\n  /** Return the x component of the normal used to evaluate altitude. */\r\n  public normalX(): number {\r\n    return this._normal.x;\r\n  }\r\n  /** Return the x component of the normal used to evaluate altitude. */\r\n  public normalY(): number {\r\n    return this._normal.y;\r\n  }\r\n  /** Return the z component of the normal used to evaluate altitude. */\r\n  public normalZ(): number {\r\n    return this._normal.z;\r\n  }\r\n  /** Return (a clone of) the unit normal. */\r\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\r\n    return this._normal.clone(result);\r\n  }\r\n  /** Return (a clone of) the origin. */\r\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\r\n    // This function returns the plane origin. In general, a point x is on the plane if and only if (x-o).n = 0.\r\n    return this._origin.clone(result);\r\n  }\r\n  /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */\r\n  public weightedAltitude(spacePoint: Point4d): number {\r\n    return this._normal.dotProductStart3dEnd4d(this._origin, spacePoint);\r\n  }\r\n  /** Return any point at specified (signed) altitude. */\r\n  public altitudeToPoint(altitude: number, result?: Point3d): Point3d {\r\n    return this._origin.plusScaled(this._normal, altitude, result);\r\n  }\r\n  /**\r\n   * Return the dot product of spaceVector with the plane's unit normal. This tells the rate of change of altitude\r\n   * for a point moving at speed one along the spaceVector.\r\n   */\r\n  public velocityXYZ(x: number, y: number, z: number): number {\r\n    return this._normal.dotProductXYZ(x, y, z);\r\n  }\r\n  /**\r\n   * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\r\n   * for a point moving at speed one along the spaceVector.\r\n   */\r\n  public velocity(spaceVector: Vector3d): number {\r\n    return this._normal.dotProduct(spaceVector);\r\n  }\r\n  /** Return the altitude of a point given as separate x,y,z components. */\r\n  public altitudeXYZ(x: number, y: number, z: number): number {\r\n    return this._normal.dotProductStartEndXYZ(this._origin, x, y, z);\r\n  }\r\n  /** Return the altitude of a point given as separate x,y,z,w components. */\r\n  public altitudeXYZW(x: number, y: number, z: number, w: number): number {\r\n    return this._normal.dotProductStartEndXYZW(this._origin, x, y, z, w);\r\n  }\r\n  /** Return the projection of spacePoint onto the plane. */\r\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\r\n    return spacePoint.plusScaled(this._normal, -this._normal.dotProductStartEnd(this._origin, spacePoint), result);\r\n  }\r\n  /**\r\n   * Returns true if spacePoint is within distance tolerance of the plane.\r\n   * * This logic is identical to the [[Plane3d]] method but avoids a level of function call.\r\n   */\r\n  public override isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\r\n    const altitude = this._normal.dotProductStartEnd(this._origin, spacePoint);\r\n    return Math.abs(altitude) <= tolerance;\r\n  }\r\n}\r\n"]}

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

@@ -15,25 +15,28 @@ import { XYAndZ } from "./XYZProps";
  *   * 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 declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSONFunctions {
-    /** origin of plane grid */
+    /** Origin of plane grid */
     origin: Point3d;
     /** u direction in plane grid */
     vectorU: Vector3d;
     /** v direction in plane grid */
     vectorV: Vector3d;
     private constructor();
-    /** 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: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
-    /** clone to a new plane. */
+    /** Clone to a new plane. */
     clone(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
-    /** 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: Plane3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors | undefined;
@@ -52,13 +55,15 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
     static createCapture(origin: Point3d, vectorU: Vector3d, vectorV: Vector3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
     /** Set all origin and both vectors from direct numeric parameters */
     setOriginAndVectorsXYZ(x0: number, y0: number, z0: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number): Plane3dByOriginAndVectors;
-    /** 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: Point3d, vectorU: Vector3d, vectorV: Vector3d): Plane3dByOriginAndVectors;
     /** Create a new plane from direct numeric parameters */
     static createOriginAndVectorsXYZ(x0: number, y0: number, z0: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
-    /** 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.
@@ -67,13 +72,15 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
     static createOriginAndTargets(origin: Point3d, targetU: Point3d, targetV: Point3d, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
     /** Create a plane with origin at 000, unit vectorU in x direction, and unit vectorV in the y direction. */
     static createXYPlane(result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
-    /** 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
      */
     static createOriginAndVectorsArrays(origin: Float64Array, vectorU: Float64Array, vectorV: Float64Array, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
-    /** 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
@@ -97,17 +104,16 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
      * @return {*} [origin,normal]
      */
     toJSON(): any;
-    /** create a new plane.   See `setFromJSON` for layout example. */
+    /** Create a new plane.   See `setFromJSON` for layout example. */
     static fromJSON(json?: any): Plane3dByOriginAndVectors;
     /** Test origin and vectors for isAlmostEqual with `other` */
     isAlmostEqual(other: Plane3dByOriginAndVectors): boolean;
-    /** 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(): boolean;
-    /**
-     * Return (if possible) a unit normal to the plane.
-     */
+    /** Return (if possible) a unit normal to the plane */
     getUnitNormal(result?: Vector3d): Vector3d | undefined;
     /**
      * Return (if possible) a unit normal to the plane.
@@ -119,9 +125,7 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
      */
     getAnyPointOnPlane(result?: Point3d): Point3d;
     private static _workVector;
-    /**
-     * 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?: Ray3d): Ray3d | undefined;
     /**
      * Create a rigid frame (i.e. frenet frame) with
@@ -132,35 +136,35 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
      * @param result optional result
      */
     toRigidFrame(result?: Transform): Transform | undefined;
-    /**
-     * Apply the transform to the origin and vectors in place.
-     */
+    /** Apply the transform to the origin and vectors in place */
     transformInPlace(transform: Transform): void;
     /**
      * Return x component of the (normalized!) {vectorU CROSS vectorV}.
      * Return 0 if the cross product is zero.
-     * */
+     */
     normalX(): number;
     /**
-  * 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(): number;
     /**
      * Return z component of the (normalized!) {vectorU CROSS vectorV}.
      * Return 0 if the cross product is zero.
-     * */
+     */
     normalZ(): number;
-    /** 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: XYAndZ): number;
-    /** 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: number, y: number, z: number): number;
-    /** 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: XYAndZ): number;
-    /** 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: number, y: number, z: number): number;
-    /** 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: Point4d): number;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Plane3dByOriginAndVectors.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndVectors.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EAAa,eAAe,EAAY,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,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;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGpC;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,OAAQ,YAAW,eAAe;IAC/E,2BAA2B;IACpB,MAAM,EAAE,OAAO,CAAC;IACvB,gCAAgC;IACzB,OAAO,EAAE,QAAQ,CAAC;IACzB,gCAAgC;IACzB,OAAO,EAAE,QAAQ,CAAC;IACzB,OAAO;IAMP,6DAA6D;WAC/C,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAS1J,4BAA4B;IACrB,KAAK,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAK3E;;OAEG;WACW,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB,GAAG,SAAS;IAgBpH;;;;;;;;;OASG;WACW,sCAAsC,CAAC,SAAS,EAAE,SAAS,EACvE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EACxD,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAiBhE,oDAAoD;WACtC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IASjJ,qEAAqE;IAC9D,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,yBAAyB;IAMpK;;OAEG;IACI,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,yBAAyB;IAM5G,wDAAwD;WAC1C,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAKlN;;;;;OAKG;WACW,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAGxJ,2GAA2G;WAC7F,aAAa,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAG1F;;;;OAIG;WACW,4BAA4B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAG7K;;;;OAIG;WACW,oCAAoC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,yBAAyB;IAoBxL;;;;;;;OAOG;IACI,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAGvE,6EAA6E;IACtE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ;IAG1E,sGAAsG;IAC/F,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG;IAW7B;;;OAGG;IACI,MAAM,IAAI,GAAG;IAOpB,kEAAkE;WACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,yBAAyB;IAK7D,6DAA6D;IACtD,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO;IAK/D;;OAEG;IACI,gBAAgB,IAAI,OAAO;IAKlC;;OAEG;IACa,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAGtE;;;OAGG;IACI,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAI1D;;OAEG;IACa,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAG7D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAW;IACrC;;OAEG;IACI,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS;IASvD;;;;;;;OAOG;IACI,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAI9D;;OAEG;IACI,gBAAgB,CAAC,SAAS,EAAE,SAAS;IAM5C;;;SAGK;IACE,OAAO,IAAI,MAAM;IAIxB;;;MAGE;IACK,OAAO,IAAI,MAAM;IAIxB;;;SAGK;IACE,OAAO,IAAI,MAAM;IAIxB,sHAAsH;IAC/G,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQpC,sHAAsH;IAC/G,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ3D,2HAA2H;IACpH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQ1C,2HAA2H;IACpH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ3D;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,OAAO;IAOrC;;;;OAIG;IACI,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;CAuB3E"}
+{"version":3,"file":"Plane3dByOriginAndVectors.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndVectors.ts"],"names":[],"mappings":"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"}