@itwin/core-common 4.0.0-dev.52 → 4.0.0-dev.54

package/lib/esm/geometry/Placement.d.ts

@@ -1,96 +1,96 @@
-/** @packageDocumentation
- * @module Geometry
- */
-import { Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, Range3dProps, Transform, YawPitchRollAngles } from "@itwin/core-geometry";
-import { Placement2dProps, Placement3dProps } from "../ElementProps";
-import { Frustum } from "../Frustum";
-/** A Range3d that is aligned with the axes of spatial coordinates.
- * @public
- * @extensions
- */
-export declare type AxisAlignedBox3d = Range3d;
-/** The properties of a Range3d.
- * @public
- * @extensions
- */
-export declare type AxisAlignedBox3dProps = Range3dProps;
-/** A bounding box aligned to the orientation of a 3d Element
- * @public
- * @extensions
- */
-export declare type ElementAlignedBox3d = Range3d;
-/** A bounding box aligned to the orientation of a 2d Element
- * @public
- * @extensions
- */
-export declare type ElementAlignedBox2d = Range2d;
-/** A bounding box aligned to a local coordinate system
- * @public
- * @extensions
- */
-export declare type LocalAlignedBox3d = Range3d;
-/** Either a Placement2d or Placement3d
- * @public
- * @extensions
- */
-export declare type Placement = Placement2d | Placement3d;
-/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.
- * All geometry of a GeometricElement are relative to its placement.
- * @public
- */
-export declare class Placement3d implements Placement3dProps {
-    origin: Point3d;
-    angles: YawPitchRollAngles;
-    bbox: ElementAlignedBox3d;
-    constructor(origin: Point3d, angles: YawPitchRollAngles, bbox: ElementAlignedBox3d);
-    /** Get the rotation from local coordinates of this placement to world coordinates. */
-    get rotation(): Matrix3d;
-    /** Get the transform from local coordinates of this placement to world coordinates. */
-    get transform(): Transform;
-    /** determine if this is 3d placement */
-    get is3d(): boolean;
-    /** Create a new Placement3d from a Placement3dProps. */
-    static fromJSON(json?: Placement3dProps): Placement3d;
-    /** Get the 8 corners, in world coordinates, of this placement. */
-    getWorldCorners(out?: Frustum): Frustum;
-    /** Set the contents of this Placement3d from another Placement3d */
-    setFrom(other: Placement3d): void;
-    /** Determine whether this Placement3d is valid. */
-    get isValid(): boolean;
-    /** Calculate the axis-aligned bounding box for this placement. */
-    calculateRange(): AxisAlignedBox3d;
-    /** Multiply the Transform of this Placement3d by the specified *other* Transform.
-     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.
-     */
-    multiplyTransform(other: Transform): void;
-}
-/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.
- * @public
- */
-export declare class Placement2d implements Placement2dProps {
-    origin: Point2d;
-    angle: Angle;
-    bbox: ElementAlignedBox2d;
-    constructor(origin: Point2d, angle: Angle, bbox: ElementAlignedBox2d);
-    /** Get the rotation from local coordinates of this placement to world coordinates. */
-    get rotation(): Matrix3d;
-    /** Get the transform from local coordinates of this placement to world coordinates. */
-    get transform(): Transform;
-    /** Create a new Placement2d from a Placement2dProps. */
-    static fromJSON(json?: Placement2dProps): Placement2d;
-    /** determine if this is 3d placement */
-    get is3d(): boolean;
-    /** Get the 8 corners, in world coordinates, of this placement. */
-    getWorldCorners(out?: Frustum): Frustum;
-    /** Determine whether this Placement2d is valid. */
-    get isValid(): boolean;
-    /** Set the contents of this Placement2d from another Placement2d */
-    setFrom(other: Placement2d): void;
-    /** Calculate the axis-aligned bounding box for this placement. */
-    calculateRange(): AxisAlignedBox3d;
-    /** Multiply the Transform of this Placement2d by the specified *other* Transform.
-     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.
-     */
-    multiplyTransform(other: Transform): void;
-}
+/** @packageDocumentation
+ * @module Geometry
+ */
+import { Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, Range3dProps, Transform, YawPitchRollAngles } from "@itwin/core-geometry";
+import { Placement2dProps, Placement3dProps } from "../ElementProps";
+import { Frustum } from "../Frustum";
+/** A Range3d that is aligned with the axes of spatial coordinates.
+ * @public
+ * @extensions
+ */
+export type AxisAlignedBox3d = Range3d;
+/** The properties of a Range3d.
+ * @public
+ * @extensions
+ */
+export type AxisAlignedBox3dProps = Range3dProps;
+/** A bounding box aligned to the orientation of a 3d Element
+ * @public
+ * @extensions
+ */
+export type ElementAlignedBox3d = Range3d;
+/** A bounding box aligned to the orientation of a 2d Element
+ * @public
+ * @extensions
+ */
+export type ElementAlignedBox2d = Range2d;
+/** A bounding box aligned to a local coordinate system
+ * @public
+ * @extensions
+ */
+export type LocalAlignedBox3d = Range3d;
+/** Either a Placement2d or Placement3d
+ * @public
+ * @extensions
+ */
+export type Placement = Placement2d | Placement3d;
+/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.
+ * All geometry of a GeometricElement are relative to its placement.
+ * @public
+ */
+export declare class Placement3d implements Placement3dProps {
+    origin: Point3d;
+    angles: YawPitchRollAngles;
+    bbox: ElementAlignedBox3d;
+    constructor(origin: Point3d, angles: YawPitchRollAngles, bbox: ElementAlignedBox3d);
+    /** Get the rotation from local coordinates of this placement to world coordinates. */
+    get rotation(): Matrix3d;
+    /** Get the transform from local coordinates of this placement to world coordinates. */
+    get transform(): Transform;
+    /** determine if this is 3d placement */
+    get is3d(): boolean;
+    /** Create a new Placement3d from a Placement3dProps. */
+    static fromJSON(json?: Placement3dProps): Placement3d;
+    /** Get the 8 corners, in world coordinates, of this placement. */
+    getWorldCorners(out?: Frustum): Frustum;
+    /** Set the contents of this Placement3d from another Placement3d */
+    setFrom(other: Placement3d): void;
+    /** Determine whether this Placement3d is valid. */
+    get isValid(): boolean;
+    /** Calculate the axis-aligned bounding box for this placement. */
+    calculateRange(): AxisAlignedBox3d;
+    /** Multiply the Transform of this Placement3d by the specified *other* Transform.
+     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.
+     */
+    multiplyTransform(other: Transform): void;
+}
+/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.
+ * @public
+ */
+export declare class Placement2d implements Placement2dProps {
+    origin: Point2d;
+    angle: Angle;
+    bbox: ElementAlignedBox2d;
+    constructor(origin: Point2d, angle: Angle, bbox: ElementAlignedBox2d);
+    /** Get the rotation from local coordinates of this placement to world coordinates. */
+    get rotation(): Matrix3d;
+    /** Get the transform from local coordinates of this placement to world coordinates. */
+    get transform(): Transform;
+    /** Create a new Placement2d from a Placement2dProps. */
+    static fromJSON(json?: Placement2dProps): Placement2d;
+    /** determine if this is 3d placement */
+    get is3d(): boolean;
+    /** Get the 8 corners, in world coordinates, of this placement. */
+    getWorldCorners(out?: Frustum): Frustum;
+    /** Determine whether this Placement2d is valid. */
+    get isValid(): boolean;
+    /** Set the contents of this Placement2d from another Placement2d */
+    setFrom(other: Placement2d): void;
+    /** Calculate the axis-aligned bounding box for this placement. */
+    calculateRange(): AxisAlignedBox3d;
+    /** Multiply the Transform of this Placement2d by the specified *other* Transform.
+     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.
+     */
+    multiplyTransform(other: Transform): void;
+}
 //# sourceMappingURL=Placement.d.ts.map

