@itwin/core-geometry 4.1.0-dev.66 → 4.1.0-dev.68

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

@@ -34,50 +34,59 @@ export declare class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJ
      * @param origin optional plane origin.  If omitted, the origin is placed at 000
      */
     static createZXPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal;
-    /** 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.
      */
     static create(origin: Point3d, normal: Vector3d, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined;
-    /** 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.
      */
     static createFrom(source: Plane3d, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined;
-    /** 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)
      */
     static createXYZUVW(ax: number, ay: number, az: number, ux: number, uy: number, uz: number, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined;
-    /** 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.
      */
     static createOriginAndTargetXY(origin: XAndY, target: XAndY, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal | undefined;
-    /** 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: number, y: number, normalAngleFromX: Angle, result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal;
-    /** 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
      */
     static createPointPointVectorInPlane(pointA: Point3d, pointB: Point3d, vector: Vector3d): Plane3dByOriginAndUnitNormal | 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
      */
     static createOriginAndTargets(pointA: Point3d, pointB: Point3d, pointC: Point3d): Plane3dByOriginAndUnitNormal | 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
      */
     static createOriginAndVectors(pointA: Point3d, vectorB: Vector3d, vectorC: Vector3d): Plane3dByOriginAndUnitNormal | undefined;
-    /** test for (toleranced) equality with `other` */
+    /** Test for (toleranced) equality with `other` */
     isAlmostEqual(other: Plane3dByOriginAndUnitNormal): boolean;
     /** Parse a json fragment `{origin: [x,y,z], normal: [ux,uy,uz]}`  */
     setFromJSON(json?: any): void;
@@ -86,7 +95,8 @@ export declare class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJ
      * @return {*} [origin,normal]
      */
     toJSON(): any;
-    /**  create a new Plane3dByOriginAndUnitNormal from json fragment.
+    /**
+     * Create a new Plane3dByOriginAndUnitNormal from json fragment.
      * * See `Plane3dByOriginAndUnitNormal.setFromJSON`
      */
     static fromJSON(json?: any): Plane3dByOriginAndUnitNormal;
@@ -94,18 +104,18 @@ export declare class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJ
     getOriginRef(): Point3d;
     /** Return a reference to the unit normal. */
     getNormalRef(): Vector3d;
-    /** Return coordinate axes (as a transform) with
+    /**
+     * Return coordinate axes (as a transform) with
      * * origin at plane origin
      * * z axis in direction of plane normal.
      * * x,y axes in plane.
      */
     getLocalToWorld(): Transform;
-    /** Return a (singular) transform which projects points to this plane.
-     */
+    /** Return a (singular) transform which projects points to this plane. */
     getProjectionToPlane(): Transform;
     /** Copy coordinates from the given origin and normal. */
     set(origin: Point3d, normal: Vector3d): void;
-    /** return a deep clone (point and normal cloned) */
+    /** Return a deep clone (point and normal cloned) */
     clone(result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal;
     /** Create a clone and return the transform of the clone. */
     cloneTransformed(transform: Transform, inverse?: boolean): Plane3dByOriginAndUnitNormal | undefined;
@@ -115,35 +125,27 @@ export declare class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJ
     altitude(spacePoint: Point3d): number;
     /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */
     altitudeXY(x: number, y: number): number;
-    /**
-     * Return the x component of the normal used to evaluate altitude.
-     */
+    /** Return the x component of the normal used to evaluate altitude. */
     normalX(): number;
-    /**
-     * Return the x component of the normal used to evaluate altitude.
-     */
+    /** Return the x component of the normal used to evaluate altitude. */
     normalY(): number;
-    /**
-     * Return the z component of the normal used to evaluate altitude.
-     */
+    /** Return the z component of the normal used to evaluate altitude. */
     normalZ(): number;
-    /**
-     * Return (a clone of) the unit normal.
-     */
+    /** Return (a clone of) the unit normal. */
     getUnitNormal(result?: Vector3d): Vector3d | undefined;
-    /**
-     * Return (a clone of) the origin.
-     */
+    /** Return (a clone of) the origin. */
     getAnyPointOnPlane(result?: Point3d): Point3d;
     /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */
     weightedAltitude(spacePoint: Point4d): number;
-    /** return any point at specified (signed) altitude. */
+    /** Return any point at specified (signed) altitude. */
     altitudeToPoint(altitude: number, result?: Point3d): Point3d;
-    /** 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: number, y: number, z: number): number;
-    /** 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.
      */
     velocity(spaceVector: Vector3d): number;
@@ -153,9 +155,10 @@ export declare class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJ
     altitudeXYZW(x: number, y: number, z: number, w: number): number;
     /** Return the projection of spacePoint onto the plane. */
     projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d;
-    /** 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: Point3d, tolerance?: number): boolean;
 }
 //# sourceMappingURL=Plane3dByOriginAndUnitNormal.d.ts.map

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

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

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.map

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

package/lib/esm/geometry3d/Plane3dByOriginAndVectors.js

@@ -249,6 +249,8 @@ 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 */