@itwin/core-geometry 5.1.0-dev.9 → 5.2.0-dev.1

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

@@ -1 +1 @@
-{"version":3,"file":"IndexedXYZCollection.js","sourceRoot":"","sources":["../../../src/geometry3d/IndexedXYZCollection.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module ArraysAndInterfaces\n */\n\nimport { Geometry } from \"../Geometry\";\nimport { Point3d, Vector3d, XYZ } from \"./Point3dVector3d\";\nimport { Range3d } from \"./Range\";\nimport { XAndY, XYAndZ } from \"./XYZProps\";\n\nclass PointsIterator implements Iterator<Point3d>, Iterable<Point3d> {\n  private readonly _collection: IndexedXYZCollection;\n  private _curIndex = -1;\n\n  public constructor(collection: IndexedXYZCollection) {\n    this._collection = collection;\n  }\n\n  public next(): IteratorResult<Point3d> {\n    if (++this._curIndex >= this._collection.length) {\n      // The ECMAScript spec states that value=undefined is valid if done=true. The TypeScript interface violates the spec hence the cast to any and back below.\n      return { done: true } as any as IteratorResult<Point3d>;\n    }\n\n    return {\n      value: this._collection.getPoint3dAtUncheckedPointIndex(this._curIndex),\n      done: false,\n    };\n  }\n\n  public [Symbol.iterator](): Iterator<Point3d> { return this; }\n}\n/**\n * abstract base class for read-only access to XYZ data with indexed reference.\n * * This allows algorithms to work with Point3d[] or GrowableXYZ.\n *   * GrowableXYZArray implements these for its data.\n *   * Point3dArrayCarrier carries a (reference to) a Point3d[] and implements the methods with calls on that array reference.\n * * In addition to \"point by point\" accessors, other abstract members compute commonly useful vector data \"between points\".\n * * Methods that create vectors among multiple indices allow callers to avoid creating temporaries.\n * @public\n */\nexport abstract class IndexedXYZCollection {\n  /**\n   * Return the point at `index` as a strongly typed Point3d.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getPoint3dAtCheckedPointIndex(index: number, result?: Point3d): Point3d | undefined;\n  /**\n   * Return the point at `index` as a strongly typed Point3d, without checking the point index validity.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getPoint3dAtUncheckedPointIndex(index: number, result?: Point3d): Point3d;\n  /**\n   * Get from `index` as a strongly typed Vector3d.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getVector3dAtCheckedVectorIndex(index: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from the point at `indexA` to the point at `indexB`\n   * @param indexA index of point within the array\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract vectorIndexIndex(indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from `origin` to the point at `indexB`\n   * @param origin origin for vector\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if index is out of bounds\n   */\n  public abstract vectorXYAndZIndex(origin: XYAndZ, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from the point at `indexA` to `target`\n   * @param indexA index of point within the array\n   * @param target target for vector\n   * @param result caller-allocated vector.\n   * @returns undefined if index is out of bounds\n   */\n  public vectorIndexXYAndZ(indexA: number, target: XYAndZ, result?: Vector3d): Vector3d | undefined {\n    const reversed = this.vectorXYAndZIndex(target, indexA, result);\n    return reversed?.negate(reversed);\n  }\n  /**\n   * Return the dot product of the vectors from the point at `origin` to the points at `indexA` and `indexB`.\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param indexA index of point within the array; target of the second vector\n   * @returns undefined if index is out of bounds\n   */\n  public dotProductIndexIndexIndex(origin: number, indexA: number, indexB: number): number | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length || indexB < 0 || indexB >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return (this.getXAtUncheckedPointIndex(indexA) - x0) * (this.getXAtUncheckedPointIndex(indexB) - x0) +\n           (this.getYAtUncheckedPointIndex(indexA) - y0) * (this.getYAtUncheckedPointIndex(indexB) - y0) +\n           (this.getZAtUncheckedPointIndex(indexA) - z0) * (this.getZAtUncheckedPointIndex(indexB) - z0);\n  }\n  /**\n   * Return the dot product of the vectors from the point at `origin` to the point at `indexA` and to `targetB`.\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param targetB target for second vector\n   * @returns undefined if index is out of bounds\n   */\n  public dotProductIndexIndexXYAndZ(origin: number, indexA: number, targetB: XYAndZ): number | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return (this.getXAtUncheckedPointIndex(indexA) - x0) * (targetB.x - x0) +\n           (this.getYAtUncheckedPointIndex(indexA) - y0) * (targetB.y - y0) +\n           (this.getZAtUncheckedPointIndex(indexA) - z0) * (targetB.z - z0);\n  }\n  /**\n   * Return the cross product of the vectors from `origin` to points at `indexA` and `indexB`\n   * @param origin origin for vector\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract crossProductXYAndZIndexIndex(origin: XYAndZ, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return the cross product of the vectors from `origin` to the point at `indexA` and to `targetB`\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param targetB target of second vector\n   * @param result optional caller-allocated result to fill and return\n   * @returns undefined if an index is out of bounds\n   */\n  public crossProductIndexIndexXYAndZ(origin: number, indexA: number, targetB: XYAndZ, result?: Vector3d): Vector3d | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return Vector3d.createCrossProduct(this.getXAtUncheckedPointIndex(indexA) - x0,\n                                       this.getYAtUncheckedPointIndex(indexA) - y0,\n                                       this.getZAtUncheckedPointIndex(indexA) - z0,\n                                       targetB.x - x0,\n                                       targetB.y - y0,\n                                       targetB.z - z0, result);\n  }\n  /**\n   * Return the cross product of vectors from `origin` to points at `indexA` and `indexB`\n   * @param origin origin for vector\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result optional caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract crossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return the cross product of vectors from origin point at `indexA` to target points at `indexB` and `indexC`\n   * @param origin index of origin\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns return true if indexA, indexB both valid\n   */\n  public abstract accumulateCrossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result: Vector3d): void;\n\n  /**\n   * read-only property for number of XYZ in the collection.\n   */\n  public abstract get length(): number;\n  /**\n   * Return distance squared between indicated points.\n   * @param index0 first point index\n   * @param index1 second point index\n   */\n  public abstract distanceSquaredIndexIndex(index0: number, index1: number): number | undefined;\n  /**\n   * Return distance squared between the point at index0 and target.\n   * @param index0 first point index\n   * @param target second point\n   */\n  public distanceSquaredIndexXYAndZ(index0: number, target: XYAndZ): number | undefined {\n    if (index0 < 0 || index0 >= this.length)\n      return undefined;\n    return Geometry.hypotenuseSquaredXYZ(\n      target.x - this.getXAtUncheckedPointIndex(index0),\n      target.y - this.getYAtUncheckedPointIndex(index0),\n      target.z - this.getZAtUncheckedPointIndex(index0));\n  }\n  /**\n   * Return distance between indicated points.\n   * @param index0 first point index\n   * @param index1 second point index\n   */\n  public abstract distanceIndexIndex(index0: number, index1: number): number | undefined;\n  /**\n   * Test if index is valid for an xyz within this array.\n   * @param index xyz index to test.\n   */\n  public isIndexValid(index: number): boolean {\n    return index >= 0 && index < this.length;\n  }\n  /** Adjust index into range by modulo with the length. */\n  public cyclicIndex(i: number): number {\n    return (i % this.length);\n  }\n  /** Return the range of the points. */\n  public getRange(): Range3d {\n    const range = Range3d.createNull();\n    const n = this.length;\n    const point = Point3d.create();\n    for (let i = 0; i < n; i++) {\n      this.getPoint3dAtUncheckedPointIndex(i, point);\n      range.extendPoint(point);\n    }\n    return range;\n  }\n\n  /**\n   * For each subset of `k` successive points within tolerance of the first point in the subset, return the indices of\n   * the last `k-1` duplicates.\n   * * Index `0` is never returned.\n   * @param tolerance optional distance tol for compression (default [[Geometry.smallMetricDistance]])\n   * @param preserveLast if the last `k < this.length` points of the instance are duplicates, whether to return the\n   * indices of the *first* `k-1` duplicates for this last run. If true, index `this.length - 1` is not returned\n   * unless all points are duplicates, in which case all indices but `0` are returned. Default value is false.\n   * @return ordered array of 0-based indices of duplicate points\n   */\n  public findOrderedDuplicates(tolerance: number = Geometry.smallMetricDistance, preserveLast: boolean = false): number[] {\n    const indices: number[] = [];\n    if (this.length > 1) {\n      for (let i = 0; i < this.length - 1;) {\n        let j = i + 1;\n        for (; this.almostEqualIndexIndex(i, j, tolerance); ++j)\n          indices.push(j);\n        i = j; // found next unique point\n      }\n      if (preserveLast && indices.length > 0 && indices.length < this.length - 1) { // not all points are duplicate\n        let numLastRun = 0;\n        for (; numLastRun <= indices.length - 1 && indices[indices.length - 1 - numLastRun] === this.length - 1 - numLastRun; ++numLastRun);\n        for (let i = 0; i < numLastRun; ++i)\n          indices[indices.length - 1 - i] -= 1; // decrement the indices of the last run so that the last point is preserved\n      }\n    }\n    return indices;\n  }\n\n  /** Accumulate scale times the x,y,z values at index.\n   * * No action if index is out of bounds.\n   */\n  public abstract accumulateScaledXYZ(index: number, scale: number, sum: Point3d): void;\n\n  /** Compute the linear combination s of the indexed p_i and given scales s_i.\n   * @param scales array of scales. For best results, scales should have same length as the instance.\n   * @param result optional pre-allocated object to fill and return\n   * @return s = sum(p_i * s_i), where i ranges from 0 to min(this.length, scales.length).\n  */\n  public linearCombination(scales: number[], result?: Point3d | Vector3d): XYZ {\n    const n = Math.min(this.length, scales.length);\n    const sum = (result instanceof Vector3d) ? Vector3d.createZero(result) : Point3d.createZero(result);\n    for (let i = 0; i < n; ++i) {\n      sum.x += scales[i] * this.getXAtUncheckedPointIndex(i);\n      sum.y += scales[i] * this.getYAtUncheckedPointIndex(i);\n      sum.z += scales[i] * this.getZAtUncheckedPointIndex(i);\n    }\n    return sum;\n  }\n\n  /**\n   * Interpolate the points at the given indices.\n   * @param index0 index of point p0 within the array\n   * @param fraction fraction f such that returned point is p0 + f * (p1 - p0)\n   * @param index1 index of point p1 within the array\n   * @param result optional caller-allocated result to fill and return\n   * @returns undefined if an index is out of bounds\n   */\n  public interpolateIndexIndex(index0: number, fraction: number, index1: number, result?: Point3d): Point3d | undefined {\n    if (index0 < 0 || index0 >= this.length || index1 < 0 || index1 >= this.length)\n      return undefined;\n    return Point3d.create(Geometry.interpolate(this.getXAtUncheckedPointIndex(index0), fraction, this.getXAtUncheckedPointIndex(index1)),\n                          Geometry.interpolate(this.getYAtUncheckedPointIndex(index0), fraction, this.getYAtUncheckedPointIndex(index1)),\n                          Geometry.interpolate(this.getZAtUncheckedPointIndex(index0), fraction, this.getZAtUncheckedPointIndex(index1)), result);\n  }\n\n  /** access x of indexed point */\n  public abstract getXAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** access y of indexed point */\n  public abstract getYAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** access z of indexed point */\n  public abstract getZAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** Return iterator over the points in this collection. Usage:\n   * ```ts\n   *  for (const point: Point3d of collection.points) { ... }\n   * ```\n   */\n  public get points(): Iterable<Point3d> {\n    return new PointsIterator(this);\n  }\n  /** convert to Point3d[] */\n  public getArray(): Point3d[] {\n    const result = [];\n    for (const p of this.points)\n      result.push(p);\n    return result;\n  }\n  /** Return the first point, or undefined if the array is empty. */\n  public front(result?: Point3d): Point3d | undefined {\n    if (this.length === 0)\n      return undefined;\n    return this.getPoint3dAtUncheckedPointIndex(0, result);\n  }\n  /** Return the last point, or undefined if the array is empty. */\n  public back(result?: Point3d): Point3d | undefined {\n    if (this.length === 0)\n      return undefined;\n    return this.getPoint3dAtUncheckedPointIndex(this.length - 1, result);\n  }\n  /**\n   * Test whether the indexed points are equal within tolerance.\n   * @param index0 index of first point\n   * @param index1 index of second point\n   * @param tolerance max coordinate difference to be considered equal. For exact test, pass 0. Defaults to `Geometry.smallMetricDistance`.\n   */\n  public almostEqualIndexIndex(index0: number, index1: number, tolerance = Geometry.smallMetricDistance): boolean | undefined {\n    if (index0 < 0 || index0 >= this.length || index1 < 0 || index1 >= this.length)\n      return undefined;\n    return Geometry.isSameCoordinate(this.getXAtUncheckedPointIndex(index0), this.getXAtUncheckedPointIndex(index1), tolerance)\n      && Geometry.isSameCoordinate(this.getYAtUncheckedPointIndex(index0), this.getYAtUncheckedPointIndex(index1), tolerance)\n      && Geometry.isSameCoordinate(this.getZAtUncheckedPointIndex(index0), this.getZAtUncheckedPointIndex(index1), tolerance);\n  }\n}\n/**\n * abstract base class extends IndexedXYZCollection, adding methods to push, peek, and pop, and rewrite.\n * @public\n */\nexport abstract class IndexedReadWriteXYZCollection extends IndexedXYZCollection {\n  /** push a (clone of) point onto the collection\n   * * point itself is not pushed -- xyz data is extracted into the native form of the collection.\n   */\n  public abstract push(data: XYAndZ): void;\n  /**\n   * push a new point (given by coordinates) onto the collection\n   * @param x x coordinate\n   * @param y y coordinate\n   * @param z z coordinate\n   */\n  public abstract pushXYZ(x?: number, y?: number, z?: number): void;\n  /** remove the final point. */\n  public abstract pop(): void;\n  /**  clear all entries */\n  public abstract clear(): void;\n  /** reverse the points in place. */\n  public abstract reverseInPlace(): void;\n}\n\n/**\n * Type for use as signature for xyz data of a single linestring appearing in a parameter list.\n * @public\n */\nexport type LineStringDataVariant = IndexedXYZCollection | XYAndZ[] | XAndY[] | number[][];\n\n/**\n * Type for use as signature for multiple xyz data of multiple linestrings appearing in a parameter list.\n * @public\n */\nexport type MultiLineStringDataVariant = LineStringDataVariant | LineStringDataVariant[];\n"]}
+{"version":3,"file":"IndexedXYZCollection.js","sourceRoot":"","sources":["../../../src/geometry3d/IndexedXYZCollection.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module ArraysAndInterfaces\n */\n\nimport { Geometry } from \"../Geometry\";\nimport { Point3d, Vector3d, XYZ } from \"./Point3dVector3d\";\nimport { Range3d } from \"./Range\";\nimport { Transform } from \"./Transform\";\nimport { XAndY, XYAndZ } from \"./XYZProps\";\n\nclass PointsIterator implements Iterator<Point3d>, Iterable<Point3d> {\n  private readonly _collection: IndexedXYZCollection;\n  private _curIndex = -1;\n\n  public constructor(collection: IndexedXYZCollection) {\n    this._collection = collection;\n  }\n\n  public next(): IteratorResult<Point3d> {\n    if (++this._curIndex >= this._collection.length) {\n      // The ECMAScript spec states that value=undefined is valid if done=true. The TypeScript interface violates the spec hence the cast to any and back below.\n      return { done: true } as any as IteratorResult<Point3d>;\n    }\n\n    return {\n      value: this._collection.getPoint3dAtUncheckedPointIndex(this._curIndex),\n      done: false,\n    };\n  }\n\n  public [Symbol.iterator](): Iterator<Point3d> { return this; }\n}\n/**\n * abstract base class for read-only access to XYZ data with indexed reference.\n * * This allows algorithms to work with Point3d[] or GrowableXYZ.\n *   * GrowableXYZArray implements these for its data.\n *   * Point3dArrayCarrier carries a (reference to) a Point3d[] and implements the methods with calls on that array reference.\n * * In addition to \"point by point\" accessors, other abstract members compute commonly useful vector data \"between points\".\n * * Methods that create vectors among multiple indices allow callers to avoid creating temporaries.\n * @public\n */\nexport abstract class IndexedXYZCollection {\n  /**\n   * Return the point at `index` as a strongly typed Point3d.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getPoint3dAtCheckedPointIndex(index: number, result?: Point3d): Point3d | undefined;\n  /**\n   * Return the point at `index` as a strongly typed Point3d, without checking the point index validity.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getPoint3dAtUncheckedPointIndex(index: number, result?: Point3d): Point3d;\n  /**\n   * Get from `index` as a strongly typed Vector3d.\n   * @param index index of point within the array\n   * @param result caller-allocated destination\n   * @returns undefined if the index is out of bounds\n   */\n  public abstract getVector3dAtCheckedVectorIndex(index: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from the point at `indexA` to the point at `indexB`\n   * @param indexA index of point within the array\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract vectorIndexIndex(indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from `origin` to the point at `indexB`\n   * @param origin origin for vector\n   * @param indexB index of point within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if index is out of bounds\n   */\n  public abstract vectorXYAndZIndex(origin: XYAndZ, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return a vector from the point at `indexA` to `target`\n   * @param indexA index of point within the array\n   * @param target target for vector\n   * @param result caller-allocated vector.\n   * @returns undefined if index is out of bounds\n   */\n  public vectorIndexXYAndZ(indexA: number, target: XYAndZ, result?: Vector3d): Vector3d | undefined {\n    const reversed = this.vectorXYAndZIndex(target, indexA, result);\n    return reversed?.negate(reversed);\n  }\n  /**\n   * Return the dot product of the vectors from the point at `origin` to the points at `indexA` and `indexB`.\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param indexA index of point within the array; target of the second vector\n   * @returns undefined if index is out of bounds\n   */\n  public dotProductIndexIndexIndex(origin: number, indexA: number, indexB: number): number | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length || indexB < 0 || indexB >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return (this.getXAtUncheckedPointIndex(indexA) - x0) * (this.getXAtUncheckedPointIndex(indexB) - x0) +\n           (this.getYAtUncheckedPointIndex(indexA) - y0) * (this.getYAtUncheckedPointIndex(indexB) - y0) +\n           (this.getZAtUncheckedPointIndex(indexA) - z0) * (this.getZAtUncheckedPointIndex(indexB) - z0);\n  }\n  /**\n   * Return the dot product of the vectors from the point at `origin` to the point at `indexA` and to `targetB`.\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param targetB target for second vector\n   * @returns undefined if index is out of bounds\n   */\n  public dotProductIndexIndexXYAndZ(origin: number, indexA: number, targetB: XYAndZ): number | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return (this.getXAtUncheckedPointIndex(indexA) - x0) * (targetB.x - x0) +\n           (this.getYAtUncheckedPointIndex(indexA) - y0) * (targetB.y - y0) +\n           (this.getZAtUncheckedPointIndex(indexA) - z0) * (targetB.z - z0);\n  }\n  /**\n   * Return the cross product of the vectors from `origin` to points at `indexA` and `indexB`\n   * @param origin origin for vector\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract crossProductXYAndZIndexIndex(origin: XYAndZ, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return the cross product of the vectors from `origin` to the point at `indexA` and to `targetB`\n   * @param origin index of point within the array; origin of both vectors\n   * @param indexA index of point within the array; target of the first vector\n   * @param targetB target of second vector\n   * @param result optional caller-allocated result to fill and return\n   * @returns undefined if an index is out of bounds\n   */\n  public crossProductIndexIndexXYAndZ(origin: number, indexA: number, targetB: XYAndZ, result?: Vector3d): Vector3d | undefined {\n    if (origin < 0 || origin >= this.length || indexA < 0 || indexA >= this.length)\n      return undefined;\n    const x0 = this.getXAtUncheckedPointIndex(origin);\n    const y0 = this.getYAtUncheckedPointIndex(origin);\n    const z0 = this.getZAtUncheckedPointIndex(origin);\n    return Vector3d.createCrossProduct(this.getXAtUncheckedPointIndex(indexA) - x0,\n                                       this.getYAtUncheckedPointIndex(indexA) - y0,\n                                       this.getZAtUncheckedPointIndex(indexA) - z0,\n                                       targetB.x - x0,\n                                       targetB.y - y0,\n                                       targetB.z - z0, result);\n  }\n  /**\n   * Return the cross product of vectors from `origin` to points at `indexA` and `indexB`\n   * @param origin origin for vector\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result optional caller-allocated vector.\n   * @returns undefined if either index is out of bounds\n   */\n  public abstract crossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;\n  /**\n   * Return the cross product of vectors from origin point at `indexA` to target points at `indexB` and `indexC`\n   * @param origin index of origin\n   * @param indexA index of first target within the array\n   * @param indexB index of second target within the array\n   * @param result caller-allocated vector.\n   * @returns return true if indexA, indexB both valid\n   */\n  public abstract accumulateCrossProductIndexIndexIndex(origin: number, indexA: number, indexB: number, result: Vector3d): void;\n\n  /**\n   * read-only property for number of XYZ in the collection.\n   */\n  public abstract get length(): number;\n  /**\n   * Return distance squared between indicated points.\n   * @param index0 first point index\n   * @param index1 second point index\n   */\n  public abstract distanceSquaredIndexIndex(index0: number, index1: number): number | undefined;\n  /**\n   * Return distance squared between the point at index0 and target.\n   * @param index0 first point index\n   * @param target second point\n   */\n  public distanceSquaredIndexXYAndZ(index0: number, target: XYAndZ): number | undefined {\n    if (index0 < 0 || index0 >= this.length)\n      return undefined;\n    return Geometry.hypotenuseSquaredXYZ(\n      target.x - this.getXAtUncheckedPointIndex(index0),\n      target.y - this.getYAtUncheckedPointIndex(index0),\n      target.z - this.getZAtUncheckedPointIndex(index0));\n  }\n  /**\n   * Return distance between indicated points.\n   * @param index0 first point index\n   * @param index1 second point index\n   */\n  public abstract distanceIndexIndex(index0: number, index1: number): number | undefined;\n  /**\n   * Test if index is valid for an xyz within this array.\n   * @param index xyz index to test.\n   */\n  public isIndexValid(index: number): boolean {\n    return index >= 0 && index < this.length;\n  }\n  /** Adjust index into range by modulo with the length. */\n  public cyclicIndex(i: number): number {\n    return (i % this.length);\n  }\n  /** Return the range of the points. */\n  public getRange(transform?: Transform, result?: Range3d): Range3d {\n    let range = result;\n    if (range)\n      range.setNull();\n    else\n      range = Range3d.createNull();\n    const n = this.length;\n    const point = Point3d.create();\n    for (let i = 0; i < n; i++) {\n      this.getPoint3dAtUncheckedPointIndex(i, point);\n      range.extendPoint(point, transform);\n    }\n    return range;\n  }\n\n  /**\n   * For each subset of `k` successive points within tolerance of the first point in the subset, return the indices of\n   * the last `k-1` duplicates.\n   * * Index `0` is never returned.\n   * @param tolerance optional distance tol for compression (default [[Geometry.smallMetricDistance]])\n   * @param preserveLast if the last `k < this.length` points of the instance are duplicates, whether to return the\n   * indices of the *first* `k-1` duplicates for this last run. If true, index `this.length - 1` is not returned\n   * unless all points are duplicates, in which case all indices but `0` are returned. Default value is false.\n   * @return ordered array of 0-based indices of duplicate points\n   */\n  public findOrderedDuplicates(tolerance: number = Geometry.smallMetricDistance, preserveLast: boolean = false): number[] {\n    const indices: number[] = [];\n    if (this.length > 1) {\n      for (let i = 0; i < this.length - 1;) {\n        let j = i + 1;\n        for (; this.almostEqualIndexIndex(i, j, tolerance); ++j)\n          indices.push(j);\n        i = j; // found next unique point\n      }\n      if (preserveLast && indices.length > 0 && indices.length < this.length - 1) { // not all points are duplicate\n        let numLastRun = 0;\n        for (; numLastRun <= indices.length - 1 && indices[indices.length - 1 - numLastRun] === this.length - 1 - numLastRun; ++numLastRun);\n        for (let i = 0; i < numLastRun; ++i)\n          indices[indices.length - 1 - i] -= 1; // decrement the indices of the last run so that the last point is preserved\n      }\n    }\n    return indices;\n  }\n\n  /** Accumulate scale times the x,y,z values at index.\n   * * No action if index is out of bounds.\n   */\n  public abstract accumulateScaledXYZ(index: number, scale: number, sum: Point3d): void;\n\n  /** Compute the linear combination s of the indexed p_i and given scales s_i.\n   * @param scales array of scales. For best results, scales should have same length as the instance.\n   * @param result optional pre-allocated object to fill and return\n   * @return s = sum(p_i * s_i), where i ranges from 0 to min(this.length, scales.length).\n  */\n  public linearCombination(scales: number[], result?: Point3d | Vector3d): XYZ {\n    const n = Math.min(this.length, scales.length);\n    const sum = (result instanceof Vector3d) ? Vector3d.createZero(result) : Point3d.createZero(result);\n    for (let i = 0; i < n; ++i) {\n      sum.x += scales[i] * this.getXAtUncheckedPointIndex(i);\n      sum.y += scales[i] * this.getYAtUncheckedPointIndex(i);\n      sum.z += scales[i] * this.getZAtUncheckedPointIndex(i);\n    }\n    return sum;\n  }\n\n  /**\n   * Interpolate the points at the given indices.\n   * @param index0 index of point p0 within the array\n   * @param fraction fraction f such that returned point is p0 + f * (p1 - p0)\n   * @param index1 index of point p1 within the array\n   * @param result optional caller-allocated result to fill and return\n   * @returns undefined if an index is out of bounds\n   */\n  public interpolateIndexIndex(index0: number, fraction: number, index1: number, result?: Point3d): Point3d | undefined {\n    if (index0 < 0 || index0 >= this.length || index1 < 0 || index1 >= this.length)\n      return undefined;\n    return Point3d.create(Geometry.interpolate(this.getXAtUncheckedPointIndex(index0), fraction, this.getXAtUncheckedPointIndex(index1)),\n                          Geometry.interpolate(this.getYAtUncheckedPointIndex(index0), fraction, this.getYAtUncheckedPointIndex(index1)),\n                          Geometry.interpolate(this.getZAtUncheckedPointIndex(index0), fraction, this.getZAtUncheckedPointIndex(index1)), result);\n  }\n\n  /** access x of indexed point */\n  public abstract getXAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** access y of indexed point */\n  public abstract getYAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** access z of indexed point */\n  public abstract getZAtUncheckedPointIndex(pointIndex: number): number;\n\n  /** Return iterator over the points in this collection. Usage:\n   * ```ts\n   *  for (const point: Point3d of collection.points) { ... }\n   * ```\n   */\n  public get points(): Iterable<Point3d> {\n    return new PointsIterator(this);\n  }\n  /** convert to Point3d[] */\n  public getArray(): Point3d[] {\n    const result = [];\n    for (const p of this.points)\n      result.push(p);\n    return result;\n  }\n  /** Return the first point, or undefined if the array is empty. */\n  public front(result?: Point3d): Point3d | undefined {\n    if (this.length === 0)\n      return undefined;\n    return this.getPoint3dAtUncheckedPointIndex(0, result);\n  }\n  /** Return the last point, or undefined if the array is empty. */\n  public back(result?: Point3d): Point3d | undefined {\n    if (this.length === 0)\n      return undefined;\n    return this.getPoint3dAtUncheckedPointIndex(this.length - 1, result);\n  }\n  /**\n   * Test whether the indexed points are equal within tolerance.\n   * @param index0 index of first point\n   * @param index1 index of second point\n   * @param tolerance max coordinate difference to be considered equal. For exact test, pass 0. Defaults to `Geometry.smallMetricDistance`.\n   * @returns whether the points are equal within tolerance, or `undefined` if either index is invalid.\n   */\n  public almostEqualIndexIndex(index0: number, index1: number, tolerance = Geometry.smallMetricDistance): boolean | undefined {\n    if (index0 < 0 || index0 >= this.length || index1 < 0 || index1 >= this.length)\n      return undefined;\n    return Geometry.isSameCoordinate(this.getXAtUncheckedPointIndex(index0), this.getXAtUncheckedPointIndex(index1), tolerance)\n      && Geometry.isSameCoordinate(this.getYAtUncheckedPointIndex(index0), this.getYAtUncheckedPointIndex(index1), tolerance)\n      && Geometry.isSameCoordinate(this.getZAtUncheckedPointIndex(index0), this.getZAtUncheckedPointIndex(index1), tolerance);\n  }\n  /**\n   * Test whether the xy-coordinates of the indexed points are equal within tolerance. The z-coordinates are ignored.\n   * @param index0 index of first point\n   * @param index1 index of second point\n   * @param tolerance max coordinate difference to be considered equal. For exact test, pass 0. Defaults to `Geometry.smallMetricDistance`.\n   * @returns whether the xy-coordinates of the points are equal within tolerance, or `undefined` if either index is invalid.\n   */\n  public almostEqualXYIndexIndex(index0: number, index1: number, tolerance = Geometry.smallMetricDistance): boolean | undefined {\n    if (index0 < 0 || index0 >= this.length || index1 < 0 || index1 >= this.length)\n      return undefined;\n    return Geometry.isSameCoordinate(this.getXAtUncheckedPointIndex(index0), this.getXAtUncheckedPointIndex(index1), tolerance)\n      && Geometry.isSameCoordinate(this.getYAtUncheckedPointIndex(index0), this.getYAtUncheckedPointIndex(index1), tolerance);\n  }\n}\n/**\n * abstract base class extends IndexedXYZCollection, adding methods to push, peek, and pop, and rewrite.\n * @public\n */\nexport abstract class IndexedReadWriteXYZCollection extends IndexedXYZCollection {\n  /** push a (clone of) point onto the collection\n   * * point itself is not pushed -- xyz data is extracted into the native form of the collection.\n   */\n  public abstract push(data: XYAndZ): void;\n  /**\n   * push a new point (given by coordinates) onto the collection\n   * @param x x coordinate\n   * @param y y coordinate\n   * @param z z coordinate\n   */\n  public abstract pushXYZ(x?: number, y?: number, z?: number): void;\n  /** remove the final point. */\n  public abstract pop(): void;\n  /**  clear all entries */\n  public abstract clear(): void;\n  /** reverse the points in place. */\n  public abstract reverseInPlace(): void;\n}\n\n/**\n * Type for use as signature for xyz data of a single linestring appearing in a parameter list.\n * @public\n */\nexport type LineStringDataVariant = IndexedXYZCollection | XYAndZ[] | XAndY[] | number[][];\n\n/**\n * Type for use as signature for multiple xyz data of multiple linestrings appearing in a parameter list.\n * @public\n */\nexport type MultiLineStringDataVariant = LineStringDataVariant | LineStringDataVariant[];\n"]}

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

