@itwin/core-geometry 3.0.0-dev.76 → 3.0.0-dev.80

package/lib/esm/solid/Box.js

@@ -0,0 +1,229 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { LineString3d } from "../curve/LineString3d";
+import { Loop } from "../curve/Loop";
+import { Geometry } from "../Geometry";
+import { Point3d, Vector3d } from "../geometry3d/Point3dVector3d";
+import { Transform } from "../geometry3d/Transform";
+import { SolidPrimitive } from "./SolidPrimitive";
+/**
+ * A box-like solid defined by
+ * * A local coordinate frame
+ *   * (0,0,0) is left lower rear corner of box (considering "left" to reference x, "lower" to reference y, "rear and front" to reference z=0 and z=1)
+ *   * (0,0,1) is left lower front corner.
+ *   * (baseX,baseY,z) is right upper corner at z
+ *   * note that the frame x and y columns are usually unit vectors in local space, but z is full rear to front vector
+ * * The separate values for base and top x and y allow the box to be a "view frustum" with parallel back and front planes but independent x and y bellows effects.
+ * @public
+ */
+export class Box extends SolidPrimitive {
+    constructor(map, baseX, baseY, topX, topY, capped) {
+        super(capped);
+        /** String name for schema properties */
+        this.solidPrimitiveType = "box";
+        this._localToWorld = map;
+        this._baseX = baseX;
+        this._baseY = baseY;
+        this._topX = topX;
+        this._topY = topY;
+    }
+    /** Return a clone */
+    clone() {
+        return new Box(this._localToWorld.clone(), this._baseX, this._baseY, this._topX, this._topY, this.capped);
+    }
+    /** Return a coordinate frame (right handed unit vectors)
+     * * origin lower left of box
+     * * x direction on base rectangle x edge
+     * * y direction in base rectangle
+     * * z direction perpendicular
+     */
+    getConstructiveFrame() {
+        return this._localToWorld.cloneRigid();
+    }
+    /** Apply the transform to the box's `localToWorld` frame.
+     * * Note that this may make the frame nonrigid.
+     */
+    tryTransformInPlace(transform) {
+        if (transform.matrix.isSingular())
+            return false;
+        transform.multiplyTransformTransform(this._localToWorld, this._localToWorld);
+        return true;
+    }
+    /** Clone the box and immediately apply `transform` to the local frame of the clone. */
+    cloneTransformed(transform) {
+        const result = this.clone();
+        transform.multiplyTransformTransform(result._localToWorld, result._localToWorld);
+        return result;
+    }
+    /**
+     * Create a new box from vector and size daa.
+     * @param baseOrigin Origin of base rectangle
+     * @param vectorX  Direction for base rectangle
+     * @param vectorY Direction for base rectangle
+     * @param topOrigin origin of top rectangle
+     * @param baseX size factor for base rectangle (multiplies vectorX)
+     * @param baseY size factor for base rectangle (multiplies vectorY)
+     * @param topX size factor for top rectangle (multiplies vectorX)
+     * @param topY size factor for top rectangle (multiplies vectorY)
+     * @param capped true to define top and bottom closure caps
+     */
+    static createDgnBox(baseOrigin, vectorX, vectorY, topOrigin, baseX, baseY, topX, topY, capped) {
+        const vectorZ = baseOrigin.vectorTo(topOrigin);
+        const localToWorld = Transform.createOriginAndMatrixColumns(baseOrigin, vectorX, vectorY, vectorZ);
+        return new Box(localToWorld, baseX, baseY, topX, topY, capped);
+    }
+    /**
+     * Create a new box with xy directions taken from columns of the `axes` matrix.
+     * @param baseOrigin Origin of base rectangle
+     * @param axes  Direction for base rectangle
+     * @param topOrigin origin of top rectangle
+     * @param baseX size factor for base rectangle (multiplies vectorX)
+     * @param baseY size factor for base rectangle (multiplies vectorY)
+     * @param topX size factor for top rectangle (multiplies vectorX)
+     * @param topY size factor for top rectangle (multiplies vectorY)
+     * @param capped true to define top and bottom closure caps
+     */
+    static createDgnBoxWithAxes(baseOrigin, axes, topOrigin, baseX, baseY, topX, topY, capped) {
+        return Box.createDgnBox(baseOrigin, axes.columnX(), axes.columnY(), topOrigin, baseX, baseY, topX, topY, capped);
+    }
+    /**
+     * Create an axis-aligned `Box` primitive for a range.
+     * @param range range corners Origin of base rectangle
+     * @param capped true to define top and bottom closure caps
+     */
+    static createRange(range, capped) {
+        if (!range.isNull) {
+            const lowPoint = range.low;
+            const xSize = range.xLength();
+            const ySize = range.yLength();
+            const zPoint = range.low.clone();
+            zPoint.z = zPoint.z + range.zLength();
+            return Box.createDgnBox(lowPoint, Vector3d.unitX(), Vector3d.unitY(), zPoint, xSize, ySize, xSize, ySize, capped);
+        }
+        return undefined;
+    }
+    /** (property accessor) return the x length at z = 0 */
+    getBaseX() { return this._baseX; }
+    /** (property accessor) return the y length at z = 0 */
+    getBaseY() { return this._baseY; }
+    /** (property accessor) return the x length at z = 1 */
+    getTopX() { return this._topX; }
+    /** (property accessor) return the x length at z = 1 */
+    getTopY() { return this._topY; }
+    /** (property accessor) return the local coordinates point (0,0,0) to world */
+    getBaseOrigin() { return this._localToWorld.multiplyXYZ(0, 0, 0); }
+    /** (property accessor) return the local coordinates point (0,0,1) to world */
+    getTopOrigin() { return this._localToWorld.multiplyXYZ(0, 0, 1); }
+    /** (property accessor) return the local coordinate frame x vector */
+    getVectorX() { return this._localToWorld.matrix.columnX(); }
+    /** (property accessor) return the local coordinate frame y vector */
+    getVectorY() { return this._localToWorld.matrix.columnY(); }
+    /** (property accessor) return the local coordinate frame z vector */
+    getVectorZ() { return this._localToWorld.matrix.columnZ(); }
+    /** Test of `other` is also of class `Box` */
+    isSameGeometryClass(other) { return other instanceof Box; }
+    /** test for near equality */
+    isAlmostEqual(other) {
+        if (other instanceof Box) {
+            if (this.capped !== other.capped)
+                return false;
+            if (!this._localToWorld.isAlmostEqual(other._localToWorld))
+                return false;
+            return Geometry.isSameCoordinate(this._baseX, other._baseX)
+                && Geometry.isSameCoordinate(this._baseY, other._baseY)
+                && Geometry.isSameCoordinate(this._topX, other._topX)
+                && Geometry.isSameCoordinate(this._topY, other._topY);
+        }
+        return false;
+    }
+    /** Second step of double dispatch:  call `handler.handleBox(this)` */
+    dispatchToGeometryHandler(handler) {
+        return handler.handleBox(this);
+    }
+    /** Return strokes of the cross-section rectangle at local z coordinate */
+    strokeConstantVSection(zFraction) {
+        const ax = Geometry.interpolate(this._baseX, zFraction, this._topX);
+        const ay = Geometry.interpolate(this._baseY, zFraction, this._topY);
+        const result = LineString3d.create();
+        const transform = this._localToWorld;
+        const workPoint = Point3d.create();
+        transform.multiplyXYZ(0, 0, zFraction, workPoint);
+        result.addPoint(workPoint);
+        transform.multiplyXYZ(ax, 0, zFraction, workPoint);
+        result.addPoint(workPoint);
+        transform.multiplyXYZ(ax, ay, zFraction, workPoint);
+        result.addPoint(workPoint);
+        transform.multiplyXYZ(0, ay, zFraction, workPoint);
+        result.addPoint(workPoint);
+        transform.multiplyXYZ(0, 0, zFraction, workPoint);
+        result.addPoint(workPoint);
+        return result;
+    }
+    /**
+     * Returns the 8 corners in x fastest, then y, finally z lexical order.
+     */
+    getCorners() {
+        const transform = this._localToWorld;
+        const ax = this._baseX;
+        const ay = this._baseY;
+        const bx = this._topX;
+        const by = this._topY;
+        return [
+            transform.multiplyXYZ(0, 0, 0),
+            transform.multiplyXYZ(ax, 0, 0),
+            transform.multiplyXYZ(0, ay, 0),
+            transform.multiplyXYZ(ax, ay, 0),
+            transform.multiplyXYZ(0, 0, 1),
+            transform.multiplyXYZ(bx, 0, 1),
+            transform.multiplyXYZ(0, by, 1),
+            transform.multiplyXYZ(bx, by, 1),
+        ];
+    }
+    /**
+     * Consider the box sides (not top and bottom) as a (u,v) surface with
+     * * v = 0 as the z=0 local plane
+     * * v = 1 as the z=1 local plane
+     * Return the (rectangular) section at fractional v
+     */
+    constantVSection(zFraction) {
+        const ls = this.strokeConstantVSection(zFraction);
+        return Loop.create(ls);
+    }
+    /** Extend  `rangeToExtend` by each of the 8 corners */
+    extendRange(rangeToExtend, transform) {
+        const boxTransform = this._localToWorld;
+        const ax = this._baseX;
+        const ay = this._baseY;
+        const bx = this._topX;
+        const by = this._topY;
+        if (transform) {
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, 0, 0);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, ax, 0, 0);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, ay, 0);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, ax, ay, 0);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, 0, 1);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, bx, 0, 1);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, by, 1);
+            rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, bx, by, 1);
+        }
+        else {
+            rangeToExtend.extendTransformedXYZ(boxTransform, 0, 0, 0);
+            rangeToExtend.extendTransformedXYZ(boxTransform, ax, 0, 0);
+            rangeToExtend.extendTransformedXYZ(boxTransform, 0, ay, 0);
+            rangeToExtend.extendTransformedXYZ(boxTransform, ax, ay, 0);
+            rangeToExtend.extendTransformedXYZ(boxTransform, 0, 0, 1);
+            rangeToExtend.extendTransformedXYZ(boxTransform, bx, 0, 1);
+            rangeToExtend.extendTransformedXYZ(boxTransform, 0, by, 1);
+            rangeToExtend.extendTransformedXYZ(boxTransform, bx, by, 1);
+        }
+    }
+    /**
+     * @return true if this is a closed volume.
+     */
+    get isClosedVolume() {
+        return this.capped;
+    }
+}
+//# sourceMappingURL=Box.js.map