package/lib/esm/geometry/Placement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Placement.d.ts","sourceRoot":"","sources":["../../../src/geometry/Placement.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACL,KAAK,EAAY,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAY,kBAAkB,EACrH,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC;;;GAGG;AACH,oBAAY,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;;GAGG;AACH,oBAAY,qBAAqB,GAAG,YAAY,CAAC;AAEjD;;;GAGG;AACH,oBAAY,mBAAmB,GAAG,OAAO,CAAC;AAE1C;;;GAGG;AACH,oBAAY,mBAAmB,GAAG,OAAO,CAAC;AAE1C;;;GAGG;AACH,oBAAY,iBAAiB,GAAG,OAAO,CAAC;AAExC;;;GAGG;AACH,oBAAY,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAElD;;;GAGG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IACxB,MAAM,EAAE,OAAO;IAAS,MAAM,EAAE,kBAAkB;IAAS,IAAI,EAAE,mBAAmB;gBAApF,MAAM,EAAE,OAAO,EAAS,MAAM,EAAE,kBAAkB,EAAS,IAAI,EAAE,mBAAmB;IAC9G,sFAAsF;IACtF,IAAW,QAAQ,IAAI,QAAQ,CAAqC;IACpE,uFAAuF;IACvF,IAAW,SAAS,IAAI,SAAS,CAAwE;IACzG,wCAAwC;IACxC,IAAW,IAAI,IAAI,OAAO,CAAiB;IAE3C,wDAAwD;WAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAK5D,kEAAkE;IAC3D,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9C,oEAAoE;IAC7D,OAAO,CAAC,KAAK,EAAE,WAAW;IAMjC,mDAAmD;IACnD,IAAW,OAAO,IAAI,OAAO,CAAoH;IAEjJ,kEAAkE;IAC3D,cAAc,IAAI,gBAAgB;IAYzC;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CASjD;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IACxB,MAAM,EAAE,OAAO;IAAS,KAAK,EAAE,KAAK;IAAS,IAAI,EAAE,mBAAmB;gBAAtE,MAAM,EAAE,OAAO,EAAS,KAAK,EAAE,KAAK,EAAS,IAAI,EAAE,mBAAmB;IAChG,sFAAsF;IACtF,IAAW,QAAQ,IAAI,QAAQ,CAA+E;IAC9G,uFAAuF;IACvF,IAAW,SAAS,IAAI,SAAS,CAA4F;IAC7H,wDAAwD;WAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAI5D,wCAAwC;IACxC,IAAW,IAAI,IAAI,OAAO,CAAkB;IAE5C,kEAAkE;IAC3D,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9C,mDAAmD;IACnD,IAAW,OAAO,IAAI,OAAO,CAAoH;IAEjJ,oEAAoE;IAC7D,OAAO,CAAC,KAAK,EAAE,WAAW;IAMjC,kEAAkE;IAC3D,cAAc,IAAI,gBAAgB;IAczC;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CASjD"}
+{"version":3,"file":"Placement.d.ts","sourceRoot":"","sources":["../../../src/geometry/Placement.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACL,KAAK,EAAY,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAY,kBAAkB,EACrH,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAElD;;;GAGG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IACxB,MAAM,EAAE,OAAO;IAAS,MAAM,EAAE,kBAAkB;IAAS,IAAI,EAAE,mBAAmB;gBAApF,MAAM,EAAE,OAAO,EAAS,MAAM,EAAE,kBAAkB,EAAS,IAAI,EAAE,mBAAmB;IAC9G,sFAAsF;IACtF,IAAW,QAAQ,IAAI,QAAQ,CAAqC;IACpE,uFAAuF;IACvF,IAAW,SAAS,IAAI,SAAS,CAAwE;IACzG,wCAAwC;IACxC,IAAW,IAAI,IAAI,OAAO,CAAiB;IAE3C,wDAAwD;WAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAK5D,kEAAkE;IAC3D,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9C,oEAAoE;IAC7D,OAAO,CAAC,KAAK,EAAE,WAAW;IAMjC,mDAAmD;IACnD,IAAW,OAAO,IAAI,OAAO,CAAoH;IAEjJ,kEAAkE;IAC3D,cAAc,IAAI,gBAAgB;IAYzC;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CASjD;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IACxB,MAAM,EAAE,OAAO;IAAS,KAAK,EAAE,KAAK;IAAS,IAAI,EAAE,mBAAmB;gBAAtE,MAAM,EAAE,OAAO,EAAS,KAAK,EAAE,KAAK,EAAS,IAAI,EAAE,mBAAmB;IAChG,sFAAsF;IACtF,IAAW,QAAQ,IAAI,QAAQ,CAA+E;IAC9G,uFAAuF;IACvF,IAAW,SAAS,IAAI,SAAS,CAA4F;IAC7H,wDAAwD;WAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAI5D,wCAAwC;IACxC,IAAW,IAAI,IAAI,OAAO,CAAkB;IAE5C,kEAAkE;IAC3D,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9C,mDAAmD;IACnD,IAAW,OAAO,IAAI,OAAO,CAAoH;IAEjJ,oEAAoE;IAC7D,OAAO,CAAC,KAAK,EAAE,WAAW;IAMjC,kEAAkE;IAC3D,cAAc,IAAI,gBAAgB;IAczC;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;CASjD"}

package/lib/esm/geometry/Placement.js

@@ -1,127 +1,127 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Geometry
- */
-import { IModelStatus } from "@itwin/core-bentley";
-import { Angle, Constant, Matrix3d, Point2d, Point3d, Range2d, Range3d, Transform, Vector3d, YawPitchRollAngles, } from "@itwin/core-geometry";
-import { Frustum } from "../Frustum";
-import { IModelError } from "../IModelError";
-/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.
- * All geometry of a GeometricElement are relative to its placement.
- * @public
- */
-export class Placement3d {
-    constructor(origin, angles, bbox) {
-        this.origin = origin;
-        this.angles = angles;
-        this.bbox = bbox;
-    }
-    /** Get the rotation from local coordinates of this placement to world coordinates. */
-    get rotation() { return this.angles.toMatrix3d(); }
-    /** Get the transform from local coordinates of this placement to world coordinates. */
-    get transform() { return Transform.createOriginAndMatrix(this.origin, this.rotation); }
-    /** determine if this is 3d placement */
-    get is3d() { return true; }
-    /** Create a new Placement3d from a Placement3dProps. */
-    static fromJSON(json) {
-        const props = json ? json : {};
-        return new Placement3d(Point3d.fromJSON(props.origin), YawPitchRollAngles.fromJSON(props.angles), Range3d.fromJSON(props.bbox));
-    }
-    /** Get the 8 corners, in world coordinates, of this placement. */
-    getWorldCorners(out) {
-        const frust = Frustum.fromRange(this.bbox, out);
-        frust.multiply(this.transform);
-        return frust;
-    }
-    /** Set the contents of this Placement3d from another Placement3d */
-    setFrom(other) {
-        this.origin.setFrom(other.origin);
-        this.angles.setFrom(other.angles);
-        this.bbox.setFrom(other.bbox);
-    }
-    /** Determine whether this Placement3d is valid. */
-    get isValid() { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }
-    /** Calculate the axis-aligned bounding box for this placement. */
-    calculateRange() {
-        const range = new Range3d();
-        if (!this.isValid)
-            return range;
-        this.transform.multiplyRange(this.bbox, range);
-        // low and high are not allowed to be equal
-        range.ensureMinLengths();
-        return range;
-    }
-    /** Multiply the Transform of this Placement3d by the specified *other* Transform.
-     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.
-     */
-    multiplyTransform(other) {
-        const transform = other.multiplyTransformTransform(this.transform);
-        const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);
-        if (undefined === angles)
-            throw new IModelError(IModelStatus.BadRequest, "Invalid Transform");
-        this.angles = angles;
-        this.origin.setFrom(transform.origin);
-    }
-}
-/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.
- * @public
- */
-export class Placement2d {
-    constructor(origin, angle, bbox) {
-        this.origin = origin;
-        this.angle = angle;
-        this.bbox = bbox;
-    }
-    /** Get the rotation from local coordinates of this placement to world coordinates. */
-    get rotation() { return Matrix3d.createRotationAroundVector(Vector3d.unitZ(), this.angle); }
-    /** Get the transform from local coordinates of this placement to world coordinates. */
-    get transform() { return Transform.createOriginAndMatrix(Point3d.createFrom(this.origin), this.rotation); }
-    /** Create a new Placement2d from a Placement2dProps. */
-    static fromJSON(json) {
-        const props = json ? json : {};
-        return new Placement2d(Point2d.fromJSON(props.origin), Angle.fromJSON(props.angle), Range2d.fromJSON(props.bbox));
-    }
-    /** determine if this is 3d placement */
-    get is3d() { return false; }
-    /** Get the 8 corners, in world coordinates, of this placement. */
-    getWorldCorners(out) {
-        const frust = Frustum.fromRange(this.bbox, out);
-        frust.multiply(this.transform);
-        return frust;
-    }
-    /** Determine whether this Placement2d is valid. */
-    get isValid() { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }
-    /** Set the contents of this Placement2d from another Placement2d */
-    setFrom(other) {
-        this.origin.setFrom(other.origin);
-        this.angle.setFrom(other.angle);
-        this.bbox.setFrom(other.bbox);
-    }
-    /** Calculate the axis-aligned bounding box for this placement. */
-    calculateRange() {
-        const range = new Range3d();
-        if (!this.isValid)
-            return range;
-        this.transform.multiplyRange(Range3d.createRange2d(this.bbox, 0), range);
-        // low and high are not allowed to be equal
-        range.ensureMinLengths();
-        range.low.z = -1.0; // is the 2dFrustumDepth, which === 1 meter
-        range.high.z = 1.0;
-        return range;
-    }
-    /** Multiply the Transform of this Placement2d by the specified *other* Transform.
-     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.
-     */
-    multiplyTransform(other) {
-        const transform = other.multiplyTransformTransform(this.transform);
-        const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);
-        if ((undefined === angles) || !angles.pitch.isAlmostZero || !angles.roll.isAlmostZero)
-            throw new IModelError(IModelStatus.BadRequest, "Invalid Transform");
-        this.angle = angles.yaw;
-        this.origin.setFrom(transform.origin);
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Geometry
+ */
+import { IModelStatus } from "@itwin/core-bentley";
+import { Angle, Constant, Matrix3d, Point2d, Point3d, Range2d, Range3d, Transform, Vector3d, YawPitchRollAngles, } from "@itwin/core-geometry";
+import { Frustum } from "../Frustum";
+import { IModelError } from "../IModelError";
+/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.
+ * All geometry of a GeometricElement are relative to its placement.
+ * @public
+ */
+export class Placement3d {
+    constructor(origin, angles, bbox) {
+        this.origin = origin;
+        this.angles = angles;
+        this.bbox = bbox;
+    }
+    /** Get the rotation from local coordinates of this placement to world coordinates. */
+    get rotation() { return this.angles.toMatrix3d(); }
+    /** Get the transform from local coordinates of this placement to world coordinates. */
+    get transform() { return Transform.createOriginAndMatrix(this.origin, this.rotation); }
+    /** determine if this is 3d placement */
+    get is3d() { return true; }
+    /** Create a new Placement3d from a Placement3dProps. */
+    static fromJSON(json) {
+        const props = json ? json : {};
+        return new Placement3d(Point3d.fromJSON(props.origin), YawPitchRollAngles.fromJSON(props.angles), Range3d.fromJSON(props.bbox));
+    }
+    /** Get the 8 corners, in world coordinates, of this placement. */
+    getWorldCorners(out) {
+        const frust = Frustum.fromRange(this.bbox, out);
+        frust.multiply(this.transform);
+        return frust;
+    }
+    /** Set the contents of this Placement3d from another Placement3d */
+    setFrom(other) {
+        this.origin.setFrom(other.origin);
+        this.angles.setFrom(other.angles);
+        this.bbox.setFrom(other.bbox);
+    }
+    /** Determine whether this Placement3d is valid. */
+    get isValid() { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }
+    /** Calculate the axis-aligned bounding box for this placement. */
+    calculateRange() {
+        const range = new Range3d();
+        if (!this.isValid)
+            return range;
+        this.transform.multiplyRange(this.bbox, range);
+        // low and high are not allowed to be equal
+        range.ensureMinLengths();
+        return range;
+    }
+    /** Multiply the Transform of this Placement3d by the specified *other* Transform.
+     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.
+     */
+    multiplyTransform(other) {
+        const transform = other.multiplyTransformTransform(this.transform);
+        const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);
+        if (undefined === angles)
+            throw new IModelError(IModelStatus.BadRequest, "Invalid Transform");
+        this.angles = angles;
+        this.origin.setFrom(transform.origin);
+    }
+}
+/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.
+ * @public
+ */
+export class Placement2d {
+    constructor(origin, angle, bbox) {
+        this.origin = origin;
+        this.angle = angle;
+        this.bbox = bbox;
+    }
+    /** Get the rotation from local coordinates of this placement to world coordinates. */
+    get rotation() { return Matrix3d.createRotationAroundVector(Vector3d.unitZ(), this.angle); }
+    /** Get the transform from local coordinates of this placement to world coordinates. */
+    get transform() { return Transform.createOriginAndMatrix(Point3d.createFrom(this.origin), this.rotation); }
+    /** Create a new Placement2d from a Placement2dProps. */
+    static fromJSON(json) {
+        const props = json ? json : {};
+        return new Placement2d(Point2d.fromJSON(props.origin), Angle.fromJSON(props.angle), Range2d.fromJSON(props.bbox));
+    }
+    /** determine if this is 3d placement */
+    get is3d() { return false; }
+    /** Get the 8 corners, in world coordinates, of this placement. */
+    getWorldCorners(out) {
+        const frust = Frustum.fromRange(this.bbox, out);
+        frust.multiply(this.transform);
+        return frust;
+    }
+    /** Determine whether this Placement2d is valid. */
+    get isValid() { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }
+    /** Set the contents of this Placement2d from another Placement2d */
+    setFrom(other) {
+        this.origin.setFrom(other.origin);
+        this.angle.setFrom(other.angle);
+        this.bbox.setFrom(other.bbox);
+    }
+    /** Calculate the axis-aligned bounding box for this placement. */
+    calculateRange() {
+        const range = new Range3d();
+        if (!this.isValid)
+            return range;
+        this.transform.multiplyRange(Range3d.createRange2d(this.bbox, 0), range);
+        // low and high are not allowed to be equal
+        range.ensureMinLengths();
+        range.low.z = -1.0; // is the 2dFrustumDepth, which === 1 meter
+        range.high.z = 1.0;
+        return range;
+    }
+    /** Multiply the Transform of this Placement2d by the specified *other* Transform.
+     * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.
+     */
+    multiplyTransform(other) {
+        const transform = other.multiplyTransformTransform(this.transform);
+        const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);
+        if ((undefined === angles) || !angles.pitch.isAlmostZero || !angles.roll.isAlmostZero)
+            throw new IModelError(IModelStatus.BadRequest, "Invalid Transform");
+        this.angle = angles.yaw;
+        this.origin.setFrom(transform.origin);
+    }
+}
 //# sourceMappingURL=Placement.js.map