@@ -131,5 +131,7 @@ export declare abstract class Plane3d implements PlaneAltitudeEvaluator {
      * * MUST BE IMPLEMENTED BY DERIVED CLASSES
      */
     abstract projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d;
+    /** Return the projection of (x,y,z) onto the plane. */
+    projectXYZToPlane(x: number, y: number, z: number, result?: Point3d): Point3d;
 }
 //# sourceMappingURL=Plane3d.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Plane3d.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Plane3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EAAY,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,8BAAsB,OAAQ,YAAW,sBAAsB;IAC7D;;;OAGG;aACa,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM;IACrD,4EAA4E;IACrE,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,GAAE,MAAqC,GAAG,OAAO;IAGrG;;;;OAIG;IACI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,MAAqC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAGrG;;;;OAIG;IACI,mBAAmB,CACxB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAqC,GAChF,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAGb;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;;;OAMG;IACI,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAG7D;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAGpD;;;;OAIG;aACa,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM;IAC7D;;;;;OAKG;aACa,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IACpE;;;;;OAKG;aACa,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM;IACvD;;;;OAIG;aACa,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IACpE;;;OAGG;aACa,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;CACpF"}
+{"version":3,"file":"Plane3d.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/Plane3d.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EAAY,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,8BAAsB,OAAQ,YAAW,sBAAsB;IAC7D;;;OAGG;aACa,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM;IACrD,4EAA4E;IACrE,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,GAAE,MAAqC,GAAG,OAAO;IAGrG;;;;OAIG;IACI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,MAAqC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAGrG;;;;OAIG;IACI,mBAAmB,CACxB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAqC,GAChF,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAGb;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;OAIG;aACa,OAAO,IAAI,MAAM;IACjC;;;;;;OAMG;IACI,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAG7D;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAGpD;;;;OAIG;aACa,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM;IAC7D;;;;;OAKG;aACa,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IACpE;;;;;OAKG;aACa,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM;IACvD;;;;OAIG;aACa,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IACpE;;;OAGG;aACa,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IACnF,uDAAuD;IAChD,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;CAIrF"}