package/lib/esm/solid/Box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Box.js","sourceRoot":"","sources":["../../../src/solid/Box.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Solid\r\n */\r\n\r\nimport { CurveCollection } from \"../curve/CurveCollection\";\r\nimport { GeometryQuery } from \"../curve/GeometryQuery\";\r\nimport { LineString3d } from \"../curve/LineString3d\";\r\nimport { Loop } from \"../curve/Loop\";\r\nimport { Geometry } from \"../Geometry\";\r\nimport { GeometryHandler } from \"../geometry3d/GeometryHandler\";\r\nimport { Matrix3d } from \"../geometry3d/Matrix3d\";\r\nimport { Point3d, Vector3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { Range3d } from \"../geometry3d/Range\";\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { SolidPrimitive } from \"./SolidPrimitive\";\r\n\r\n/**\r\n * A box-like solid defined by\r\n * * A local coordinate frame\r\n *   * (0,0,0) is left lower rear corner of box (considering \"left\" to reference x, \"lower\" to reference y, \"rear and front\" to reference z=0 and z=1)\r\n *   * (0,0,1) is left lower front corner.\r\n *   * (baseX,baseY,z) is right upper corner at z\r\n *   * note that the frame x and y columns are usually unit vectors in local space, but z is full rear to front vector\r\n * * The separate values for base and top x and y allow the box to be a \"view frustum\" with parallel back and front planes but independent x and y bellows effects.\r\n * @public\r\n */\r\nexport class Box extends SolidPrimitive {\r\n  /** String name for schema properties */\r\n  public readonly solidPrimitiveType = \"box\";\r\n\r\n  private _localToWorld: Transform;\r\n  private _baseX: number;\r\n  private _baseY: number;\r\n  private _topX: number;\r\n  private _topY: number;\r\n\r\n  protected constructor(map: Transform,\r\n    baseX: number, baseY: number, topX: number, topY: number, capped: boolean) {\r\n    super(capped);\r\n    this._localToWorld = map;\r\n    this._baseX = baseX;\r\n    this._baseY = baseY;\r\n    this._topX = topX;\r\n    this._topY = topY;\r\n  }\r\n  /** Return a clone */\r\n  public clone(): Box {\r\n    return new Box(this._localToWorld.clone(), this._baseX, this._baseY, this._topX, this._topY, this.capped);\r\n  }\r\n\r\n  /** Return a coordinate frame (right handed unit vectors)\r\n   * * origin lower left of box\r\n   * * x direction on base rectangle x edge\r\n   * * y direction in base rectangle\r\n   * * z direction perpendicular\r\n   */\r\n  public getConstructiveFrame(): Transform | undefined {\r\n    return this._localToWorld.cloneRigid();\r\n  }\r\n  /** Apply the transform to the box's `localToWorld` frame.\r\n   * * Note that this may make the frame nonrigid.\r\n   */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    if (transform.matrix.isSingular())\r\n      return false;\r\n    transform.multiplyTransformTransform(this._localToWorld, this._localToWorld);\r\n    return true;\r\n  }\r\n  /** Clone the box and immediately apply `transform` to the local frame of the clone. */\r\n  public cloneTransformed(transform: Transform): Box | undefined {\r\n    const result = this.clone();\r\n    transform.multiplyTransformTransform(result._localToWorld, result._localToWorld);\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Create a new box from vector and size daa.\r\n   * @param baseOrigin Origin of base rectangle\r\n   * @param vectorX  Direction for base rectangle\r\n   * @param vectorY Direction for base rectangle\r\n   * @param topOrigin origin of top rectangle\r\n   * @param baseX size factor for base rectangle (multiplies vectorX)\r\n   * @param baseY size factor for base rectangle (multiplies vectorY)\r\n   * @param topX size factor for top rectangle (multiplies vectorX)\r\n   * @param topY size factor for top rectangle (multiplies vectorY)\r\n   * @param capped true to define top and bottom closure caps\r\n   */\r\n  public static createDgnBox(baseOrigin: Point3d, vectorX: Vector3d, vectorY: Vector3d,\r\n    topOrigin: Point3d,\r\n    baseX: number, baseY: number, topX: number, topY: number,\r\n    capped: boolean): Box | undefined {\r\n    const vectorZ = baseOrigin.vectorTo(topOrigin);\r\n    const localToWorld = Transform.createOriginAndMatrixColumns(baseOrigin, vectorX, vectorY, vectorZ);\r\n    return new Box(localToWorld, baseX, baseY, topX, topY, capped);\r\n  }\r\n\r\n  /**\r\n   * Create a new box with xy directions taken from columns of the `axes` matrix.\r\n   * @param baseOrigin Origin of base rectangle\r\n   * @param axes  Direction for base rectangle\r\n   * @param topOrigin origin of top rectangle\r\n   * @param baseX size factor for base rectangle (multiplies vectorX)\r\n   * @param baseY size factor for base rectangle (multiplies vectorY)\r\n   * @param topX size factor for top rectangle (multiplies vectorX)\r\n   * @param topY size factor for top rectangle (multiplies vectorY)\r\n   * @param capped true to define top and bottom closure caps\r\n   */\r\n  public static createDgnBoxWithAxes(baseOrigin: Point3d, axes: Matrix3d,\r\n    topOrigin: Point3d,\r\n    baseX: number, baseY: number, topX: number, topY: number,\r\n    capped: boolean): Box | undefined {\r\n    return Box.createDgnBox(baseOrigin, axes.columnX(), axes.columnY(), topOrigin,\r\n      baseX, baseY, topX, topY, capped);\r\n  }\r\n\r\n  /**\r\n   * Create an axis-aligned `Box` primitive for a range.\r\n   * @param range range corners Origin of base rectangle\r\n   * @param capped true to define top and bottom closure caps\r\n   */\r\n  public static createRange(range: Range3d, capped: boolean): Box | undefined {\r\n    if (!range.isNull) {\r\n      const lowPoint = range.low;\r\n      const xSize = range.xLength();\r\n      const ySize = range.yLength();\r\n      const zPoint = range.low.clone();\r\n      zPoint.z = zPoint.z + range.zLength();\r\n      return Box.createDgnBox(\r\n        lowPoint,\r\n        Vector3d.unitX(), Vector3d.unitY(),\r\n        zPoint,\r\n        xSize, ySize, xSize, ySize, capped);\r\n    }\r\n    return undefined;\r\n  }\r\n  /** (property accessor) return the x length at z = 0 */\r\n  public getBaseX(): number { return this._baseX; }\r\n  /** (property accessor) return the y length at z = 0 */\r\n  public getBaseY(): number { return this._baseY; }\r\n  /** (property accessor) return the x length at z = 1 */\r\n  public getTopX(): number { return this._topX; }\r\n  /** (property accessor) return the x length at z = 1 */\r\n  public getTopY(): number { return this._topY; }\r\n  /** (property accessor) return the local coordinates point (0,0,0) to world */\r\n  public getBaseOrigin(): Point3d { return this._localToWorld.multiplyXYZ(0, 0, 0); }\r\n  /** (property accessor) return the local coordinates point (0,0,1) to world */\r\n  public getTopOrigin(): Point3d { return this._localToWorld.multiplyXYZ(0, 0, 1); }\r\n  /** (property accessor) return the local coordinate frame x vector */\r\n  public getVectorX(): Vector3d { return this._localToWorld.matrix.columnX(); }\r\n  /** (property accessor) return the local coordinate frame y vector */\r\n  public getVectorY(): Vector3d { return this._localToWorld.matrix.columnY(); }\r\n  /** (property accessor) return the local coordinate frame z vector */\r\n  public getVectorZ(): Vector3d { return this._localToWorld.matrix.columnZ(); }\r\n  /** Test of `other` is also of class `Box` */\r\n  public isSameGeometryClass(other: any): boolean { return other instanceof Box; }\r\n  /** test for near equality */\r\n  public override isAlmostEqual(other: GeometryQuery): boolean {\r\n    if (other instanceof Box) {\r\n      if (this.capped !== other.capped) return false;\r\n      if (!this._localToWorld.isAlmostEqual(other._localToWorld)) return false;\r\n      return Geometry.isSameCoordinate(this._baseX, other._baseX)\r\n        && Geometry.isSameCoordinate(this._baseY, other._baseY)\r\n        && Geometry.isSameCoordinate(this._topX, other._topX)\r\n        && Geometry.isSameCoordinate(this._topY, other._topY);\r\n    }\r\n    return false;\r\n  }\r\n  /** Second step of double dispatch:  call `handler.handleBox(this)` */\r\n  public dispatchToGeometryHandler(handler: GeometryHandler): any {\r\n    return handler.handleBox(this);\r\n  }\r\n  /** Return strokes of the cross-section rectangle at local z coordinate */\r\n  public strokeConstantVSection(zFraction: number): LineString3d {\r\n    const ax = Geometry.interpolate(this._baseX, zFraction, this._topX);\r\n    const ay = Geometry.interpolate(this._baseY, zFraction, this._topY);\r\n    const result = LineString3d.create();\r\n    const transform = this._localToWorld;\r\n    const workPoint = Point3d.create();\r\n    transform.multiplyXYZ(0, 0, zFraction, workPoint);\r\n    result.addPoint(workPoint);\r\n    transform.multiplyXYZ(ax, 0, zFraction, workPoint);\r\n    result.addPoint(workPoint);\r\n    transform.multiplyXYZ(ax, ay, zFraction, workPoint);\r\n    result.addPoint(workPoint);\r\n    transform.multiplyXYZ(0, ay, zFraction, workPoint);\r\n    result.addPoint(workPoint);\r\n    transform.multiplyXYZ(0, 0, zFraction, workPoint);\r\n    result.addPoint(workPoint);\r\n    return result;\r\n  }\r\n  /**\r\n   * Returns the 8 corners in x fastest, then y, finally z lexical order.\r\n   */\r\n  public getCorners(): Point3d[] {\r\n    const transform = this._localToWorld;\r\n    const ax = this._baseX;\r\n    const ay = this._baseY;\r\n    const bx = this._topX;\r\n    const by = this._topY;\r\n    return [\r\n      transform.multiplyXYZ(0, 0, 0),\r\n      transform.multiplyXYZ(ax, 0, 0),\r\n      transform.multiplyXYZ(0, ay, 0),\r\n      transform.multiplyXYZ(ax, ay, 0),\r\n      transform.multiplyXYZ(0, 0, 1),\r\n      transform.multiplyXYZ(bx, 0, 1),\r\n      transform.multiplyXYZ(0, by, 1),\r\n      transform.multiplyXYZ(bx, by, 1),\r\n    ];\r\n  }\r\n\r\n  /**\r\n   * Consider the box sides (not top and bottom) as a (u,v) surface with\r\n   * * v = 0 as the z=0 local plane\r\n   * * v = 1 as the z=1 local plane\r\n   * Return the (rectangular) section at fractional v\r\n   */\r\n  public constantVSection(zFraction: number): CurveCollection {\r\n    const ls = this.strokeConstantVSection(zFraction);\r\n    return Loop.create(ls);\r\n  }\r\n  /** Extend  `rangeToExtend` by each of the 8 corners */\r\n  public extendRange(rangeToExtend: Range3d, transform?: Transform): void {\r\n    const boxTransform = this._localToWorld;\r\n    const ax = this._baseX;\r\n    const ay = this._baseY;\r\n    const bx = this._topX;\r\n    const by = this._topY;\r\n    if (transform) {\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, 0, 0);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, ax, 0, 0);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, ay, 0);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, ax, ay, 0);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, 0, 1);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, bx, 0, 1);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, 0, by, 1);\r\n      rangeToExtend.extendTransformTransformedXYZ(transform, boxTransform, bx, by, 1);\r\n    } else {\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, 0, 0, 0);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, ax, 0, 0);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, 0, ay, 0);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, ax, ay, 0);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, 0, 0, 1);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, bx, 0, 1);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, 0, by, 1);\r\n      rangeToExtend.extendTransformedXYZ(boxTransform, bx, by, 1);\r\n    }\r\n  }\r\n  /**\r\n   * @return true if this is a closed volume.\r\n   */\r\n  public get isClosedVolume(): boolean {\r\n    return this.capped;\r\n  }\r\n}\r\n"]}

