@mlightcad/geometry-engine 1.0.0

package/lib/math/AcGeBox3d.js

@@ -0,0 +1,378 @@
+import { AcGeVector3d } from './AcGeVector3d';
+/**
+ * The class representing an axis-aligned bounding box (AABB) in 3d space.
+ */
+var AcGeBox3d = /** @class */ (function () {
+    /**
+     * Create a 3d box bounded by min and max.
+     * @param min (optional) Input the lower (x, y, z) boundary of the box.
+     * Set it to ( + Infinity, + Infinity, + Infinity ) if undefined or null provided.
+     * @param max (optional) Input the upper (x, y, z) boundary of the box.
+     * Set it to ( - Infinity, - Infinity, - Infinity ) if undefined or null provided.
+     */
+    function AcGeBox3d(min, max) {
+        if (min === void 0) { min = undefined; }
+        if (max === void 0) { max = undefined; }
+        this.min =
+            min == null
+                ? new AcGeVector3d(+Infinity, +Infinity, +Infinity)
+                : new AcGeVector3d(min.x, min.y, min.z);
+        this.max =
+            max == null
+                ? new AcGeVector3d(-Infinity, -Infinity, -Infinity)
+                : new AcGeVector3d(max.x, max.y, max.z);
+    }
+    /**
+     * Set the lower and upper (x, y, z) boundaries of this box.
+     * Please note that this method only copies the values from the given objects.
+     * @param min Input the lower (x, y, z) boundary of the box.
+     * @param max Input the upper (x, y, z) boundary of the box.
+     * @returns Return this box.
+     */
+    AcGeBox3d.prototype.set = function (min, max) {
+        this.min.copy(min);
+        this.max.copy(max);
+        return this;
+    };
+    /**
+     * Set the upper and lower bounds of this box to include all of the data in array.
+     * @param array Input an array of position data that the resulting box will envelop.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.setFromArray = function (array) {
+        this.makeEmpty();
+        for (var i = 0, il = array.length; i < il; i += 3) {
+            this.expandByPoint(_vector.fromArray(array, i));
+        }
+        return this;
+    };
+    /**
+     * Set the upper and lower bounds of this box to include all of the points in points.
+     * @param points Input an array of 3d point or 3d vector that the resulting box will contain.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.setFromPoints = function (points) {
+        this.makeEmpty();
+        for (var i = 0, il = points.length; i < il; i++) {
+            this.expandByPoint(points[i]);
+        }
+        return this;
+    };
+    /**
+     * Center this box on center and set this box's width, height and depth to the values specified in size
+     * @param center Input the desired center position of the box.
+     * @param size Input the desired x, y and z dimensions of the box.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.setFromCenterAndSize = function (center, size) {
+        var halfSize = _vector.copy(size).multiplyScalar(0.5);
+        this.min.copy(center).sub(halfSize);
+        this.max.copy(center).add(halfSize);
+        return this;
+    };
+    /**
+     * Return a new box with the same min and max as this one.
+     * @returns Return a new box with the same min and max as this one.
+     */
+    AcGeBox3d.prototype.clone = function () {
+        return new AcGeBox3d().copy(this);
+    };
+    /**
+     * Copy the min and max from box to this box.
+     * @param box Input box to copy.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.copy = function (box) {
+        this.min.copy(box.min);
+        this.max.copy(box.max);
+        return this;
+    };
+    /**
+     * Make this box empty.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.makeEmpty = function () {
+        this.min.x = this.min.y = this.min.z = +Infinity;
+        this.max.x = this.max.y = this.max.z = -Infinity;
+        return this;
+    };
+    /**
+     * Return true if this box includes zero points within its bounds.
+     * Note that a box with equal lower and upper bounds still includes one point, the one both bounds share.
+     * @returns Return true if this box includes zero points within its bounds.
+     */
+    AcGeBox3d.prototype.isEmpty = function () {
+        // this is a more robust check for empty than ( volume <= 0 ) because volume can get positive with two negative axes
+        return (this.max.x < this.min.x ||
+            this.max.y < this.min.y ||
+            this.max.z < this.min.z);
+    };
+    /**
+     * Return the center point of the box as a 3d vector.
+     * @param target Input the result copied into this 3d vector.
+     * @returns Return the center point of the box
+     */
+    AcGeBox3d.prototype.getCenter = function (target) {
+        return this.isEmpty()
+            ? target.set(0, 0, 0)
+            : target.addVectors(this.min, this.max).multiplyScalar(0.5);
+    };
+    /**
+     * Return the width, height and depth of this box.
+     * @param target Return the result copied into this 3d vector.
+     * @returns Return the width, height and depth of this box.
+     */
+    AcGeBox3d.prototype.getSize = function (target) {
+        return this.isEmpty()
+            ? target.set(0, 0, 0)
+            : target.subVectors(this.max, this.min);
+    };
+    Object.defineProperty(AcGeBox3d.prototype, "center", {
+        /**
+         * Center point of this box
+         */
+        get: function () {
+            return this.isEmpty()
+                ? new AcGeVector3d(0, 0, 0)
+                : new AcGeVector3d(0, 0, 0)
+                    .addVectors(this.min, this.max)
+                    .multiplyScalar(0.5);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcGeBox3d.prototype, "size", {
+        /**
+         * Return the width, height and depth of this box.
+         */
+        get: function () {
+            return this.isEmpty()
+                ? new AcGeVector3d(0, 0, 0)
+                : new AcGeVector3d(0, 0, 0).subVectors(this.max, this.min);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Expand the boundaries of this box to include point.
+     * @param point
+     * @returns
+     */
+    AcGeBox3d.prototype.expandByPoint = function (point) {
+        this.min.min(point);
+        this.max.max(point);
+        return this;
+    };
+    /**
+     * Expand this box equilaterally by vector. The width of this box will be expanded by the x component
+     * of vector in both directions. The height of this box will be expanded by the y component of vector
+     * in both directions. The depth of this box will be expanded by the z component of vector in both
+     * directions.
+     * @param vector Input one 3d vector to expand the box by.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.expandByVector = function (vector) {
+        this.min.sub(vector);
+        this.max.add(vector);
+        return this;
+    };
+    /**
+     * Expand each dimension of the box by scalar. If negative, the dimensions of the box will be contracted.
+     * @param scalar Input distance to expand the box by.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.expandByScalar = function (scalar) {
+        this.min.addScalar(-scalar);
+        this.max.addScalar(scalar);
+        return this;
+    };
+    /**
+     * Return true if the specified point lies within or on the boundaries of this box.
+     * @param point Input point to check for inclusion.
+     * @returns Return true if the specified point lies within or on the boundaries of this box.
+     */
+    AcGeBox3d.prototype.containsPoint = function (point) {
+        return point.x < this.min.x ||
+            point.x > this.max.x ||
+            point.y < this.min.y ||
+            point.y > this.max.y ||
+            point.z < this.min.z ||
+            point.z > this.max.z
+            ? false
+            : true;
+    };
+    /**
+     * Return true if this box includes the entirety of box. If this and box are identical,
+     * this function also returns true.
+     * @param box Input 3d box to test for inclusion.
+     * @returns Return true if this box includes the entirety of box.
+     */
+    AcGeBox3d.prototype.containsBox = function (box) {
+        return (this.min.x <= box.min.x &&
+            box.max.x <= this.max.x &&
+            this.min.y <= box.min.y &&
+            box.max.y <= this.max.y &&
+            this.min.z <= box.min.z &&
+            box.max.z <= this.max.z);
+    };
+    /**
+     * Return a point as a proportion of this box's width, height and depth.
+     * @param point Input one point
+     * @param target Input the result will be copied into this Vector3.
+     * @returns Return one point
+     */
+    AcGeBox3d.prototype.getParameter = function (point, target) {
+        // This can potentially have a divide by zero if the box
+        // has a size dimension of 0.
+        return target.set((point.x - this.min.x) / (this.max.x - this.min.x), (point.y - this.min.y) / (this.max.y - this.min.y), (point.z - this.min.z) / (this.max.z - this.min.z));
+    };
+    /**
+     * Determine whether or not this box intersects box.
+     * @param box Input 3d box to check for intersection against.
+     * @returns Return true if this box intersects the specified box.
+     */
+    AcGeBox3d.prototype.intersectsBox = function (box) {
+        // using 6 splitting planes to rule out intersections.
+        return box.max.x < this.min.x ||
+            box.min.x > this.max.x ||
+            box.max.y < this.min.y ||
+            box.min.y > this.max.y ||
+            box.max.z < this.min.z ||
+            box.min.z > this.max.z
+            ? false
+            : true;
+    };
+    /**
+     * Determine whether or not this box intersects plane.
+     * @param plane Input the plane to check for intersection against.
+     * @returns Return true if this box intersects the specified plane.
+     */
+    AcGeBox3d.prototype.intersectsPlane = function (plane) {
+        // We compute the minimum and maximum dot product values. If those values
+        // are on the same side (back or front) of the plane, then there is no intersection.
+        var min, max;
+        if (plane.normal.x > 0) {
+            min = plane.normal.x * this.min.x;
+            max = plane.normal.x * this.max.x;
+        }
+        else {
+            min = plane.normal.x * this.max.x;
+            max = plane.normal.x * this.min.x;
+        }
+        if (plane.normal.y > 0) {
+            min += plane.normal.y * this.min.y;
+            max += plane.normal.y * this.max.y;
+        }
+        else {
+            min += plane.normal.y * this.max.y;
+            max += plane.normal.y * this.min.y;
+        }
+        if (plane.normal.z > 0) {
+            min += plane.normal.z * this.min.z;
+            max += plane.normal.z * this.max.z;
+        }
+        else {
+            min += plane.normal.z * this.max.z;
+            max += plane.normal.z * this.min.z;
+        }
+        return min <= -plane.constant && max >= -plane.constant;
+    };
+    /**
+     * Clamp the point within the bounds of this box.
+     * @param point Input the point to clamp.
+     * @param target Input the result will be copied into this 3d vector.
+     * @returns Return the target
+     */
+    AcGeBox3d.prototype.clampPoint = function (point, target) {
+        return target.copy(point).clamp(this.min, this.max);
+    };
+    /**
+     * Returns the distance from any edge of this box to the specified point. If the point lies inside of
+     * this box, the distance will be 0.
+     * @param point Input one 3d point to measure distance to.
+     * @returns Return the distance from any edge of this box to the specified point.
+     */
+    AcGeBox3d.prototype.distanceToPoint = function (point) {
+        return this.clampPoint(point, _vector).distanceTo(point);
+    };
+    /**
+     * Compute the intersection of this and box, setting the upper bound of this box to the lesser of the
+     * two boxes' upper bounds and the lower bound of this box to the greater of the two boxes' lower bounds.
+     * If there's no overlap, makes this box empty.
+     * @param box Input 3d box to intersect with.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.intersect = function (box) {
+        this.min.max(box.min);
+        this.max.min(box.max);
+        // ensure that if there is no overlap, the result is fully empty, not slightly empty with non-inf/+inf values that will cause subsequence intersects to erroneously return valid values.
+        if (this.isEmpty())
+            this.makeEmpty();
+        return this;
+    };
+    /**
+     * Compute the union of this box and box, setting the upper bound of this box to the greater of the two
+     * boxes' upper bounds and the lower bound of this box to the lesser of the two boxes' lower bounds.
+     * @param box Input the 3d box that will be unioned with this box.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.union = function (box) {
+        this.min.min(box.min);
+        this.max.max(box.max);
+        return this;
+    };
+    /**
+     * Transform this box with the supplied matrix.
+     * @param matrix Input 4x4 matrix to apply
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.applyMatrix4 = function (matrix) {
+        // transform of empty box is an empty box.
+        if (this.isEmpty())
+            return this;
+        // NOTE: I am using a binary pattern to specify all 2^3 combinations below
+        _points[0].set(this.min.x, this.min.y, this.min.z).applyMatrix3d(matrix); // 000
+        _points[1].set(this.min.x, this.min.y, this.max.z).applyMatrix3d(matrix); // 001
+        _points[2].set(this.min.x, this.max.y, this.min.z).applyMatrix3d(matrix); // 010
+        _points[3].set(this.min.x, this.max.y, this.max.z).applyMatrix3d(matrix); // 011
+        _points[4].set(this.max.x, this.min.y, this.min.z).applyMatrix3d(matrix); // 100
+        _points[5].set(this.max.x, this.min.y, this.max.z).applyMatrix3d(matrix); // 101
+        _points[6].set(this.max.x, this.max.y, this.min.z).applyMatrix3d(matrix); // 110
+        _points[7].set(this.max.x, this.max.y, this.max.z).applyMatrix3d(matrix); // 111
+        this.setFromPoints(_points);
+        return this;
+    };
+    /**
+     * Add offset to both the upper and lower bounds of this box, effectively moving this box offset units
+     * in 3d space.
+     * @param offset Input direction and distance of offset.
+     * @returns Return this box
+     */
+    AcGeBox3d.prototype.translate = function (offset) {
+        this.min.add(offset);
+        this.max.add(offset);
+        return this;
+    };
+    /**
+     * Return true if this box and box share the same lower and upper bounds.
+     * @param box Input box to compare with this one.
+     * @returns Return true if this box and box share the same lower and upper bounds.
+     */
+    AcGeBox3d.prototype.equals = function (box) {
+        return box.min.equals(this.min) && box.max.equals(this.max);
+    };
+    return AcGeBox3d;
+}());
+export { AcGeBox3d };
+var _points = [
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d(),
+    /*@__PURE__*/ new AcGeVector3d()
+];
+var _vector = /*@__PURE__*/ new AcGeVector3d();
+//# sourceMappingURL=AcGeBox3d.js.map

package/lib/math/AcGeBox3d.js.map

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

package/lib/math/AcGeEuler.d.ts

@@ -0,0 +1,133 @@
+import { AcGeMatrix3d } from './AcGeMatrix3d';
+import { AcGeQuaternion } from './AcGeQuaternion';
+import { AcGeVector3d } from './AcGeVector3d';
+export declare class AcGeEuler {
+    static DEFAULT_ORDER: string;
+    private _x;
+    private _y;
+    private _z;
+    private _order;
+    /**
+     * Create one instance of this class
+     * @param x (optional) the angle of the x axis in radians. Default is 0.
+     * @param y (optional) the angle of the y axis in radians. Default is 0.
+     * @param z (optional) the angle of the z axis in radians. Default is 0.
+     * @param order (optional) a string representing the order that the rotations are applied,
+     * defaults to 'XYZ' (must be upper case).
+     */
+    constructor(x?: number, y?: number, z?: number, order?: string);
+    /**
+     * The current value of the x component.
+     */
+    get x(): number;
+    set x(value: number);
+    /**
+     * The current value of the y component.
+     */
+    get y(): number;
+    set y(value: number);
+    /**
+     * The current value of the z component.
+     */
+    get z(): number;
+    set z(value: number);
+    /**
+     * The order in which to apply rotations. Default is 'XYZ', which means that the object will first be
+     * rotated around its X axis, then its Y axis and finally its Z axis. Other possibilities are: 'YZX',
+     * 'ZXY', 'XZY', 'YXZ' and 'ZYX'. These must be in upper case.
+     *
+     * It uses intrinsic Tait-Bryan angles. This means that rotations are performed with respect to the
+     * local coordinate system. That is, for order 'XYZ', the rotation is first around the local-X axis
+     * (which is the same as the world-X axis), then around local-Y (which may now be different from the
+     * world Y-axis), then local-Z (which may be different from the world Z-axis).
+     */
+    get order(): string;
+    set order(value: string);
+    /**
+     * Set the angles of this euler transform and optionally the order.
+     * @param x (optional) the angle of the x axis in radians. Default is 0.
+     * @param y (optional) the angle of the y axis in radians. Default is 0.
+     * @param z (optional) the angle of the z axis in radians. Default is 0.
+     * @param order (optional) a string representing the order that the rotations are applied,
+     * defaults to 'XYZ' (must be upper case).
+     * @returns Return this euler
+     */
+    set(x: number, y: number, z: number, order?: string): this;
+    /**
+     * Return a new Euler with the same parameters as this one.
+     * @returns Return a new Euler with the same parameters as this one.
+     */
+    clone(): AcGeEuler;
+    /**
+     * Copy value of euler to this euler.
+     * @param euler Input the eurler copied from
+     * @returns Return this euler
+     */
+    copy(euler: AcGeEuler): this;
+    /**
+     * Set this euler by exatracting rotation information from the specified matrix.
+     * @param m Input a Matrix4 of which the upper 3x3 of matrix is a pure rotation matrix (i.e. unscaled).
+     * @param order (optional) a string representing the order that the rotations are applied. Sets the
+     * angles of this euler transform from a pure rotation matrix based on the orientation specified by
+     * order.
+     * @param update Input one flag to indicate whether to trigger change callback function
+     * @returns Return this euler
+     */
+    setFromRotationMatrix(m: AcGeMatrix3d, order?: string, update?: boolean): this;
+    /**
+     * Set this urler from the specified quaternion.
+     * @param q Input a normalized quaternion.
+     * @param order (optional) a string representing the order that the rotations are applied. Sets the
+     * angles of this euler transform from a pure rotation matrix based on the orientation specified by
+     * order.
+     * @param update Input one flag to indicate whether to trigger change callback function
+     * @returns Return this euler
+     */
+    setFromQuaternion(q: AcGeQuaternion, order: string, update?: boolean): this;
+    /**
+     * Set the x, y and z, and optionally update the order.
+     * @param v Input one 3d vector
+     * @param order Input a optional string representing the order that the rotations are applied.
+     * @returns Return this euler
+     */
+    setFromVector3(v: AcGeVector3d, order?: string): this;
+    /**
+     * Resets the euler angle with a new order by creating a quaternion from this euler angle and then
+     * setting this euler angle with the quaternion and the new order.
+     * @param newOrder Input the new order that the rotations are applied.
+     * @returns Return this euler
+     */
+    reorder(newOrder: string): this;
+    /**
+     * Check for strict equality of this euler and euler.
+     * @param euler Input the euler to compare
+     * @returns Return true if the specified euler and this euler represent the same rotation.
+     */
+    equals(euler: AcGeEuler): boolean;
+    /**
+     * Set this euler from the specified array.
+     * @param array Input an array of length 3 or 4. The optional 4th argument corresponds to the order.
+     * - Assign this euler's x angle to array[0].
+     * - Assign this euler's y angle to array[1].
+     * - Assign this euler's z angle to array[2].
+     * - Optionally assign this euler's order to array[3].
+     * @returns
+     */
+    fromArray(array: (number | string)[]): this;
+    /**
+     * Return an array of the form [x, y, z, order ].
+     * @param array Input an optional array to store the euler in.
+     * @param offset Input an optional offset in the array.
+     * @returns Return an array of the form [x, y, z, order].
+     */
+    toArray(array?: (number | string)[], offset?: number): (string | number)[];
+    /**
+     * Trigger the specified callback function once this euler changes
+     * @param callback
+     * @returns
+     */
+    _onChange(callback: () => void): this;
+    _onChangeCallback(): void;
+    [Symbol.iterator](): Generator<string | number, void, unknown>;
+}
+//# sourceMappingURL=AcGeEuler.d.ts.map

package/lib/math/AcGeEuler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcGeEuler.d.ts","sourceRoot":"","sources":["../../src/math/AcGeEuler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAK7C,qBAAa,SAAS;IACpB,MAAM,CAAC,aAAa,SAAQ;IAC5B,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,EAAE,CAAQ;IAClB,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;;;;OAOG;gBACS,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,KAAK,SAA0B;IAOhE;;OAEG;IACH,IAAI,CAAC,IAGQ,MAAM,CADlB;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAGlB;IAED;;OAEG;IACH,IAAI,CAAC,IAGQ,MAAM,CADlB;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAGlB;IAED;;OAEG;IACH,IAAI,CAAC,IAGQ,MAAM,CADlB;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAGlB;IAED;;;;;;;;;OASG;IACH,IAAI,KAAK,IAGQ,MAAM,CADtB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAc;IAWxD;;;OAGG;IACH,KAAK;IAIL;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS;IAUrB;;;;;;;;OAQG;IACH,qBAAqB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,SAAc,EAAE,MAAM,UAAO;IAwGzE;;;;;;;;OAQG;IACH,iBAAiB,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc;IAK1E;;;;;OAKG;IACH,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,SAAc;IAInD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM;IAMxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS;IASvB;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAWpC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,EAAE,MAAM,SAAI;IASnD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI;IAK9B,iBAAiB;IAEhB,CAAC,MAAM,CAAC,QAAQ,CAAC;CAMnB"}