package/lib/esm/geometry3d/Plane3d.js

@@ -88,7 +88,12 @@ export class Plane3d {
      * * Classes with a purely implicit equation of their plane can accept the default implementation
      */
     getAnyPointOnPlane(result) {
-        return this.projectPointToPlane(Point3d.create(0, 0, 0), result);
+        return this.projectXYZToPlane(0, 0, 0, result);
+    }
+    /** Return the projection of (x,y,z) onto the plane. */
+    projectXYZToPlane(x, y, z, result) {
+        const point = Point3d.create(x, y, z, result);
+        return this.projectPointToPlane(point, point);
     }
 }
 //# sourceMappingURL=Plane3d.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Plane3d.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3d.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAA0B,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,OAAgB,OAAO;IAM3B,4EAA4E;IACrE,cAAc,CAAC,UAAmB,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QACzF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,SAAS,CAAC;IAC1D,CAAC;IACD;;;;OAIG;IACI,gBAAgB,CAAC,KAAc,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QACtF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IACD;;;;OAIG;IACI,mBAAmB,CACxB,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QAEjF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IAmBD;;;;;;OAMG;IACI,aAAa,CAAC,MAAiB;QACpC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IACD;;;;;OAKG;IACI,kBAAkB,CAAC,MAAgB;QACxC,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;CAgCF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\nimport { Geometry, PlaneAltitudeEvaluator } from \"../Geometry\";\nimport { Point4d } from \"../geometry4d/Point4d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\n\n/**\n * Plane3d is the abstract base class for multiple 3d plane representations:\n * * [[Plane3dByOriginAndUnitNormal]] -- plane defined by origin and normal, with no preferred in-plane directions\n * * [[Plane3dByOriginAndVectors]] -- plane defined by origin and 2 vectors in the plane, with normal implied by the vectors' cross product\n * * [[Point4d]] -- homogeneous form of xyzw plane.\n * * [[ClipPlane]] -- implicit plane with additional markup as used by compound clip structures such as [[ConvexClipPlaneSet]] and [[UnionOfConvexClipPlaneSets]]\n *\n * As an abstract base class, Plane3d demands that its derived classes implement queries to answer questions\n * about the plane's normal and the altitude of points above or below the plane.  (Altitude is measured perpendicular to the plane.)\n * These abstract methods are:\n * * altitude(Point3d), altitudeXYZ(x,y,z), and altitudeXYZW(Point4d) -- evaluate altitude\n * * normalX(), normalY(), normalZ() -- return components of the plane's normal vector.\n * * velocity(Vector3d), velocityXYZ(x,y,z) -- return dot product of the input vector with the plane normal.\n * * projectPointToPlane (spacePoint: Point3d) -- return projection of spacePoint into the plane.\n *\n * The Plane3d base class also provides implementations of several queries which it can implement by calling the abstract queries.\n * * Derived classes may choose to override these default implementations using private knowledge of what they have stored.\n * * isPointInPlane(spacePoint, tolerance?) -- test if spacePoint is in the plane with tolerance.  Default tolerance is small metric distance\n * * classifyAltitude (spacePoint, tolerance?), classifyAltitudeXYZ (x,y,z,tolerance?) -- return -1,0,1 indicating if spacePoint's altitude\n *     is negative, near zero, or positive.\n *\n * Notes about scaling and signs in methods that compute altitudes, normal components and velocities:\n * * The term \"altitude\" indicates a _signed_ distance from the plane.\n *   * altitude zero is _on_ the plane\n *   * positive altitudes are on one side\n *   * negatives are on the other.\n *  * Altitude values and normal components are not strictly required to be true cartesian distance.   If the calling code happens to use \"distance scaled by 1000X\" it\n *     understands that it can be OK for its plane implementation to have that scaling.\n *  * By convention, derived classes whose definitions (normals and vectors in plane) are simple cartesian are expected\n *    to return true distances.  This applies to:\n *    * [[Plane3dByOriginAndUnitNormal]] and [[ClipPlane]]\n *       * These maintain a stored unit normal so the altitude calculations are inherently true cartesian distance.\n *    * [[Plane3dByOriginAndVectors]] -- this is a bit expensive because\n *       * the normal is the cross product of the defining vectors.\n *       * that cross product is not typically unit\n *       * normalization adds to the cost of computing off-plane distances\n *       * Since a main purpose of using this class is often to navigate a skewed, non-unit grid, occasional off-plane queries are not likely to be important.\n *  * \"4 dimensional\" (homogeneous coordinate planes) ([[Point4d]] and [[PlaneByOriginAndVectors4d]])\n *     * typically do _not_ force their coefficients to any distance-based normalization\n *     * are typically used for calculations in spaces with skewing effects do to perspective, and true distances are not required.\n *  * In all classes, the `weightedAltitude` method is free to be scaled distance.\n * @public\n */\nexport abstract class Plane3d implements PlaneAltitudeEvaluator {\n  /**\n   * Return the altitude of spacePoint above or below the plane. (Below is negative)\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   */\n  public abstract altitude(spacePoint: Point3d): number;\n  /** Returns true if spacePoint is within distance tolerance of the plane. */\n  public isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\n    return Math.abs(this.altitude(spacePoint)) <= tolerance;\n  }\n  /**\n   * Return a value -1, 0, 1 giving a signed indicator of whether the toleranced altitude of the point is\n   * negative, near zero, or positive.\n   *\n   */\n  public classifyAltitude(point: Point3d, tolerance: number = Geometry.smallMetricDistance): -1 | 0 | 1 {\n    return Geometry.split3Way01(this.altitude(point), tolerance);\n  }\n  /**\n   * Return a value -1, 0, 1 giving a signed indicator of whether the toleranced altitude of x,y,z is\n   * negative, near zero, or positive.\n   *\n   */\n  public classifyAltitudeXYZ(\n    x: number, y: number, z: number, tolerance: number = Geometry.smallMetricDistance,\n  ): -1 | 0 | 1 {\n    return Geometry.split3Way01(this.altitudeXYZ(x, y, z), tolerance);\n  }\n  /**\n   * Return the x component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalX(): number;\n  /**\n   * Return the y component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalY(): number;\n  /**\n   * Return the z component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalZ(): number;\n  /**\n   * Return the unit normal for the plane.\n   * * The abstract base class implementation assembles the normal from normalX, normalY, normalZ calls.\n   * * Derived classes should (but are not required to) override for maximum efficiency if the separate normal calls\n   * cause repeated normalization.\n   * @param result\n   */\n  public getUnitNormal(result?: Vector3d): Vector3d | undefined {\n    return Vector3d.createNormalized(this.normalX(), this.normalY(), this.normalZ(), result);\n  }\n  /**\n   * Return any point on the plane.\n   * * Default implementation projects the origin (0,0,0) to the plane.\n   * * Classes that have a preferred origin for their plane should override.\n   * * Classes with a purely implicit equation of their plane can accept the default implementation\n   */\n  public getAnyPointOnPlane(result?: Point3d): Point3d {\n    return this.projectPointToPlane(Point3d.create(0, 0, 0), result);\n  }\n  /**\n   * Return the altitude of weighted spacePoint above or below the plane.  (Below is negative)\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract weightedAltitude(spacePoint: Point4d): number;\n  /**\n   * Return the dot product of spaceVector (x,y,z) with the plane's unit normal. This tells the rate of change of\n   * altitude for a point moving at speed one along the spaceVector.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract velocityXYZ(x: number, y: number, z: number): number;\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract velocity(spaceVector: Vector3d): number;\n  /**\n   * Return the altitude of a point given as separate x,y,z components.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract altitudeXYZ(x: number, y: number, z: number): number;\n  /**\n   * Return the projection of spacePoint onto the plane.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   */\n  public abstract projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d;\n}\n"]}