package/lib/esm/solid/Cone.d.ts

@@ -0,0 +1,119 @@
+import { CurveCollection } from "../curve/CurveCollection";
+import { GeometryQuery } from "../curve/GeometryQuery";
+import { LineString3d } from "../curve/LineString3d";
+import { StrokeOptions } from "../curve/StrokeOptions";
+import { GeometryHandler, UVSurface, UVSurfaceIsoParametricDistance } from "../geometry3d/GeometryHandler";
+import { Plane3dByOriginAndVectors } from "../geometry3d/Plane3dByOriginAndVectors";
+import { Vector2d } from "../geometry3d/Point2dVector2d";
+import { Point3d, Vector3d } from "../geometry3d/Point3dVector3d";
+import { Range3d } from "../geometry3d/Range";
+import { Transform } from "../geometry3d/Transform";
+import { SolidPrimitive } from "./SolidPrimitive";
+/**
+ * A cone with axis along the z axis of a (possibly skewed) local coordinate system.
+ *
+ * * In local coordinates, the sections at z=0 and z=1 are circles of radius r0 and r1.
+ * * Either one individually  may be zero, but they may not both be zero.
+ * * The stored matrix has unit vectors in the xy columns, and full-length z column.
+ * @public
+ */
+export declare class Cone extends SolidPrimitive implements UVSurface, UVSurfaceIsoParametricDistance {
+    /** String name for schema properties */
+    readonly solidPrimitiveType = "cone";
+    private _localToWorld;
+    private _radiusA;
+    private _radiusB;
+    private _maxRadius;
+    protected constructor(map: Transform, radiusA: number, radiusB: number, capped: boolean);
+    /** Return a clone of this Cone. */
+    clone(): Cone;
+    /** Return a coordinate frame (right handed unit vectors)
+     * * origin at center of the base circle.
+     * * base circle in the xy plane
+     * * z axis by right hand rule.
+     */
+    getConstructiveFrame(): Transform | undefined;
+    /** Apply the transform to this cone's locla to world coordinates.
+     * * Note that the radii are not changed.  Scaling is absorbed into the frame.
+     * * This fails if the transformation is singular.
+     */
+    tryTransformInPlace(transform: Transform): boolean;
+    /**
+     * Create a clone and immediately transform the clone.
+     */
+    cloneTransformed(transform: Transform): Cone | undefined;
+    /** create a cylinder or cone from two endpoints and their radii.   The circular cross sections are perpendicular to the axis line
+     * from start to end point.
+     * * both radii must be of the same sign.
+     * * negative radius is accepted to create interior surface.    Downstream effects of that combined with capping may be a problem.
+     */
+    static createAxisPoints(centerA: Point3d, centerB: Point3d, radiusA: number, radiusB: number, capped: boolean): Cone | undefined;
+    /** create a cylinder or cone from axis start and end with cross section defined by vectors that do not need to be perpendicular to each other or
+     * to the axis.
+     */
+    static createBaseAndTarget(centerA: Point3d, centerB: Point3d, vectorX: Vector3d, vectorY: Vector3d, radiusA: number, radiusB: number, capped: boolean): Cone;
+    /** (Property accessor) Return the center point at the base plane */
+    getCenterA(): Point3d;
+    /** (Property accessor) */
+    getCenterB(): Point3d;
+    /** (Property accessor) Return the x vector in the local frame */
+    getVectorX(): Vector3d;
+    /** (Property accessor) Return the y vector in the local frame */
+    getVectorY(): Vector3d;
+    /** (Property accessor) return the radius at the base plane */
+    getRadiusA(): number;
+    /** (Property accessor) return the radius at the top plane */
+    getRadiusB(): number;
+    /** (Property accessor) return the larger of the base and top plane radii */
+    getMaxRadius(): number;
+    /** (Property accessor) return the radius at fraction `v` along the axis */
+    vFractionToRadius(v: number): number;
+    /** (Property accessor) test if `other` is an instance of `Cone` */
+    isSameGeometryClass(other: any): boolean;
+    /** (Property accessor) Test for nearly equal coordinate data. */
+    isAlmostEqual(other: GeometryQuery): boolean;
+    /** Second step of double dispatch:   call `handler.handleCone(this)` */
+    dispatchToGeometryHandler(handler: GeometryHandler): any;
+    /**
+     *  return strokes for a cross-section (elliptic arc) at specified fraction v along the axis.
+     * * fixedStrokeCount takes priority over stroke options.
+     * * The linestring is created by LineString3d.createForStrokes (fixedStrokeCount, options), which sets up property according to the options:
+     *   * optional fractions member
+     *   * optional uvParams.  uvParams are installed as full-scale distance parameters.
+     *   * optional derivatives.
+     * @param v fractional position along the cone axis
+     * @param fixedStrokeCount optional stroke count.
+     * @param options optional stroke options.
+     */
+    strokeConstantVSection(v: number, fixedStrokeCount: number | undefined, options: StrokeOptions | undefined): LineString3d;
+    /**
+     * Return the Arc3d section at vFraction
+     * @param vFraction fractional position along the sweep direction
+     */
+    constantVSection(vFraction: number): CurveCollection | undefined;
+    /** Extend `rangeToExtend` so it includes this `Cone` instance. */
+    extendRange(rangeToExtend: Range3d, transform?: Transform): void;
+    /** Evaluate a point on the Cone surfaces, with
+     * * v = 0 is the base plane.
+     * * v = 1 is the top plane
+     * * u = 0 to u = 1 wraps the angular range.
+     */
+    uvFractionToPoint(uFraction: number, vFraction: number, result?: Point3d): Point3d;
+    /** Evaluate a point tangent plane on the Cone surfaces, with
+     * * v = 0 is the base plane.
+     * * v = 1 is the top plane
+     * * u = 0 to u = 1 wraps the angular range.
+     */
+    uvFractionToPointAndTangents(uFraction: number, vFraction: number, result?: Plane3dByOriginAndVectors): Plane3dByOriginAndVectors;
+    /**
+     * @return true if this is a closed volume.
+     */
+    get isClosedVolume(): boolean;
+    /**
+     * Directional distance query
+     * * u direction is around longitude circle at maximum distance from axis.
+     * * v direction is on a line of longitude between the latitude limits.
+     */
+    maxIsoParametricDistance(): Vector2d;
+}
+//# sourceMappingURL=Cone.d.ts.map