package/lib/esm/geometry/Placement.js.map

@@ -1 +1 @@
-{"version":3,"file":"Placement.js","sourceRoot":"","sources":["../../../src/geometry/Placement.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/** @packageDocumentation\r\n * @module Geometry\r\n */\r\n\r\nimport { IModelStatus } from \"@itwin/core-bentley\";\r\nimport {\r\n  Angle, Constant, Matrix3d, Point2d, Point3d, Range2d, Range3d, Range3dProps, Transform, Vector3d, YawPitchRollAngles,\r\n} from \"@itwin/core-geometry\";\r\nimport { Placement2dProps, Placement3dProps } from \"../ElementProps\";\r\nimport { Frustum } from \"../Frustum\";\r\nimport { IModelError } from \"../IModelError\";\r\n\r\n/** A Range3d that is aligned with the axes of spatial coordinates.\r\n * @public\r\n * @extensions\r\n */\r\nexport type AxisAlignedBox3d = Range3d;\r\n\r\n/** The properties of a Range3d.\r\n * @public\r\n * @extensions\r\n */\r\nexport type AxisAlignedBox3dProps = Range3dProps;\r\n\r\n/** A bounding box aligned to the orientation of a 3d Element\r\n * @public\r\n * @extensions\r\n */\r\nexport type ElementAlignedBox3d = Range3d;\r\n\r\n/** A bounding box aligned to the orientation of a 2d Element\r\n * @public\r\n * @extensions\r\n */\r\nexport type ElementAlignedBox2d = Range2d;\r\n\r\n/** A bounding box aligned to a local coordinate system\r\n * @public\r\n * @extensions\r\n */\r\nexport type LocalAlignedBox3d = Range3d;\r\n\r\n/** Either a Placement2d or Placement3d\r\n * @public\r\n * @extensions\r\n */\r\nexport type Placement = Placement2d | Placement3d;\r\n\r\n/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.\r\n * All geometry of a GeometricElement are relative to its placement.\r\n * @public\r\n */\r\nexport class Placement3d implements Placement3dProps {\r\n  public constructor(public origin: Point3d, public angles: YawPitchRollAngles, public bbox: ElementAlignedBox3d) { }\r\n  /** Get the rotation from local coordinates of this placement to world coordinates. */\r\n  public get rotation(): Matrix3d { return this.angles.toMatrix3d(); }\r\n  /** Get the transform from local coordinates of this placement to world coordinates. */\r\n  public get transform(): Transform { return Transform.createOriginAndMatrix(this.origin, this.rotation); }\r\n  /** determine if this is 3d placement */\r\n  public get is3d(): boolean { return true; }\r\n\r\n  /** Create a new Placement3d from a Placement3dProps. */\r\n  public static fromJSON(json?: Placement3dProps): Placement3d {\r\n    const props: any = json ? json : {};\r\n    return new Placement3d(Point3d.fromJSON(props.origin), YawPitchRollAngles.fromJSON(props.angles), Range3d.fromJSON<ElementAlignedBox3d>(props.bbox));\r\n  }\r\n\r\n  /** Get the 8 corners, in world coordinates, of this placement. */\r\n  public getWorldCorners(out?: Frustum): Frustum {\r\n    const frust = Frustum.fromRange(this.bbox, out);\r\n    frust.multiply(this.transform);\r\n    return frust;\r\n  }\r\n\r\n  /** Set the contents of this Placement3d from another Placement3d */\r\n  public setFrom(other: Placement3d) {\r\n    this.origin.setFrom(other.origin);\r\n    this.angles.setFrom(other.angles);\r\n    this.bbox.setFrom(other.bbox);\r\n  }\r\n\r\n  /** Determine whether this Placement3d is valid. */\r\n  public get isValid(): boolean { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }\r\n\r\n  /** Calculate the axis-aligned bounding box for this placement. */\r\n  public calculateRange(): AxisAlignedBox3d {\r\n    const range = new Range3d();\r\n    if (!this.isValid)\r\n      return range;\r\n\r\n    this.transform.multiplyRange(this.bbox, range);\r\n\r\n    // low and high are not allowed to be equal\r\n    range.ensureMinLengths();\r\n    return range;\r\n  }\r\n\r\n  /** Multiply the Transform of this Placement3d by the specified *other* Transform.\r\n   * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.\r\n   */\r\n  public multiplyTransform(other: Transform): void {\r\n    const transform = other.multiplyTransformTransform(this.transform);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);\r\n    if (undefined === angles)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Invalid Transform\");\r\n\r\n    this.angles = angles;\r\n    this.origin.setFrom(transform.origin);\r\n  }\r\n}\r\n\r\n/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.\r\n * @public\r\n */\r\nexport class Placement2d implements Placement2dProps {\r\n  public constructor(public origin: Point2d, public angle: Angle, public bbox: ElementAlignedBox2d) { }\r\n  /** Get the rotation from local coordinates of this placement to world coordinates. */\r\n  public get rotation(): Matrix3d { return Matrix3d.createRotationAroundVector(Vector3d.unitZ(), this.angle)!; }\r\n  /** Get the transform from local coordinates of this placement to world coordinates. */\r\n  public get transform(): Transform { return Transform.createOriginAndMatrix(Point3d.createFrom(this.origin), this.rotation); }\r\n  /** Create a new Placement2d from a Placement2dProps. */\r\n  public static fromJSON(json?: Placement2dProps): Placement2d {\r\n    const props: any = json ? json : {};\r\n    return new Placement2d(Point2d.fromJSON(props.origin), Angle.fromJSON(props.angle), Range2d.fromJSON(props.bbox));\r\n  }\r\n  /** determine if this is 3d placement */\r\n  public get is3d(): boolean { return false; }\r\n\r\n  /** Get the 8 corners, in world coordinates, of this placement. */\r\n  public getWorldCorners(out?: Frustum): Frustum {\r\n    const frust = Frustum.fromRange(this.bbox, out);\r\n    frust.multiply(this.transform);\r\n    return frust;\r\n  }\r\n\r\n  /** Determine whether this Placement2d is valid. */\r\n  public get isValid(): boolean { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }\r\n\r\n  /** Set the contents of this Placement2d from another Placement2d */\r\n  public setFrom(other: Placement2d) {\r\n    this.origin.setFrom(other.origin);\r\n    this.angle.setFrom(other.angle);\r\n    this.bbox.setFrom(other.bbox);\r\n  }\r\n\r\n  /** Calculate the axis-aligned bounding box for this placement. */\r\n  public calculateRange(): AxisAlignedBox3d {\r\n    const range = new Range3d();\r\n    if (!this.isValid)\r\n      return range;\r\n\r\n    this.transform.multiplyRange(Range3d.createRange2d(this.bbox, 0), range);\r\n\r\n    // low and high are not allowed to be equal\r\n    range.ensureMinLengths();\r\n    range.low.z = - 1.0;  // is the 2dFrustumDepth, which === 1 meter\r\n    range.high.z = 1.0;\r\n    return range;\r\n  }\r\n\r\n  /** Multiply the Transform of this Placement2d by the specified *other* Transform.\r\n   * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.\r\n   */\r\n  public multiplyTransform(other: Transform): void {\r\n    const transform = other.multiplyTransformTransform(this.transform);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);\r\n    if ((undefined === angles) || !angles.pitch.isAlmostZero || !angles.roll.isAlmostZero)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Invalid Transform\");\r\n\r\n    this.angle = angles.yaw;\r\n    this.origin.setFrom(transform.origin);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Placement.js","sourceRoot":"","sources":["../../../src/geometry/Placement.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Geometry\n */\n\nimport { IModelStatus } from \"@itwin/core-bentley\";\nimport {\n  Angle, Constant, Matrix3d, Point2d, Point3d, Range2d, Range3d, Range3dProps, Transform, Vector3d, YawPitchRollAngles,\n} from \"@itwin/core-geometry\";\nimport { Placement2dProps, Placement3dProps } from \"../ElementProps\";\nimport { Frustum } from \"../Frustum\";\nimport { IModelError } from \"../IModelError\";\n\n/** A Range3d that is aligned with the axes of spatial coordinates.\n * @public\n * @extensions\n */\nexport type AxisAlignedBox3d = Range3d;\n\n/** The properties of a Range3d.\n * @public\n * @extensions\n */\nexport type AxisAlignedBox3dProps = Range3dProps;\n\n/** A bounding box aligned to the orientation of a 3d Element\n * @public\n * @extensions\n */\nexport type ElementAlignedBox3d = Range3d;\n\n/** A bounding box aligned to the orientation of a 2d Element\n * @public\n * @extensions\n */\nexport type ElementAlignedBox2d = Range2d;\n\n/** A bounding box aligned to a local coordinate system\n * @public\n * @extensions\n */\nexport type LocalAlignedBox3d = Range3d;\n\n/** Either a Placement2d or Placement3d\n * @public\n * @extensions\n */\nexport type Placement = Placement2d | Placement3d;\n\n/** The placement of a GeometricElement3d. This includes the origin, orientation, and size (bounding box) of the element.\n * All geometry of a GeometricElement are relative to its placement.\n * @public\n */\nexport class Placement3d implements Placement3dProps {\n  public constructor(public origin: Point3d, public angles: YawPitchRollAngles, public bbox: ElementAlignedBox3d) { }\n  /** Get the rotation from local coordinates of this placement to world coordinates. */\n  public get rotation(): Matrix3d { return this.angles.toMatrix3d(); }\n  /** Get the transform from local coordinates of this placement to world coordinates. */\n  public get transform(): Transform { return Transform.createOriginAndMatrix(this.origin, this.rotation); }\n  /** determine if this is 3d placement */\n  public get is3d(): boolean { return true; }\n\n  /** Create a new Placement3d from a Placement3dProps. */\n  public static fromJSON(json?: Placement3dProps): Placement3d {\n    const props: any = json ? json : {};\n    return new Placement3d(Point3d.fromJSON(props.origin), YawPitchRollAngles.fromJSON(props.angles), Range3d.fromJSON<ElementAlignedBox3d>(props.bbox));\n  }\n\n  /** Get the 8 corners, in world coordinates, of this placement. */\n  public getWorldCorners(out?: Frustum): Frustum {\n    const frust = Frustum.fromRange(this.bbox, out);\n    frust.multiply(this.transform);\n    return frust;\n  }\n\n  /** Set the contents of this Placement3d from another Placement3d */\n  public setFrom(other: Placement3d) {\n    this.origin.setFrom(other.origin);\n    this.angles.setFrom(other.angles);\n    this.bbox.setFrom(other.bbox);\n  }\n\n  /** Determine whether this Placement3d is valid. */\n  public get isValid(): boolean { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }\n\n  /** Calculate the axis-aligned bounding box for this placement. */\n  public calculateRange(): AxisAlignedBox3d {\n    const range = new Range3d();\n    if (!this.isValid)\n      return range;\n\n    this.transform.multiplyRange(this.bbox, range);\n\n    // low and high are not allowed to be equal\n    range.ensureMinLengths();\n    return range;\n  }\n\n  /** Multiply the Transform of this Placement3d by the specified *other* Transform.\n   * @throws [[IModelError]] if the Transform is invalid for a GeometricElement3d.\n   */\n  public multiplyTransform(other: Transform): void {\n    const transform = other.multiplyTransformTransform(this.transform);\n    const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);\n    if (undefined === angles)\n      throw new IModelError(IModelStatus.BadRequest, \"Invalid Transform\");\n\n    this.angles = angles;\n    this.origin.setFrom(transform.origin);\n  }\n}\n\n/** The placement of a GeometricElement2d. This includes the origin, rotation, and size (bounding box) of the element.\n * @public\n */\nexport class Placement2d implements Placement2dProps {\n  public constructor(public origin: Point2d, public angle: Angle, public bbox: ElementAlignedBox2d) { }\n  /** Get the rotation from local coordinates of this placement to world coordinates. */\n  public get rotation(): Matrix3d { return Matrix3d.createRotationAroundVector(Vector3d.unitZ(), this.angle)!; }\n  /** Get the transform from local coordinates of this placement to world coordinates. */\n  public get transform(): Transform { return Transform.createOriginAndMatrix(Point3d.createFrom(this.origin), this.rotation); }\n  /** Create a new Placement2d from a Placement2dProps. */\n  public static fromJSON(json?: Placement2dProps): Placement2d {\n    const props: any = json ? json : {};\n    return new Placement2d(Point2d.fromJSON(props.origin), Angle.fromJSON(props.angle), Range2d.fromJSON(props.bbox));\n  }\n  /** determine if this is 3d placement */\n  public get is3d(): boolean { return false; }\n\n  /** Get the 8 corners, in world coordinates, of this placement. */\n  public getWorldCorners(out?: Frustum): Frustum {\n    const frust = Frustum.fromRange(this.bbox, out);\n    frust.multiply(this.transform);\n    return frust;\n  }\n\n  /** Determine whether this Placement2d is valid. */\n  public get isValid(): boolean { return !this.bbox.isNull && Math.max(this.origin.maxAbs(), this.bbox.maxAbs()) < Constant.circumferenceOfEarth; }\n\n  /** Set the contents of this Placement2d from another Placement2d */\n  public setFrom(other: Placement2d) {\n    this.origin.setFrom(other.origin);\n    this.angle.setFrom(other.angle);\n    this.bbox.setFrom(other.bbox);\n  }\n\n  /** Calculate the axis-aligned bounding box for this placement. */\n  public calculateRange(): AxisAlignedBox3d {\n    const range = new Range3d();\n    if (!this.isValid)\n      return range;\n\n    this.transform.multiplyRange(Range3d.createRange2d(this.bbox, 0), range);\n\n    // low and high are not allowed to be equal\n    range.ensureMinLengths();\n    range.low.z = - 1.0;  // is the 2dFrustumDepth, which === 1 meter\n    range.high.z = 1.0;\n    return range;\n  }\n\n  /** Multiply the Transform of this Placement2d by the specified *other* Transform.\n   * @throws [[IModelError]] if the Transform is invalid for a GeometricElement2d.\n   */\n  public multiplyTransform(other: Transform): void {\n    const transform = other.multiplyTransformTransform(this.transform);\n    const angles = YawPitchRollAngles.createFromMatrix3d(transform.matrix);\n    if ((undefined === angles) || !angles.pitch.isAlmostZero || !angles.roll.isAlmostZero)\n      throw new IModelError(IModelStatus.BadRequest, \"Invalid Transform\");\n\n    this.angle = angles.yaw;\n    this.origin.setFrom(transform.origin);\n  }\n}\n"]}