+{"version":3,"file":"Plane3d.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3d.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAA0B,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,OAAgB,OAAO;IAM3B,4EAA4E;IACrE,cAAc,CAAC,UAAmB,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QACzF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,SAAS,CAAC;IAC1D,CAAC;IACD;;;;OAIG;IACI,gBAAgB,CAAC,KAAc,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QACtF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IACD;;;;OAIG;IACI,mBAAmB,CACxB,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QAEjF,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IAmBD;;;;;;OAMG;IACI,aAAa,CAAC,MAAiB;QACpC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IACD;;;;;OAKG;IACI,kBAAkB,CAAC,MAAgB;QACxC,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAgCD,uDAAuD;IAChD,iBAAiB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,MAAgB;QACxE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\nimport { Geometry, PlaneAltitudeEvaluator } from \"../Geometry\";\nimport { Point4d } from \"../geometry4d/Point4d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\n\n/**\n * Plane3d is the abstract base class for multiple 3d plane representations:\n * * [[Plane3dByOriginAndUnitNormal]] -- plane defined by origin and normal, with no preferred in-plane directions\n * * [[Plane3dByOriginAndVectors]] -- plane defined by origin and 2 vectors in the plane, with normal implied by the vectors' cross product\n * * [[Point4d]] -- homogeneous form of xyzw plane.\n * * [[ClipPlane]] -- implicit plane with additional markup as used by compound clip structures such as [[ConvexClipPlaneSet]] and [[UnionOfConvexClipPlaneSets]]\n *\n * As an abstract base class, Plane3d demands that its derived classes implement queries to answer questions\n * about the plane's normal and the altitude of points above or below the plane.  (Altitude is measured perpendicular to the plane.)\n * These abstract methods are:\n * * altitude(Point3d), altitudeXYZ(x,y,z), and altitudeXYZW(Point4d) -- evaluate altitude\n * * normalX(), normalY(), normalZ() -- return components of the plane's normal vector.\n * * velocity(Vector3d), velocityXYZ(x,y,z) -- return dot product of the input vector with the plane normal.\n * * projectPointToPlane (spacePoint: Point3d) -- return projection of spacePoint into the plane.\n *\n * The Plane3d base class also provides implementations of several queries which it can implement by calling the abstract queries.\n * * Derived classes may choose to override these default implementations using private knowledge of what they have stored.\n * * isPointInPlane(spacePoint, tolerance?) -- test if spacePoint is in the plane with tolerance.  Default tolerance is small metric distance\n * * classifyAltitude (spacePoint, tolerance?), classifyAltitudeXYZ (x,y,z,tolerance?) -- return -1,0,1 indicating if spacePoint's altitude\n *     is negative, near zero, or positive.\n *\n * Notes about scaling and signs in methods that compute altitudes, normal components and velocities:\n * * The term \"altitude\" indicates a _signed_ distance from the plane.\n *   * altitude zero is _on_ the plane\n *   * positive altitudes are on one side\n *   * negatives are on the other.\n *  * Altitude values and normal components are not strictly required to be true cartesian distance.   If the calling code happens to use \"distance scaled by 1000X\" it\n *     understands that it can be OK for its plane implementation to have that scaling.\n *  * By convention, derived classes whose definitions (normals and vectors in plane) are simple cartesian are expected\n *    to return true distances.  This applies to:\n *    * [[Plane3dByOriginAndUnitNormal]] and [[ClipPlane]]\n *       * These maintain a stored unit normal so the altitude calculations are inherently true cartesian distance.\n *    * [[Plane3dByOriginAndVectors]] -- this is a bit expensive because\n *       * the normal is the cross product of the defining vectors.\n *       * that cross product is not typically unit\n *       * normalization adds to the cost of computing off-plane distances\n *       * Since a main purpose of using this class is often to navigate a skewed, non-unit grid, occasional off-plane queries are not likely to be important.\n *  * \"4 dimensional\" (homogeneous coordinate planes) ([[Point4d]] and [[PlaneByOriginAndVectors4d]])\n *     * typically do _not_ force their coefficients to any distance-based normalization\n *     * are typically used for calculations in spaces with skewing effects do to perspective, and true distances are not required.\n *  * In all classes, the `weightedAltitude` method is free to be scaled distance.\n * @public\n */\nexport abstract class Plane3d implements PlaneAltitudeEvaluator {\n  /**\n   * Return the altitude of spacePoint above or below the plane. (Below is negative)\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   */\n  public abstract altitude(spacePoint: Point3d): number;\n  /** Returns true if spacePoint is within distance tolerance of the plane. */\n  public isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\n    return Math.abs(this.altitude(spacePoint)) <= tolerance;\n  }\n  /**\n   * Return a value -1, 0, 1 giving a signed indicator of whether the toleranced altitude of the point is\n   * negative, near zero, or positive.\n   *\n   */\n  public classifyAltitude(point: Point3d, tolerance: number = Geometry.smallMetricDistance): -1 | 0 | 1 {\n    return Geometry.split3Way01(this.altitude(point), tolerance);\n  }\n  /**\n   * Return a value -1, 0, 1 giving a signed indicator of whether the toleranced altitude of x,y,z is\n   * negative, near zero, or positive.\n   *\n   */\n  public classifyAltitudeXYZ(\n    x: number, y: number, z: number, tolerance: number = Geometry.smallMetricDistance,\n  ): -1 | 0 | 1 {\n    return Geometry.split3Way01(this.altitudeXYZ(x, y, z), tolerance);\n  }\n  /**\n   * Return the x component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalX(): number;\n  /**\n   * Return the y component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalY(): number;\n  /**\n   * Return the z component of the normal used to evaluate altitude.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract normalZ(): number;\n  /**\n   * Return the unit normal for the plane.\n   * * The abstract base class implementation assembles the normal from normalX, normalY, normalZ calls.\n   * * Derived classes should (but are not required to) override for maximum efficiency if the separate normal calls\n   * cause repeated normalization.\n   * @param result\n   */\n  public getUnitNormal(result?: Vector3d): Vector3d | undefined {\n    return Vector3d.createNormalized(this.normalX(), this.normalY(), this.normalZ(), result);\n  }\n  /**\n   * Return any point on the plane.\n   * * Default implementation projects the origin (0,0,0) to the plane.\n   * * Classes that have a preferred origin for their plane should override.\n   * * Classes with a purely implicit equation of their plane can accept the default implementation\n   */\n  public getAnyPointOnPlane(result?: Point3d): Point3d {\n    return this.projectXYZToPlane(0, 0, 0, result);\n  }\n  /**\n   * Return the altitude of weighted spacePoint above or below the plane.  (Below is negative)\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract weightedAltitude(spacePoint: Point4d): number;\n  /**\n   * Return the dot product of spaceVector (x,y,z) with the plane's unit normal. This tells the rate of change of\n   * altitude for a point moving at speed one along the spaceVector.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract velocityXYZ(x: number, y: number, z: number): number;\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract velocity(spaceVector: Vector3d): number;\n  /**\n   * Return the altitude of a point given as separate x,y,z components.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   * * See [[Plane3d]] note about scaling.\n   */\n  public abstract altitudeXYZ(x: number, y: number, z: number): number;\n  /**\n   * Return the projection of spacePoint onto the plane.\n   * * MUST BE IMPLEMENTED BY DERIVED CLASSES\n   */\n  public abstract projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d;\n  /** Return the projection of (x,y,z) onto the plane. */\n  public projectXYZToPlane(x: number, y: number, z: number, result?: Point3d): Point3d {\n    const point = Point3d.create(x, y, z, result);\n    return this.projectPointToPlane(point, point);\n  }\n}\n"]}

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

