melonjs 17.3.0 → 18.0.0

package/src/math/matrix3.js

@@ -1,613 +0,0 @@
-import pool from "./../system/pooling.js";
-import { EPSILON } from "./math.js";
-
-/**
- * @classdesc
- * a 4x4 Matrix3d Object
- */
-export default class Matrix3d {
-    /**
-     * @param {(Matrix3d|...number)} args - An instance of me.Matrix3d to copy from, or individual Matrix components (See {@link Matrix3d.setTransform}). If not arguments are given, the matrix will be set to Identity.
-     */
-    constructor(...args) {
-        this.onResetEvent(...args);
-    }
-
-    /**
-     * @ignore
-     */
-    onResetEvent() {
-        const arg0 = arguments[0];
-        const argLen = arguments.length;
-
-        if (typeof this.val === "undefined") {
-            this.val = new Float32Array(16);
-        }
-
-        if (argLen === 1 && arg0.val.length === 16) {
-            // matrix3d
-            this.copy(arg0);
-        } else if (argLen === 16) {
-            // individual components
-            this.setTransform.apply(this, arguments);
-        } else {
-            // invalid or no arguments
-            this.identity();
-        }
-    }
-
-    /**
-     * tx component of the matrix
-     * @type {number}
-     */
-    get tx() {
-        return this.val[12];
-    }
-
-    /**
-     * ty component of the matrix
-     * @type {number}
-     */
-    get ty() {
-        return this.val[13];
-    }
-
-    /**
-     * ty component of the matrix
-     * @type {number}
-     */
-    get tz() {
-        return this.val[14];
-    }
-
-    /**
-     * reset the transformation matrix to the identity matrix (no transformation).<br>
-     * the identity matrix and parameters position : <br>
-     * <img src="images/identity-matrix_2x.png"/>
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    identity() {
-        return this.setTransform(
-            1, 0, 0, 0,
-            0, 1, 0, 0,
-            0, 0, 1, 0,
-            0, 0, 0, 1
-        );
-    }
-
-    /**
-     * set the matrix to the specified value
-     * @param {number} m00
-     * @param {number} m01
-     * @param {number} m02
-     * @param {number} m03
-     * @param {number} m10
-     * @param {number} m11
-     * @param {number} m12
-     * @param {number} m13
-     * @param {number} m20
-     * @param {number} m21
-     * @param {number} m22
-     * @param {number} m23
-     * @param {number} m30
-     * @param {number} m31
-     * @param {number} m32
-     * @param {number} m33
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    setTransform(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {
-        let a = this.val;
-
-        a[0] = m00;
-        a[1] = m01;
-        a[2] = m02;
-        a[3] = m03;
-        a[4] = m10;
-        a[5] = m11;
-        a[6] = m12;
-        a[7] = m13;
-        a[8] = m20;
-        a[9] = m21;
-        a[10] = m22;
-        a[11] = m23;
-        a[12] = m30;
-        a[13] = m31;
-        a[14] = m32;
-        a[15] = m33;
-
-        return this;
-    }
-
-    /**
-     * Copies over the values from another me.Matrix3d.
-     * @param {Matrix3d} m - the matrix object to copy from
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    copy(m) {
-        this.val.set(m.val);
-        return this;
-    }
-
-    /**
-     * Copies over the upper-left 2x2 values from the given me.Matrix2d
-     * @param {Matrix2d} m - the matrix object to copy from
-     * @returns {Matrix2d} Reference to this object for method chaining
-     */
-    fromMat2d(m) {
-        let b = m.val;
-        return this.setTransform(
-            b[0], b[3], b[6], 0,
-            b[1], b[4], b[7], 0,
-            b[2], b[5], b[8], 0,
-            0,    0,    0,    1
-
-        );
-    }
-
-    /**
-     * multiply both matrix
-     * @param {Matrix3d} m - Other matrix
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    multiply(m) {
-        let a = this.val;
-        let b = m.val;
-
-        let a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3];
-        let a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7];
-        let a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11];
-        let a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15];
-        let b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3];
-
-        a[0] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;
-        a[1] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;
-        a[2] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;
-        a[3] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;
-
-        b0 = b[4];
-        b1 = b[5];
-        b2 = b[6];
-        b3 = b[7];
-
-        a[4] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;
-        a[5] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;
-        a[6] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;
-        a[7] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;
-
-        b0 = b[8];
-        b1 = b[9];
-        b2 = b[10];
-        b3 = b[11];
-
-        a[8] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;
-        a[9] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;
-        a[10] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;
-        a[11] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;
-
-        b0 = b[12];
-        b1 = b[13];
-        b2 = b[14];
-        b3 = b[15];
-
-        a[12] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;
-        a[13] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;
-        a[14] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;
-        a[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;
-
-        return this;
-    }
-
-    /**
-     * Transpose the value of this matrix.
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    transpose() {
-        let a = this.val,
-            a01 = a[1],
-            a02 = a[2],
-            a03 = a[3],
-            a12 = a[6],
-            a13 = a[7],
-            a23 = a[11];
-
-        a[1] = a[4];
-        a[2] = a[8];
-        a[3] = a[12];
-        a[4] = a01;
-        a[6] = a[9];
-        a[7] = a[13];
-        a[8] = a02;
-        a[9] = a12;
-        a[11] = a[14];
-        a[12] = a03;
-        a[13] = a13;
-        a[14] = a23;
-
-        return this;
-    }
-
-    /**
-     * invert this matrix, causing it to apply the opposite transformation.
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    invert() {
-        let a = this.val;
-
-        let a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3];
-        let a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7];
-        let a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11];
-        let a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15];
-
-        let b00 = a00 * a11 - a01 * a10;
-        let b01 = a00 * a12 - a02 * a10;
-        let b02 = a00 * a13 - a03 * a10;
-        let b03 = a01 * a12 - a02 * a11;
-
-        let b04 = a01 * a13 - a03 * a11;
-        let b05 = a02 * a13 - a03 * a12;
-        let b06 = a20 * a31 - a21 * a30;
-        let b07 = a20 * a32 - a22 * a30;
-
-        let b08 = a20 * a33 - a23 * a30;
-        let b09 = a21 * a32 - a22 * a31;
-        let b10 = a21 * a33 - a23 * a31;
-        let b11 = a22 * a33 - a23 * a32;
-
-        // Calculate the determinant
-        let det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;
-
-        if (!det)
-        {
-            return null;
-        }
-
-        det = 1 / det;
-
-        a[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;
-        a[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det;
-        a[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det;
-        a[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det;
-        a[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det;
-        a[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det;
-        a[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det;
-        a[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det;
-        a[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det;
-        a[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det;
-        a[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det;
-        a[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det;
-        a[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det;
-        a[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det;
-        a[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det;
-        a[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det;
-
-        return this;
-    }
-
-    /**
-     * apply the current transform to the given 2d or 3d vector
-     * @param {Vector2d|Vector3d} v - the vector object to be transformed
-     * @returns {Vector2d|Vector3d} result vector object.
-     */
-    apply(v) {
-        let a = this.val,
-            x = v.x,
-            y = v.y,
-            z = (typeof v.z !== "undefined") ? v.z : 1;
-
-        let w = (a[3] * x + a[7] * y + a[11] * z + a[15]) || 1.0;
-
-        v.x = (a[0] * x + a[4] * y + a[8] * z + a[12]) / w;
-        v.y = (a[1] * x + a[5] * y + a[9] * z + a[13]) / w;
-
-        if (typeof v.z !== "undefined") {
-            v.z = (a[2] * x + a[6] * y + a[10] * z + a[14]) / w;
-        }
-
-        return v;
-    }
-
-    /**
-      * apply the inverted current transform to the given 2d or 3d vector
-      * @param {Vector2d|Vector3d} v - the vector object to be transformed
-      * @returns {Vector2d|Vector3d} result vector object.
-      */
-    applyInverse(v) {
-        // invert the current matrix
-        let im = pool.pull("Matrix3d", this).invert();
-
-        // apply the inverted matrix
-        im.apply(v);
-
-        pool.push(im);
-
-        return v;
-    }
-
-    /**
-     * generate an orthogonal projection matrix, with the result replacing the current matrix
-     * <img src="images/glOrtho.gif"/><br>
-     * @param {number} left - farthest left on the x-axis
-     * @param {number} right - farthest right on the x-axis
-     * @param {number} bottom - farthest down on the y-axis
-     * @param {number} top - farthest up on the y-axis
-     * @param {number} near - distance to the near clipping plane along the -Z axis
-     * @param {number} far - distance to the far clipping plane along the -Z axis
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    ortho(left, right, bottom, top, near, far) {
-        let a = this.val;
-        let leftRight = 1.0 / (left - right);
-        let bottomTop = 1.0 / (bottom - top);
-        let nearFar = 1.0 / (near - far);
-
-        a[0] = -2.0 * leftRight;
-        a[1] = 0.0;
-        a[2] = 0.0;
-        a[3] = 0.0;
-        a[4] = 0.0;
-        a[5] = -2.0 * bottomTop;
-        a[6] = 0.0;
-        a[7] = 0.0;
-        a[8] = 0.0;
-        a[9] = 0.0;
-        a[10] = 2.0 * nearFar;
-        a[11] = 0.0;
-        a[12] = (left + right) * leftRight;
-        a[13] = (top + bottom) * bottomTop;
-        a[14] = (far + near) * nearFar;
-        a[15] = 1.0;
-
-        return this;
-    }
-
-    /**
-     * scale the matrix
-     * @param {number} x - a number representing the abscissa of the scaling vector.
-     * @param {number} [y=x] - a number representing the ordinate of the scaling vector.
-     * @param {number} [z=0] - a number representing the depth vector
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    scale(x, y = x, z = 0) {
-        let a = this.val;
-
-        a[0] = a[0] * x;
-        a[1] = a[1] * x;
-        a[2] = a[2] * x;
-        a[3] = a[3] * x;
-
-        a[4] = a[4] * y;
-        a[5] = a[5] * y;
-        a[6] = a[6] * y;
-        a[7] = a[7] * y;
-
-        a[8] = a[8] * z;
-        a[9] = a[9] * z;
-        a[10] = a[10] * z;
-        a[11] = a[11] * z;
-
-        return this;
-    }
-
-    /**
-     * adds a 2D scaling transformation.
-     * @param {Vector2d|Vector3d} v - scaling vector
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    scaleV(v) {
-        return this.scale(v.x, v.y, v.z);
-    }
-
-    /**
-     * specifies a 2D scale operation using the [sx, 1] scaling vector
-     * @param {number} x - x scaling vector
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    scaleX(x) {
-        return this.scale(x, 1);
-    }
-
-    /**
-     * specifies a 2D scale operation using the [1,sy] scaling vector
-     * @param {number} y - y scaling vector
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    scaleY(y) {
-        return this.scale(1, y);
-    }
-
-    /**
-     * rotate this matrix (counter-clockwise) by the specified angle (in radians).
-     * @param {number} angle - Rotation angle in radians.
-     * @param {Vector3d} v - the axis to rotate around
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    rotate(angle, v) {
-        if (angle !== 0) {
-            let a = this.val,
-                x = v.x,
-                y = v.y,
-                z = v.z;
-
-            let len = Math.sqrt(x * x + y * y + z * z);
-
-            let s, c, t;
-            let a00, a01, a02, a03;
-            let a10, a11, a12, a13;
-            let a20, a21, a22, a23;
-            let b00, b01, b02;
-            let b10, b11, b12;
-            let b20, b21, b22;
-
-            if (len < EPSILON) {
-                return null;
-            }
-
-            len = 1 / len;
-            x *= len;
-            y *= len;
-            z *= len;
-
-            s = Math.sin(angle);
-            c = Math.cos(angle);
-            t = 1 - c;
-
-            a00 = a[0];
-            a01 = a[1];
-            a02 = a[2];
-            a03 = a[3];
-            a10 = a[4];
-            a11 = a[5];
-            a12 = a[6];
-            a13 = a[7];
-            a20 = a[8];
-            a21 = a[9];
-            a22 = a[10];
-            a23 = a[11];
-
-            // Construct the elements of the rotation matrix
-            b00 = x * x * t + c;
-            b01 = y * x * t + z * s;
-            b02 = z * x * t - y * s;
-            b10 = x * y * t - z * s;
-            b11 = y * y * t + c;
-            b12 = z * y * t + x * s;
-            b20 = x * z * t + y * s;
-            b21 = y * z * t - x * s;
-            b22 = z * z * t + c;
-
-            // Perform rotation-specific matrix multiplication
-            a[0] = a00 * b00 + a10 * b01 + a20 * b02;
-            a[1] = a01 * b00 + a11 * b01 + a21 * b02;
-            a[2] = a02 * b00 + a12 * b01 + a22 * b02;
-            a[3] = a03 * b00 + a13 * b01 + a23 * b02;
-            a[4] = a00 * b10 + a10 * b11 + a20 * b12;
-            a[5] = a01 * b10 + a11 * b11 + a21 * b12;
-            a[6] = a02 * b10 + a12 * b11 + a22 * b12;
-            a[7] = a03 * b10 + a13 * b11 + a23 * b12;
-            a[8] = a00 * b20 + a10 * b21 + a20 * b22;
-            a[9] = a01 * b20 + a11 * b21 + a21 * b22;
-            a[10] = a02 * b20 + a12 * b21 + a22 * b22;
-            a[11] = a03 * b20 + a13 * b21 + a23 * b22;
-        }
-        return this;
-    }
-
-    /**
-     * translate the matrix position using the given vector
-     * @param {number|Vector2d|Vector3d} x - a number representing the abscissa of the vector, or a vector object
-     * @param {number} [y] - a number representing the ordinate of the vector.
-     * @param {number} [z=0] - a number representing the depth of the vector
-     * @returns {Matrix3d} Reference to this object for method chaining
-     */
-    translate() {
-        let a = this.val;
-        let _x, _y, _z;
-
-        if (arguments.length > 1) {
-            // x, y (, z)
-            _x = arguments[0];
-            _y = arguments[1];
-            _z = typeof(arguments[2]) === "undefined" ?  0 : arguments[2];
-        } else {
-            // 2d/3d vector
-            _x = arguments[0].x;
-            _y = arguments[0].y;
-            _z = typeof(arguments[0].z) === "undefined" ? 0 : arguments[0].z;
-        }
-
-        a[12] = a[0] * _x + a[4] * _y + a[8] * _z + a[12];
-        a[13] = a[1] * _x + a[5] * _y + a[9] * _z + a[13];
-        a[14] = a[2] * _x + a[6] * _y + a[10] * _z + a[14];
-        a[15] = a[3] * _x + a[7] * _y + a[11] * _z + a[15];
-
-        return this;
-    }
-
-    /**
-     * returns true if the matrix is an identity matrix.
-     * @returns {boolean}
-     */
-    isIdentity() {
-        let a = this.val;
-
-        return (
-            (a[0] === 1) &&
-            (a[1] === 0) &&
-            (a[2] === 0) &&
-            (a[3] === 0) &&
-            (a[4] === 0) &&
-            (a[5] === 1) &&
-            (a[6] === 0) &&
-            (a[7] === 0) &&
-            (a[8] === 0) &&
-            (a[9] === 0) &&
-            (a[10] === 1) &&
-            (a[11] === 0) &&
-            (a[12] === 0) &&
-            (a[13] === 0) &&
-            (a[14] === 0) &&
-            (a[15] === 1)
-        );
-    }
-
-    /**
-     * return true if the two matrices are identical
-     * @param {Matrix3d} m - the other matrix
-     * @returns {boolean} true if both are equals
-     */
-    equals(m) {
-        let b = m.val;
-        let a = this.val;
-
-        return (
-            (a[0] === b[0]) &&
-            (a[1] === b[1]) &&
-            (a[2] === b[2]) &&
-            (a[3] === b[3]) &&
-            (a[4] === b[4]) &&
-            (a[5] === b[5]) &&
-            (a[6] === b[6]) &&
-            (a[7] === b[7]) &&
-            (a[8] === b[8]) &&
-            (a[9] === b[9]) &&
-            (a[10] === b[10]) &&
-            (a[11] === b[11]) &&
-            (a[12] === b[12]) &&
-            (a[13] === b[13]) &&
-            (a[14] === b[14]) &&
-            (a[15] === b[15])
-        );
-    }
-
-    /**
-     * Clone the Matrix
-     * @returns {Matrix3d}
-     */
-    clone() {
-        return pool.pull("Matrix3d", this);
-    }
-
-    /**
-     * return an array representation of this Matrix
-     * @returns {Float32Array}
-     */
-    toArray() {
-        return this.val;
-    }
-
-    /**
-     * convert the object to a string representation
-     * @returns {string}
-     */
-    toString() {
-        let a = this.val;
-
-        return "me.Matrix3d(" +
-            a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ", " +
-            a[4] + ", " + a[5] + ", " + a[6] + ", " + a[7] + ", " +
-            a[8] + ", " + a[9] + ", " + a[10] + ", " + a[11] + ", " +
-            a[12] + ", " + a[13] + ", " + a[14] + ", " + a[15] +
-        ")";
-    }
-}
-