package/lib/esm/solid/Cone.d.ts.map

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

package/lib/esm/solid/Cone.js

@@ -0,0 +1,267 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Solid
+ */
+import { Arc3d } from "../curve/Arc3d";
+import { LineString3d } from "../curve/LineString3d";
+import { Loop } from "../curve/Loop";
+import { Geometry } from "../Geometry";
+import { Matrix3d } from "../geometry3d/Matrix3d";
+import { Plane3dByOriginAndVectors } from "../geometry3d/Plane3dByOriginAndVectors";
+import { Vector2d } from "../geometry3d/Point2dVector2d";
+import { Point3d, Vector3d } from "../geometry3d/Point3dVector3d";
+import { Transform } from "../geometry3d/Transform";
+import { SolidPrimitive } from "./SolidPrimitive";
+/**
+ * A cone with axis along the z axis of a (possibly skewed) local coordinate system.
+ *
+ * * In local coordinates, the sections at z=0 and z=1 are circles of radius r0 and r1.
+ * * Either one individually  may be zero, but they may not both be zero.
+ * * The stored matrix has unit vectors in the xy columns, and full-length z column.
+ * @public
+ */
+export class Cone extends SolidPrimitive {
+    constructor(map, radiusA, radiusB, capped) {
+        super(capped);
+        /** String name for schema properties */
+        this.solidPrimitiveType = "cone";
+        this._localToWorld = map;
+        this._radiusA = radiusA;
+        this._radiusB = radiusB;
+        this._maxRadius = Math.max(this._radiusA, this._radiusB); // um... should resolve elliptical sections
+    }
+    /** Return a clone of this Cone. */
+    clone() {
+        return new Cone(this._localToWorld.clone(), this._radiusA, this._radiusB, this.capped);
+    }
+    /** Return a coordinate frame (right handed unit vectors)
+     * * origin at center of the base circle.
+     * * base circle in the xy plane
+     * * z axis by right hand rule.
+     */
+    getConstructiveFrame() {
+        return this._localToWorld.cloneRigid();
+    }
+    /** Apply the transform to this cone's locla to world coordinates.
+     * * Note that the radii are not changed.  Scaling is absorbed into the frame.
+     * * This fails if the transformation is singular.
+     */
+    tryTransformInPlace(transform) {
+        if (transform.matrix.isSingular())
+            return false;
+        transform.multiplyTransformTransform(this._localToWorld, this._localToWorld);
+        return true;
+    }
+    /**
+     * Create a clone and immediately transform the clone.
+     */
+    cloneTransformed(transform) {
+        const result = this.clone();
+        transform.multiplyTransformTransform(result._localToWorld, result._localToWorld);
+        return result;
+    }
+    /** create a cylinder or cone from two endpoints and their radii.   The circular cross sections are perpendicular to the axis line
+     * from start to end point.
+     * * both radii must be of the same sign.
+     * * negative radius is accepted to create interior surface.    Downstream effects of that combined with capping may be a problem.
+     */
+    static createAxisPoints(centerA, centerB, radiusA, radiusB, capped) {
+        const zDirection = centerA.vectorTo(centerB);
+        const a = zDirection.magnitude();
+        if (Geometry.isSmallMetricDistance(a))
+            return undefined;
+        // force near-zero radii to true zero
+        radiusA = Geometry.correctSmallMetricDistance(radiusA);
+        radiusB = Geometry.correctSmallMetricDistance(radiusB);
+        // cone tip may not be "within" the z range.
+        if (radiusA * radiusB < 0.0)
+            return undefined;
+        // at least one must be nonzero.
+        if (radiusA + radiusB === 0.0)
+            return undefined;
+        const matrix = Matrix3d.createRigidHeadsUp(zDirection);
+        matrix.scaleColumns(1.0, 1.0, a, matrix);
+        const localToWorld = Transform.createOriginAndMatrix(centerA, matrix);
+        return new Cone(localToWorld, radiusA, radiusB, capped);
+    }
+    /** create a cylinder or cone from axis start and end with cross section defined by vectors that do not need to be perpendicular to each other or
+     * to the axis.
+     */
+    static createBaseAndTarget(centerA, centerB, vectorX, vectorY, radiusA, radiusB, capped) {
+        radiusA = Math.abs(Geometry.correctSmallMetricDistance(radiusA));
+        radiusB = Math.abs(Geometry.correctSmallMetricDistance(radiusB));
+        const vectorZ = centerA.vectorTo(centerB);
+        const localToWorld = Transform.createOriginAndMatrixColumns(centerA, vectorX, vectorY, vectorZ);
+        return new Cone(localToWorld, radiusA, radiusB, capped);
+    }
+    /** (Property accessor) Return the center point at the base plane */
+    getCenterA() { return this._localToWorld.multiplyXYZ(0, 0, 0); }
+    /** (Property accessor) */
+    getCenterB() { return this._localToWorld.multiplyXYZ(0, 0, 1); }
+    /** (Property accessor) Return the x vector in the local frame */
+    getVectorX() { return this._localToWorld.matrix.columnX(); }
+    /** (Property accessor) Return the y vector in the local frame */
+    getVectorY() { return this._localToWorld.matrix.columnY(); }
+    /** (Property accessor) return the radius at the base plane */
+    getRadiusA() { return this._radiusA; }
+    /** (Property accessor) return the radius at the top plane */
+    getRadiusB() { return this._radiusB; }
+    /** (Property accessor) return the larger of the base and top plane radii */
+    getMaxRadius() { return this._maxRadius; }
+    /** (Property accessor) return the radius at fraction `v` along the axis */
+    vFractionToRadius(v) { return Geometry.interpolate(this._radiusA, v, this._radiusB); }
+    /** (Property accessor) test if `other` is an instance of `Cone` */
+    isSameGeometryClass(other) { return other instanceof Cone; }
+    /** (Property accessor) Test for nearly equal coordinate data. */
+    isAlmostEqual(other) {
+        if (other instanceof Cone) {
+            if (this.capped !== other.capped)
+                return false;
+            if (!this._localToWorld.isAlmostEqualAllowZRotation(other._localToWorld))
+                return false;
+            return Geometry.isSameCoordinate(this._radiusA, other._radiusA)
+                && Geometry.isSameCoordinate(this._radiusB, other._radiusB);
+        }
+        return false;
+    }
+    /** Second step of double dispatch:   call `handler.handleCone(this)` */
+    dispatchToGeometryHandler(handler) {
+        return handler.handleCone(this);
+    }
+    /**
+     *  return strokes for a cross-section (elliptic arc) at specified fraction v along the axis.
+     * * fixedStrokeCount takes priority over stroke options.
+     * * The linestring is created by LineString3d.createForStrokes (fixedStrokeCount, options), which sets up property according to the options:
+     *   * optional fractions member
+     *   * optional uvParams.  uvParams are installed as full-scale distance parameters.
+     *   * optional derivatives.
+     * @param v fractional position along the cone axis
+     * @param fixedStrokeCount optional stroke count.
+     * @param options optional stroke options.
+     */
+    strokeConstantVSection(v, fixedStrokeCount, options) {
+        let strokeCount = 16;
+        if (fixedStrokeCount !== undefined)
+            strokeCount = fixedStrokeCount;
+        else if (options !== undefined)
+            strokeCount = options.defaultCircleStrokes; // NEEDS WORK -- get circle stroke count with this.maxRadius !!!
+        else {
+            // accept the local default
+        }
+        strokeCount = Geometry.clampToStartEnd(strokeCount, 4, 64);
+        const r = this.vFractionToRadius(v);
+        const result = LineString3d.createForStrokes(fixedStrokeCount, options);
+        const twoPi = Math.PI * 2.0;
+        const deltaRadians = twoPi / strokeCount;
+        let radians = 0;
+        const fractions = result.fractions; // possibly undefined !!!
+        const derivatives = result.packedDerivatives; // possibly undefined !!!
+        const uvParams = result.packedUVParams; // possibly undefined !!
+        const surfaceNormals = result.packedSurfaceNormals;
+        const xyz = Point3d.create();
+        const dXdu = Vector3d.create();
+        const dXdv = Vector3d.create();
+        const normal = Vector3d.create();
+        const transform = this._localToWorld;
+        let rc, rs, cc, ss;
+        for (let i = 0; i <= strokeCount; i++) {
+            if (i * 2 <= strokeCount)
+                radians = i * deltaRadians;
+            else
+                radians = (i - strokeCount) * deltaRadians;
+            cc = Math.cos(radians);
+            ss = Math.sin(radians);
+            rc = r * cc;
+            rs = r * ss;
+            transform.multiplyXYZ(rc, rs, v, xyz);
+            result.addPoint(xyz);
+            if (fractions)
+                fractions.push(i / strokeCount);
+            if (derivatives) {
+                transform.matrix.multiplyXYZ(-rs * twoPi, rc * twoPi, 0.0, dXdu);
+                derivatives.push(dXdu);
+            }
+            if (surfaceNormals) {
+                // the along-hoop vector does not need to be scaled by radius -- just need the direction for a cross product.
+                transform.matrix.multiplyXYZ(-ss, cc, 0.0, dXdu);
+                transform.matrix.multiplyXYZ(0, 0, 1, dXdv);
+                dXdu.unitCrossProduct(dXdv, normal);
+                surfaceNormals.push(normal);
+            }
+            if (uvParams) {
+                uvParams.pushXY(i / strokeCount, v);
+            }
+        }
+        return result;
+    }
+    /**
+     * Return the Arc3d section at vFraction
+     * @param vFraction fractional position along the sweep direction
+     */
+    constantVSection(vFraction) {
+        const r = this.vFractionToRadius(vFraction);
+        const transform = this._localToWorld;
+        const center = transform.multiplyXYZ(0, 0, vFraction);
+        const vector0 = transform.matrix.multiplyXYZ(r, 0, 0);
+        const vector90 = transform.matrix.multiplyXYZ(0, r, 0);
+        return Loop.create(Arc3d.create(center, vector0, vector90));
+    }
+    /** Extend `rangeToExtend` so it includes this `Cone` instance. */
+    extendRange(rangeToExtend, transform) {
+        const arc0 = this.constantVSection(0.0);
+        const arc1 = this.constantVSection(1.0);
+        arc0.extendRange(rangeToExtend, transform);
+        arc1.extendRange(rangeToExtend, transform);
+    }
+    /** Evaluate a point on the Cone surfaces, with
+     * * v = 0 is the base plane.
+     * * v = 1 is the top plane
+     * * u = 0 to u = 1 wraps the angular range.
+     */
+    uvFractionToPoint(uFraction, vFraction, result) {
+        const theta = uFraction * Math.PI * 2.0;
+        const r = Geometry.interpolate(this._radiusA, vFraction, this._radiusB);
+        const cosTheta = Math.cos(theta);
+        const sinTheta = Math.sin(theta);
+        return this._localToWorld.multiplyXYZ(r * cosTheta, r * sinTheta, vFraction, result);
+    }
+    /** Evaluate a point tangent plane on the Cone surfaces, with
+     * * v = 0 is the base plane.
+     * * v = 1 is the top plane
+     * * u = 0 to u = 1 wraps the angular range.
+     */
+    uvFractionToPointAndTangents(uFraction, vFraction, result) {
+        const theta = uFraction * Math.PI * 2.0;
+        const r = Geometry.interpolate(this._radiusA, vFraction, this._radiusB);
+        const drdv = this._radiusB - this._radiusA;
+        const cosTheta = Math.cos(theta);
+        const sinTheta = Math.sin(theta);
+        const fTheta = 2.0 * Math.PI;
+        return Plane3dByOriginAndVectors.createOriginAndVectors(this._localToWorld.multiplyXYZ(r * cosTheta, r * sinTheta, vFraction), this._localToWorld.multiplyVectorXYZ(-r * sinTheta * fTheta, r * cosTheta * fTheta, 0), this._localToWorld.multiplyVectorXYZ(drdv * cosTheta, drdv * sinTheta, 1.0), result);
+    }
+    /**
+     * @return true if this is a closed volume.
+     */
+    get isClosedVolume() {
+        return this.capped;
+    }
+    /**
+     * Directional distance query
+     * * u direction is around longitude circle at maximum distance from axis.
+     * * v direction is on a line of longitude between the latitude limits.
+     */
+    maxIsoParametricDistance() {
+        const vectorX = this._localToWorld.matrix.columnX();
+        const vectorY = this._localToWorld.matrix.columnY();
+        const columnZ = this._localToWorld.matrix.columnZ();
+        const xyNormal = vectorX.unitCrossProduct(vectorY);
+        const hZ = xyNormal.dotProduct(columnZ);
+        const zSkewVector = columnZ.plusScaled(xyNormal, hZ);
+        const zSkewDistance = zSkewVector.magnitudeXY();
+        return Vector2d.create(Math.PI * 2 * Math.max(this._radiusA, this._radiusB), Geometry.hypotenuseXY(Math.abs(this._radiusB - this._radiusA) + zSkewDistance, hZ));
+    }
+}
+//# sourceMappingURL=Cone.js.map