@@ -155,6 +155,8 @@ 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;
+    /** Return the projection of (x,y,z) onto the plane. */
+    projectXYZToPlane(x: number, y: number, z: number, result?: Point3d): Point3d;
     /**
      * 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.

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

@@ -320,7 +320,12 @@ export class Plane3dByOriginAndUnitNormal extends Plane3d {
     }
     /** Return the projection of spacePoint onto the plane. */
     projectPointToPlane(spacePoint, result) {
-        return spacePoint.plusScaled(this._normal, -this._normal.dotProductStartEnd(this._origin, spacePoint), result);
+        return this.projectXYZToPlane(spacePoint.x, spacePoint.y, spacePoint.z, result);
+    }
+    /** Return the projection of (x,y,z) onto the plane. */
+    projectXYZToPlane(x, y, z, result) {
+        const scale = -this._normal.dotProductStartEndXYZ(this._origin, x, y, z);
+        return Point3d.create(x + scale * this._normal.x, y + scale * this._normal.y, z + scale * this._normal.z, result);
     }
     /**
      * Returns true if spacePoint is within distance tolerance of the plane.

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":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\nimport { Plane3d } from \"./Plane3d\";\nimport { Point4d } from \"../geometry4d/Point4d\";\nimport { Angle } from \"./Angle\";\nimport { Matrix3d } from \"./Matrix3d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\nimport { Transform } from \"./Transform\";\nimport { XAndY } from \"./XYZProps\";\n\n/**\n * A plane defined by\n * * Any point on the plane.\n * * a unit normal.\n * @public\n */\nexport class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJSONFunctions {\n  private _origin: Point3d;\n  private _normal: Vector3d;\n  // constructor captures references !!!\n  private constructor(origin: Point3d, normal: Vector3d) {\n    super();\n    this._origin = origin;\n    this._normal = normal;\n  }\n  // This is private because it does not check validity of the unit vector.\n  private static _create(x: number, y: number, z: number, u: number, v: number, w: number) {\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, z), Vector3d.create(u, v, w));\n  }\n  /**\n   * Create a plane parallel to the XY plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createXYPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 0, 1);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 0, 1);\n  }\n  /**\n   * Create a plane parallel to the YZ plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createYZPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 1, 0, 0);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 1, 0, 0);\n  }\n  /**\n   * Create a plane parallel to the ZX plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createZXPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 1, 0);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 1, 0);\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal with given origin and normal.\n   * * The inputs are NOT captured.\n   * * Returns undefined if `normal.normalize()` returns undefined.\n   */\n  public static create(\n    origin: Point3d, normal: Vector3d, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    if (result) {\n      if (normal.normalize(result._normal) === undefined)\n        return undefined;\n      origin.clone(result._origin);\n      return result;\n    }\n    const normalized = normal.normalize();\n    if (normalized === undefined)\n      return undefined;\n    return new Plane3dByOriginAndUnitNormal(origin.clone(), normalized);\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.\n   * * The inputs are NOT captured.\n   * * Returns undefined if `source.getUnitNormal()` returns undefined.\n   */\n  public static createFrom(\n    source: Plane3d, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    if (source instanceof Plane3dByOriginAndUnitNormal)\n      return source.clone(result);\n    if (result) {\n      if (source.getUnitNormal(result._normal) === undefined)\n        return undefined;\n      source.getAnyPointOnPlane(result._origin);\n      return result;\n    }\n    const normal = source.getUnitNormal();\n    if (normal === undefined)\n      return undefined;\n    const origin = source.getAnyPointOnPlane();\n    return new Plane3dByOriginAndUnitNormal(origin, normal);\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.\n   * * Returns undefined if the normal vector is all zeros.\n   * * If unable to normalize return undefined. (And if result is given it is left unchanged)\n   */\n  public static createXYZUVW(\n    ax: number, ay: number, az: number, ux: number, uy: number, uz: number, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const magU = Geometry.hypotenuseXYZ(ux, uy, uz);\n    if (magU < Geometry.smallMetricDistance)\n      return undefined;\n    if (result) {\n      result._origin.set(ax, ay, az);\n      result._normal.set(ux / magU, uy / magU, uz / magU);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(ax, ay, az), Vector3d.create(ux / magU, uy / magU, uz / magU));\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line\n   * defined by xy parts of origin to target.\n   * * origin and normal both have z = 0.\n   * * The inputs are NOT captured.\n   * * Returns undefined if the normal vector is all zeros.\n   */\n  public static createOriginAndTargetXY(\n    origin: XAndY, target: XAndY, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const ux = target.x - origin.x;\n    const uy = target.y - origin.y;\n    return this.createXYZUVW(origin.x, origin.y, 0.0, uy, -ux, 0.0, result);\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.\n   * * Returns undefined if the normal vector is all zeros.\n   */\n  public static createXYAngle(\n    x: number, y: number, normalAngleFromX: Angle, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal {\n    if (result) {\n      result._origin.set(x, y, 0.0);\n      result._normal.set(normalAngleFromX.cos(), normalAngleFromX.sin(), 0.0);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(\n      Point3d.create(x, y, 0), Vector3d.create(normalAngleFromX.cos(), normalAngleFromX.sin()),\n    );\n  }\n  /**\n   * Create a plane defined by two points and an in-plane vector.\n   * @param pointA any point in the plane\n   * @param pointB any other point in the plane\n   * @param vector any vector in the plane but not parallel to the vector from pointA to pointB\n   */\n  public static createPointPointVectorInPlane(\n    pointA: Point3d, pointB: Point3d, vector: Vector3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = vector.crossProductStartEnd(pointA, pointB);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /**\n   * Create a plane defined by three points.\n   * @param pointA any point in the plane.  This will be the origin.\n   * @param pointB any other point in the plane\n   * @param pointC any third point in the plane but not on the line of pointA and pointB\n   */\n  public static createOriginAndTargets(\n    pointA: Point3d, pointB: Point3d, pointC: Point3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = pointA.crossProductToPoints(pointB, pointC);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /**\n   * Create a plane defined by a point and two vectors in the plane\n   * @param pointA any point in the plane\n   * @param vectorB any vector in the plane\n   * @param vectorC any vector in the plane but not parallel to vectorB\n   */\n  public static createOriginAndVectors(\n    pointA: Point3d, vectorB: Vector3d, vectorC: Vector3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = vectorB.crossProduct(vectorC);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /** Test for (toleranced) equality with `other` */\n  public isAlmostEqual(other: Plane3dByOriginAndUnitNormal): boolean {\n    return this._origin.isAlmostEqual(other._origin) && this._normal.isAlmostEqual(other._normal);\n  }\n  /** Parse a json fragment `{origin: [x,y,z], normal: [ux,uy,uz]}`  */\n  public setFromJSON(json?: any): void {\n    if (!json) {\n      this._origin.set(0, 0, 0);\n      this._normal.set(0, 0, 1);\n    } else {\n      this._origin.setFromJSON(json.origin);\n      this._normal.setFromJSON(json.normal);\n    }\n  }\n  /**\n   * Convert to a JSON object.\n   * @return {*} [origin,normal]\n   */\n  public toJSON(): any {\n    return { origin: this._origin.toJSON(), normal: this._normal.toJSON() };\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal from json fragment.\n   * * See `Plane3dByOriginAndUnitNormal.setFromJSON`\n   */\n  public static fromJSON(json?: any): Plane3dByOriginAndUnitNormal {\n    const result = Plane3dByOriginAndUnitNormal.createXYPlane();\n    result.setFromJSON(json);\n    return result;\n  }\n  /** Return a reference to the origin. */\n  public getOriginRef(): Point3d {\n    return this._origin;\n  }\n  /** Return a reference to the unit normal. */\n  public getNormalRef(): Vector3d {\n    return this._normal;\n  }\n  /**\n   * Return coordinate axes (as a transform) with\n   * * origin at plane origin\n   * * z axis in direction of plane normal.\n   * * x,y axes in plane.\n   */\n  public getLocalToWorld(): Transform {\n    const axes = Matrix3d.createRigidHeadsUp(this._normal, AxisOrder.ZXY);\n    return Transform.createRefs(this._origin.clone(), axes);\n  }\n  /** Return a (singular) transform which projects points to this plane. */\n  public getProjectionToPlane(): Transform {\n    const axes = Matrix3d.createIdentity();\n    axes.addScaledOuterProductInPlace(this._normal, this._normal, -1.0);\n    axes.markSingular();\n    return Transform.createFixedPointAndMatrix(this._origin, axes);\n  }\n  /** Copy coordinates from the given origin and normal. */\n  public set(origin: Point3d, normal: Vector3d): void {\n    this._origin.setFrom(origin);\n    this._normal.setFrom(normal);\n  }\n  /** Return a deep clone (point and normal cloned) */\n  public clone(result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal {\n    if (result) {\n      result.set(this._origin, this._normal);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(this._origin.clone(), this._normal.clone());\n  }\n  /** Create a clone and return the transform of the clone. */\n  public cloneTransformed(transform: Transform, inverse: boolean = false): Plane3dByOriginAndUnitNormal | undefined {\n    const result = this.clone();\n    if (inverse) {\n      transform.multiplyInversePoint3d(result._origin, result._origin);\n      if (transform.matrix.multiplyTransposeVector(result._normal, result._normal) !== undefined\n        && result._normal.normalizeInPlace())\n        return result;\n    } else {\n      transform.multiplyPoint3d(result._origin, result._origin);\n      if (transform.matrix.multiplyInverseTranspose(result._normal, result._normal) !== undefined\n        && result._normal.normalizeInPlace())\n        return result;\n    }\n    return undefined;\n  }\n  /** Copy data from the given plane. */\n  public setFrom(source: Plane3dByOriginAndUnitNormal): void {\n    this.set(source._origin, source._normal);\n  }\n  /** Return the altitude of spacePoint above or below the plane.  (Below is negative) */\n  public altitude(spacePoint: Point3d): number {\n    return this._normal.dotProductStartEnd(this._origin, spacePoint);\n  }\n  /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */\n  public altitudeXY(x: number, y: number): number {\n    return (x - this._origin.x) * this._normal.x + (y - this._origin.y) * this._normal.y;\n  }\n  /** Return the x component of the normal used to evaluate altitude. */\n  public normalX(): number {\n    return this._normal.x;\n  }\n  /** Return the x component of the normal used to evaluate altitude. */\n  public normalY(): number {\n    return this._normal.y;\n  }\n  /** Return the z component of the normal used to evaluate altitude. */\n  public normalZ(): number {\n    return this._normal.z;\n  }\n  /** Return (a clone of) the unit normal. */\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\n    return this._normal.clone(result);\n  }\n  /** Return (a clone of) the origin. */\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\n    // This function returns the plane origin. In general, a point x is on the plane if and only if (x-o).n = 0.\n    return this._origin.clone(result);\n  }\n  /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */\n  public weightedAltitude(spacePoint: Point4d): number {\n    return this._normal.dotProductStart3dEnd4d(this._origin, spacePoint);\n  }\n  /** Return any point at specified (signed) altitude. */\n  public altitudeToPoint(altitude: number, result?: Point3d): Point3d {\n    return this._origin.plusScaled(this._normal, altitude, result);\n  }\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal. This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   */\n  public velocityXYZ(x: number, y: number, z: number): number {\n    return this._normal.dotProductXYZ(x, y, z);\n  }\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   */\n  public velocity(spaceVector: Vector3d): number {\n    return this._normal.dotProduct(spaceVector);\n  }\n  /** Return the altitude of a point given as separate x,y,z components. */\n  public altitudeXYZ(x: number, y: number, z: number): number {\n    return this._normal.dotProductStartEndXYZ(this._origin, x, y, z);\n  }\n  /** Return the altitude of a point given as separate x,y,z,w components. */\n  public altitudeXYZW(x: number, y: number, z: number, w: number): number {\n    return this._normal.dotProductStartEndXYZW(this._origin, x, y, z, w);\n  }\n  /** Return the projection of spacePoint onto the plane. */\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\n    return spacePoint.plusScaled(this._normal, -this._normal.dotProductStartEnd(this._origin, spacePoint), result);\n  }\n  /**\n   * Returns true if spacePoint is within distance tolerance of the plane.\n   * * This logic is identical to the [[Plane3d]] method but avoids a level of function call.\n   */\n  public override isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\n    const altitude = this._normal.dotProductStartEnd(this._origin, spacePoint);\n    return Math.abs(altitude) <= tolerance;\n  }\n}\n"]}
+{"version":3,"file":"Plane3dByOriginAndUnitNormal.js","sourceRoot":"","sources":["../../../src/geometry3d/Plane3dByOriginAndUnitNormal.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,SAAS,EAAmB,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,OAAO;IAC/C,OAAO,CAAU;IACjB,OAAO,CAAW;IAC1B,sCAAsC;IACtC,YAAoB,MAAe,EAAE,MAAgB;QACnD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,yEAAyE;IACjE,MAAM,CAAC,OAAO,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QACrF,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,aAAa,CAAC,MAAgB;QAC1C,IAAI,MAAM;YACR,OAAO,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,aAAa,CAAC,MAAgB;QAC1C,IAAI,MAAM;YACR,OAAO,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,aAAa,CAAC,MAAgB;QAC1C,IAAI,MAAM;YACR,OAAO,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAClB,MAAe,EAAE,MAAgB,EAAE,MAAqC;QAExE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;gBAChD,OAAO,SAAS,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,UAAU,KAAK,SAAS;YAC1B,OAAO,SAAS,CAAC;QACnB,OAAO,IAAI,4BAA4B,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,UAAU,CACtB,MAAe,EAAE,MAAqC;QAEtD,IAAI,MAAM,YAAY,4BAA4B;YAChD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;gBACpD,OAAO,SAAS,CAAC;YACnB,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS;YACtB,OAAO,SAAS,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC3C,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,YAAY,CACxB,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,MAAqC;QAE7G,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,GAAG,QAAQ,CAAC,mBAAmB;YACrC,OAAO,SAAS,CAAC;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACxH,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,uBAAuB,CACnC,MAAa,EAAE,MAAa,EAAE,MAAqC;QAEnE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,aAAa,CACzB,CAAS,EAAE,CAAS,EAAE,gBAAuB,EAAE,MAAqC;QAEpF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,4BAA4B,CACrC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CACzF,CAAC;IACJ,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,6BAA6B,CACzC,MAAe,EAAE,MAAe,EAAE,MAAgB;QAElD,MAAM,KAAK,GAAG,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,KAAK,CAAC,mBAAmB,EAAE;YAC7B,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,sBAAsB,CAClC,MAAe,EAAE,MAAe,EAAE,MAAe;QAEjD,MAAM,KAAK,GAAG,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,KAAK,CAAC,mBAAmB,EAAE;YAC7B,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,sBAAsB,CAClC,MAAe,EAAE,OAAiB,EAAE,OAAiB;QAErD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,mBAAmB,EAAE;YAC7B,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,kDAAkD;IAC3C,aAAa,CAAC,KAAmC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChG,CAAC;IACD,qEAAqE;IAC9D,WAAW,CAAC,IAAU;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD;;;OAGG;IACI,MAAM;QACX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,QAAQ,CAAC,IAAU;QAC/B,MAAM,MAAM,GAAG,4BAA4B,CAAC,aAAa,EAAE,CAAC;QAC5D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,wCAAwC;IACjC,YAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,6CAA6C;IACtC,YAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD;;;;;OAKG;IACI,eAAe;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,yEAAyE;IAClE,oBAAoB;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACvC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,yDAAyD;IAClD,GAAG,CAAC,MAAe,EAAE,MAAgB;QAC1C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,oDAAoD;IAC7C,KAAK,CAAC,MAAqC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,4DAA4D;IACrD,gBAAgB,CAAC,SAAoB,EAAE,UAAmB,KAAK;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjE,IAAI,SAAS,CAAC,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;mBACrF,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE;gBACpC,OAAO,MAAM,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;mBACtF,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE;gBACpC,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,sCAAsC;IAC/B,OAAO,CAAC,MAAoC;QACjD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,uFAAuF;IAChF,QAAQ,CAAC,UAAmB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IACD,2GAA2G;IACpG,UAAU,CAAC,CAAS,EAAE,CAAS;QACpC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,sEAAsE;IAC/D,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,sEAAsE;IAC/D,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,sEAAsE;IAC/D,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,2CAA2C;IAC3B,aAAa,CAAC,MAAiB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,sCAAsC;IACtB,kBAAkB,CAAC,MAAgB;QACjD,4GAA4G;QAC5G,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,uGAAuG;IAChG,gBAAgB,CAAC,UAAmB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IACD,uDAAuD;IAChD,eAAe,CAAC,QAAgB,EAAE,MAAgB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IACD;;;OAGG;IACI,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD;;;OAGG;IACI,QAAQ,CAAC,WAAqB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IACD,yEAAyE;IAClE,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,2EAA2E;IACpE,YAAY,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,0DAA0D;IACnD,mBAAmB,CAAC,UAAmB,EAAE,MAAgB;QAC9D,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC;IACD,uDAAuD;IACvC,iBAAiB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,MAAgB;QACjF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACpH,CAAC;IACD;;;OAGG;IACa,cAAc,CAAC,UAAmB,EAAE,YAAoB,QAAQ,CAAC,mBAAmB;QAClG,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IACzC,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\nimport { AxisOrder, BeJSONFunctions, Geometry } from \"../Geometry\";\nimport { Plane3d } from \"./Plane3d\";\nimport { Point4d } from \"../geometry4d/Point4d\";\nimport { Angle } from \"./Angle\";\nimport { Matrix3d } from \"./Matrix3d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\nimport { Transform } from \"./Transform\";\nimport { XAndY } from \"./XYZProps\";\n\n/**\n * A plane defined by\n * * Any point on the plane.\n * * a unit normal.\n * @public\n */\nexport class Plane3dByOriginAndUnitNormal extends Plane3d implements BeJSONFunctions {\n  private _origin: Point3d;\n  private _normal: Vector3d;\n  // constructor captures references !!!\n  private constructor(origin: Point3d, normal: Vector3d) {\n    super();\n    this._origin = origin;\n    this._normal = normal;\n  }\n  // This is private because it does not check validity of the unit vector.\n  private static _create(x: number, y: number, z: number, u: number, v: number, w: number) {\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(x, y, z), Vector3d.create(u, v, w));\n  }\n  /**\n   * Create a plane parallel to the XY plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createXYPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 0, 1);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 0, 1);\n  }\n  /**\n   * Create a plane parallel to the YZ plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createYZPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 1, 0, 0);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 1, 0, 0);\n  }\n  /**\n   * Create a plane parallel to the ZX plane\n   * @param origin optional plane origin.  If omitted, the origin is placed at 000\n   */\n  public static createZXPlane(origin?: Point3d): Plane3dByOriginAndUnitNormal {\n    if (origin)\n      return Plane3dByOriginAndUnitNormal._create(origin.x, origin.y, origin.z, 0, 1, 0);\n    return Plane3dByOriginAndUnitNormal._create(0, 0, 0, 0, 1, 0);\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal with given origin and normal.\n   * * The inputs are NOT captured.\n   * * Returns undefined if `normal.normalize()` returns undefined.\n   */\n  public static create(\n    origin: Point3d, normal: Vector3d, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    if (result) {\n      if (normal.normalize(result._normal) === undefined)\n        return undefined;\n      origin.clone(result._origin);\n      return result;\n    }\n    const normalized = normal.normalize();\n    if (normalized === undefined)\n      return undefined;\n    return new Plane3dByOriginAndUnitNormal(origin.clone(), normalized);\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal from a variety of plane types.\n   * * The inputs are NOT captured.\n   * * Returns undefined if `source.getUnitNormal()` returns undefined.\n   */\n  public static createFrom(\n    source: Plane3d, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    if (source instanceof Plane3dByOriginAndUnitNormal)\n      return source.clone(result);\n    if (result) {\n      if (source.getUnitNormal(result._normal) === undefined)\n        return undefined;\n      source.getAnyPointOnPlane(result._origin);\n      return result;\n    }\n    const normal = source.getUnitNormal();\n    if (normal === undefined)\n      return undefined;\n    const origin = source.getAnyPointOnPlane();\n    return new Plane3dByOriginAndUnitNormal(origin, normal);\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with direct coordinates of origin and normal.\n   * * Returns undefined if the normal vector is all zeros.\n   * * If unable to normalize return undefined. (And if result is given it is left unchanged)\n   */\n  public static createXYZUVW(\n    ax: number, ay: number, az: number, ux: number, uy: number, uz: number, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const magU = Geometry.hypotenuseXYZ(ux, uy, uz);\n    if (magU < Geometry.smallMetricDistance)\n      return undefined;\n    if (result) {\n      result._origin.set(ax, ay, az);\n      result._normal.set(ux / magU, uy / magU, uz / magU);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(Point3d.create(ax, ay, az), Vector3d.create(ux / magU, uy / magU, uz / magU));\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with unit normal (a) in the xy plane (b) perpendicular to the line\n   * defined by xy parts of origin to target.\n   * * origin and normal both have z = 0.\n   * * The inputs are NOT captured.\n   * * Returns undefined if the normal vector is all zeros.\n   */\n  public static createOriginAndTargetXY(\n    origin: XAndY, target: XAndY, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const ux = target.x - origin.x;\n    const uy = target.y - origin.y;\n    return this.createXYZUVW(origin.x, origin.y, 0.0, uy, -ux, 0.0, result);\n  }\n  /**\n   * Create a new  Plane3dByOriginAndUnitNormal with xy origin (at z=0) and normal angle in xy plane.\n   * * Returns undefined if the normal vector is all zeros.\n   */\n  public static createXYAngle(\n    x: number, y: number, normalAngleFromX: Angle, result?: Plane3dByOriginAndUnitNormal,\n  ): Plane3dByOriginAndUnitNormal {\n    if (result) {\n      result._origin.set(x, y, 0.0);\n      result._normal.set(normalAngleFromX.cos(), normalAngleFromX.sin(), 0.0);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(\n      Point3d.create(x, y, 0), Vector3d.create(normalAngleFromX.cos(), normalAngleFromX.sin()),\n    );\n  }\n  /**\n   * Create a plane defined by two points and an in-plane vector.\n   * @param pointA any point in the plane\n   * @param pointB any other point in the plane\n   * @param vector any vector in the plane but not parallel to the vector from pointA to pointB\n   */\n  public static createPointPointVectorInPlane(\n    pointA: Point3d, pointB: Point3d, vector: Vector3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = vector.crossProductStartEnd(pointA, pointB);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /**\n   * Create a plane defined by three points.\n   * @param pointA any point in the plane.  This will be the origin.\n   * @param pointB any other point in the plane\n   * @param pointC any third point in the plane but not on the line of pointA and pointB\n   */\n  public static createOriginAndTargets(\n    pointA: Point3d, pointB: Point3d, pointC: Point3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = pointA.crossProductToPoints(pointB, pointC);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /**\n   * Create a plane defined by a point and two vectors in the plane\n   * @param pointA any point in the plane\n   * @param vectorB any vector in the plane\n   * @param vectorC any vector in the plane but not parallel to vectorB\n   */\n  public static createOriginAndVectors(\n    pointA: Point3d, vectorB: Vector3d, vectorC: Vector3d,\n  ): Plane3dByOriginAndUnitNormal | undefined {\n    const cross = vectorB.crossProduct(vectorC);\n    if (cross.tryNormalizeInPlace())\n      return new Plane3dByOriginAndUnitNormal(pointA, cross);\n    return undefined;\n  }\n  /** Test for (toleranced) equality with `other` */\n  public isAlmostEqual(other: Plane3dByOriginAndUnitNormal): boolean {\n    return this._origin.isAlmostEqual(other._origin) && this._normal.isAlmostEqual(other._normal);\n  }\n  /** Parse a json fragment `{origin: [x,y,z], normal: [ux,uy,uz]}`  */\n  public setFromJSON(json?: any): void {\n    if (!json) {\n      this._origin.set(0, 0, 0);\n      this._normal.set(0, 0, 1);\n    } else {\n      this._origin.setFromJSON(json.origin);\n      this._normal.setFromJSON(json.normal);\n    }\n  }\n  /**\n   * Convert to a JSON object.\n   * @return {*} [origin,normal]\n   */\n  public toJSON(): any {\n    return { origin: this._origin.toJSON(), normal: this._normal.toJSON() };\n  }\n  /**\n   * Create a new Plane3dByOriginAndUnitNormal from json fragment.\n   * * See `Plane3dByOriginAndUnitNormal.setFromJSON`\n   */\n  public static fromJSON(json?: any): Plane3dByOriginAndUnitNormal {\n    const result = Plane3dByOriginAndUnitNormal.createXYPlane();\n    result.setFromJSON(json);\n    return result;\n  }\n  /** Return a reference to the origin. */\n  public getOriginRef(): Point3d {\n    return this._origin;\n  }\n  /** Return a reference to the unit normal. */\n  public getNormalRef(): Vector3d {\n    return this._normal;\n  }\n  /**\n   * Return coordinate axes (as a transform) with\n   * * origin at plane origin\n   * * z axis in direction of plane normal.\n   * * x,y axes in plane.\n   */\n  public getLocalToWorld(): Transform {\n    const axes = Matrix3d.createRigidHeadsUp(this._normal, AxisOrder.ZXY);\n    return Transform.createRefs(this._origin.clone(), axes);\n  }\n  /** Return a (singular) transform which projects points to this plane. */\n  public getProjectionToPlane(): Transform {\n    const axes = Matrix3d.createIdentity();\n    axes.addScaledOuterProductInPlace(this._normal, this._normal, -1.0);\n    axes.markSingular();\n    return Transform.createFixedPointAndMatrix(this._origin, axes);\n  }\n  /** Copy coordinates from the given origin and normal. */\n  public set(origin: Point3d, normal: Vector3d): void {\n    this._origin.setFrom(origin);\n    this._normal.setFrom(normal);\n  }\n  /** Return a deep clone (point and normal cloned) */\n  public clone(result?: Plane3dByOriginAndUnitNormal): Plane3dByOriginAndUnitNormal {\n    if (result) {\n      result.set(this._origin, this._normal);\n      return result;\n    }\n    return new Plane3dByOriginAndUnitNormal(this._origin.clone(), this._normal.clone());\n  }\n  /** Create a clone and return the transform of the clone. */\n  public cloneTransformed(transform: Transform, inverse: boolean = false): Plane3dByOriginAndUnitNormal | undefined {\n    const result = this.clone();\n    if (inverse) {\n      transform.multiplyInversePoint3d(result._origin, result._origin);\n      if (transform.matrix.multiplyTransposeVector(result._normal, result._normal) !== undefined\n        && result._normal.normalizeInPlace())\n        return result;\n    } else {\n      transform.multiplyPoint3d(result._origin, result._origin);\n      if (transform.matrix.multiplyInverseTranspose(result._normal, result._normal) !== undefined\n        && result._normal.normalizeInPlace())\n        return result;\n    }\n    return undefined;\n  }\n  /** Copy data from the given plane. */\n  public setFrom(source: Plane3dByOriginAndUnitNormal): void {\n    this.set(source._origin, source._normal);\n  }\n  /** Return the altitude of spacePoint above or below the plane.  (Below is negative) */\n  public altitude(spacePoint: Point3d): number {\n    return this._normal.dotProductStartEnd(this._origin, spacePoint);\n  }\n  /** Return the altitude of point (x,y)  given xy parts using only the xy parts of origin and unit normal */\n  public altitudeXY(x: number, y: number): number {\n    return (x - this._origin.x) * this._normal.x + (y - this._origin.y) * this._normal.y;\n  }\n  /** Return the x component of the normal used to evaluate altitude. */\n  public normalX(): number {\n    return this._normal.x;\n  }\n  /** Return the x component of the normal used to evaluate altitude. */\n  public normalY(): number {\n    return this._normal.y;\n  }\n  /** Return the z component of the normal used to evaluate altitude. */\n  public normalZ(): number {\n    return this._normal.z;\n  }\n  /** Return (a clone of) the unit normal. */\n  public override getUnitNormal(result?: Vector3d): Vector3d | undefined {\n    return this._normal.clone(result);\n  }\n  /** Return (a clone of) the origin. */\n  public override getAnyPointOnPlane(result?: Point3d): Point3d {\n    // This function returns the plane origin. In general, a point x is on the plane if and only if (x-o).n = 0.\n    return this._origin.clone(result);\n  }\n  /** Return the signed altitude of weighted spacePoint above or below the plane.  (Below is negative) */\n  public weightedAltitude(spacePoint: Point4d): number {\n    return this._normal.dotProductStart3dEnd4d(this._origin, spacePoint);\n  }\n  /** Return any point at specified (signed) altitude. */\n  public altitudeToPoint(altitude: number, result?: Point3d): Point3d {\n    return this._origin.plusScaled(this._normal, altitude, result);\n  }\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal. This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   */\n  public velocityXYZ(x: number, y: number, z: number): number {\n    return this._normal.dotProductXYZ(x, y, z);\n  }\n  /**\n   * Return the dot product of spaceVector with the plane's unit normal.  This tells the rate of change of altitude\n   * for a point moving at speed one along the spaceVector.\n   */\n  public velocity(spaceVector: Vector3d): number {\n    return this._normal.dotProduct(spaceVector);\n  }\n  /** Return the altitude of a point given as separate x,y,z components. */\n  public altitudeXYZ(x: number, y: number, z: number): number {\n    return this._normal.dotProductStartEndXYZ(this._origin, x, y, z);\n  }\n  /** Return the altitude of a point given as separate x,y,z,w components. */\n  public altitudeXYZW(x: number, y: number, z: number, w: number): number {\n    return this._normal.dotProductStartEndXYZW(this._origin, x, y, z, w);\n  }\n  /** Return the projection of spacePoint onto the plane. */\n  public projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d {\n    return this.projectXYZToPlane(spacePoint.x, spacePoint.y, spacePoint.z, result);\n  }\n  /** Return the projection of (x,y,z) onto the plane. */\n  public override projectXYZToPlane(x: number, y: number, z: number, result?: Point3d): Point3d {\n    const scale = -this._normal.dotProductStartEndXYZ(this._origin, x, y, z);\n    return Point3d.create(x + scale * this._normal.x, y + scale * this._normal.y, z + scale * this._normal.z, result);\n  }\n  /**\n   * Returns true if spacePoint is within distance tolerance of the plane.\n   * * This logic is identical to the [[Plane3d]] method but avoids a level of function call.\n   */\n  public override isPointInPlane(spacePoint: Point3d, tolerance: number = Geometry.smallMetricDistance): boolean {\n    const altitude = this._normal.dotProductStartEnd(this._origin, spacePoint);\n    return Math.abs(altitude) <= tolerance;\n  }\n}\n"]}

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

@@ -169,9 +169,15 @@ export declare class Plane3dByOriginAndVectors extends Plane3d implements BeJSON
     weightedAltitude(xyzw: Point4d): number;
     /**
      * Return the projection of spacePoint onto the plane.
-     * If the plane is degenerate to a ray, project to the ray.
-     * If the plane is degenerate to its origin, return the point
+     * * If the plane is degenerate to a ray, project to the ray.
+     * * If the plane is degenerate to its origin, return the point.
      */
     projectPointToPlane(spacePoint: Point3d, result?: Point3d): Point3d;
+    /**
+     * Return the projection of (x,y,z) onto the plane.
+     * * If the plane is degenerate to a ray, project to the ray.
+     * * If the plane is degenerate to its origin, return the point.
+     */
+    projectXYZToPlane(x: number, y: number, z: number, result?: Point3d): Point3d;
 }
 //# sourceMappingURL=Plane3dByOriginAndVectors.d.ts.map

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

@@ -349,30 +349,38 @@ export class Plane3dByOriginAndVectors extends Plane3d {
     }
     /**
      * Return the projection of spacePoint onto the plane.
-     * If the plane is degenerate to a ray, project to the ray.
-     * If the plane is degenerate to its origin, return the point
+     * * If the plane is degenerate to a ray, project to the ray.
+     * * If the plane is degenerate to its origin, return the point.
      */
     projectPointToPlane(spacePoint, result) {
+        return this.projectXYZToPlane(spacePoint.x, spacePoint.y, spacePoint.z, result);
+    }
+    /**
+     * Return the projection of (x,y,z) onto the plane.
+     * * If the plane is degenerate to a ray, project to the ray.
+     * * If the plane is degenerate to its origin, return the point.
+     */
+    projectXYZToPlane(x, y, z, result) {
         const unitNormal = this.vectorU.unitCrossProduct(this.vectorV);
         if (unitNormal !== undefined) {
-            const w = unitNormal.dotProductStartEnd(this.origin, spacePoint);
-            return spacePoint.plusScaled(unitNormal, -w, result);
+            const scale = -unitNormal.dotProductStartEndXYZ(this.origin, x, y, z);
+            return Point3d.create(x + scale * unitNormal.x, y + scale * unitNormal.y, z + scale * unitNormal.z, result);
         }
-        // uh oh.   vectorU and vectorV are colinear or zero.
-        // project to ray defined by the longer one, or just to origin.
+        // vectorU and vectorV are colinear or zero.
+        // Project to ray defined by the longer one, or just to origin.
         const dotUU = this.vectorU.magnitudeSquared();
         const dotVV = this.vectorV.magnitudeSquared();
         if (dotUU >= dotVV) {
-            const dotUW = this.vectorU.dotProductStartEnd(this.origin, spacePoint);
+            const dotUW = this.vectorU.dotProductStartEndXYZ(this.origin, x, y, z);
             const f = Geometry.conditionalDivideCoordinate(dotUW, dotUU, 0.0);
             if (f !== undefined)
-                return spacePoint.plusScaled(this.vectorU, f, result);
+                return Point3d.create(x + f * this.vectorU.x, y + f * this.vectorU.y, z + f * this.vectorU.z, result);
         }
         else {
-            const dotVW = this.vectorV.dotProductStartEnd(this.origin, spacePoint);
+            const dotVW = this.vectorV.dotProductStartEndXYZ(this.origin, x, y, z);
             const f = Geometry.conditionalDivideCoordinate(dotVW, dotVV, 0.0);
             if (f !== undefined)
-                return spacePoint.plusScaled(this.vectorV, f, result);
+                return Point3d.create(x + f * this.vectorV.x, y + f * this.vectorV.y, z + f * this.vectorV.z, result);
         }
         return this.origin.clone(result);
     }