@math.gl/core 3.5.7 → 3.6.0-alpha.3

package/dist/classes/matrix3.js

@@ -0,0 +1,201 @@
+// Copyright (c) 2017 Uber Technologies, Inc.
+// MIT License
+import Matrix from './base/matrix';
+import { checkVector } from '../lib/validators';
+/* eslint-disable camelcase */
+import { vec4_transformMat3 } from '../lib/gl-matrix-extras';
+import * as mat3 from 'gl-matrix/mat3';
+import * as vec2 from 'gl-matrix/vec2';
+import * as vec3 from 'gl-matrix/vec3';
+var INDICES;
+(function (INDICES) {
+    INDICES[INDICES["COL0ROW0"] = 0] = "COL0ROW0";
+    INDICES[INDICES["COL0ROW1"] = 1] = "COL0ROW1";
+    INDICES[INDICES["COL0ROW2"] = 2] = "COL0ROW2";
+    INDICES[INDICES["COL1ROW0"] = 3] = "COL1ROW0";
+    INDICES[INDICES["COL1ROW1"] = 4] = "COL1ROW1";
+    INDICES[INDICES["COL1ROW2"] = 5] = "COL1ROW2";
+    INDICES[INDICES["COL2ROW0"] = 6] = "COL2ROW0";
+    INDICES[INDICES["COL2ROW1"] = 7] = "COL2ROW1";
+    INDICES[INDICES["COL2ROW2"] = 8] = "COL2ROW2";
+})(INDICES || (INDICES = {}));
+const IDENTITY_MATRIX = Object.freeze([1, 0, 0, 0, 1, 0, 0, 0, 1]);
+export default class Matrix3 extends Matrix {
+    static get IDENTITY() {
+        return getIdentityMatrix();
+    }
+    static get ZERO() {
+        return getZeroMatrix();
+    }
+    get ELEMENTS() {
+        return 9;
+    }
+    get RANK() {
+        return 3;
+    }
+    get INDICES() {
+        return INDICES;
+    }
+    constructor(array, ...args) {
+        // PERF NOTE: initialize elements as double precision numbers
+        super(-0, -0, -0, -0, -0, -0, -0, -0, -0);
+        if (arguments.length === 1 && Array.isArray(array)) {
+            this.copy(array);
+        }
+        else if (args.length > 0) {
+            this.copy([array, ...args]);
+        }
+        else {
+            this.identity();
+        }
+    }
+    copy(array) {
+        // Element wise copy for performance
+        this[0] = array[0];
+        this[1] = array[1];
+        this[2] = array[2];
+        this[3] = array[3];
+        this[4] = array[4];
+        this[5] = array[5];
+        this[6] = array[6];
+        this[7] = array[7];
+        this[8] = array[8];
+        return this.check();
+    }
+    // Constructors
+    identity() {
+        return this.copy(IDENTITY_MATRIX);
+    }
+    /**
+     *
+     * @param object
+     * @returns self
+     */
+    fromObject(object) {
+        return this.check();
+    }
+    // Calculates a 3x3 matrix from the given quaternion
+    // q quat  Quaternion to create matrix from
+    fromQuaternion(q) {
+        mat3.fromQuat(this, q);
+        return this.check();
+    }
+    /**
+     * accepts column major order, stores in column major order
+     */
+    // eslint-disable-next-line max-params
+    set(m00, m10, m20, m01, m11, m21, m02, m12, m22) {
+        this[0] = m00;
+        this[1] = m10;
+        this[2] = m20;
+        this[3] = m01;
+        this[4] = m11;
+        this[5] = m21;
+        this[6] = m02;
+        this[7] = m12;
+        this[8] = m22;
+        return this.check();
+    }
+    /**
+     * accepts row major order, stores as column major
+     */
+    // eslint-disable-next-line max-params
+    setRowMajor(m00, m01, m02, m10, m11, m12, m20, m21, m22) {
+        this[0] = m00;
+        this[1] = m10;
+        this[2] = m20;
+        this[3] = m01;
+        this[4] = m11;
+        this[5] = m21;
+        this[6] = m02;
+        this[7] = m12;
+        this[8] = m22;
+        return this.check();
+    }
+    // Accessors
+    determinant() {
+        return mat3.determinant(this);
+    }
+    // Modifiers
+    transpose() {
+        mat3.transpose(this, this);
+        return this.check();
+    }
+    /** Invert a matrix. Note that this can fail if the matrix is not invertible */
+    invert() {
+        mat3.invert(this, this);
+        return this.check();
+    }
+    // Operations
+    multiplyLeft(a) {
+        mat3.multiply(this, a, this);
+        return this.check();
+    }
+    multiplyRight(a) {
+        mat3.multiply(this, this, a);
+        return this.check();
+    }
+    rotate(radians) {
+        mat3.rotate(this, this, radians);
+        return this.check();
+    }
+    scale(factor) {
+        if (Array.isArray(factor)) {
+            mat3.scale(this, this, factor);
+        }
+        else {
+            mat3.scale(this, this, [factor, factor]);
+        }
+        return this.check();
+    }
+    translate(vec) {
+        mat3.translate(this, this, vec);
+        return this.check();
+    }
+    // Transforms
+    transform(vector, result) {
+        switch (vector.length) {
+            case 2:
+                result = vec2.transformMat3(result || [-0, -0], vector, this);
+                break;
+            case 3:
+                result = vec3.transformMat3(result || [-0, -0, -0], vector, this);
+                break;
+            case 4:
+                result = vec4_transformMat3(result || [-0, -0, -0, -0], vector, this);
+                break;
+            default:
+                throw new Error('Illegal vector');
+        }
+        checkVector(result, vector.length);
+        return result;
+    }
+    /** @deprecated */
+    transformVector(vector, result) {
+        return this.transform(vector, result);
+    }
+    /** @deprecated */
+    transformVector2(vector, result) {
+        return this.transform(vector, result);
+    }
+    /** @deprecated */
+    transformVector3(vector, result) {
+        return this.transform(vector, result);
+    }
+}
+let ZERO_MATRIX3;
+let IDENTITY_MATRIX3;
+function getZeroMatrix() {
+    if (!ZERO_MATRIX3) {
+        ZERO_MATRIX3 = new Matrix3([0, 0, 0, 0, 0, 0, 0, 0, 0]);
+        Object.freeze(ZERO_MATRIX3);
+    }
+    return ZERO_MATRIX3;
+}
+function getIdentityMatrix() {
+    if (!IDENTITY_MATRIX3) {
+        IDENTITY_MATRIX3 = new Matrix3();
+        Object.freeze(IDENTITY_MATRIX3);
+    }
+    return IDENTITY_MATRIX3;
+}

package/dist/classes/matrix4.d.ts

@@ -0,0 +1,226 @@
+import Matrix from './base/matrix';
+import { NumericArray } from '@math.gl/types';
+declare enum INDICES {
+    COL0ROW0 = 0,
+    COL0ROW1 = 1,
+    COL0ROW2 = 2,
+    COL0ROW3 = 3,
+    COL1ROW0 = 4,
+    COL1ROW1 = 5,
+    COL1ROW2 = 6,
+    COL1ROW3 = 7,
+    COL2ROW0 = 8,
+    COL2ROW1 = 9,
+    COL2ROW2 = 10,
+    COL2ROW3 = 11,
+    COL3ROW0 = 12,
+    COL3ROW1 = 13,
+    COL3ROW2 = 14,
+    COL3ROW3 = 15
+}
+/** 4x4 matrix */
+export default class Matrix4 extends Matrix {
+    static get IDENTITY(): Readonly<Matrix4>;
+    static get ZERO(): Readonly<Matrix4>;
+    get ELEMENTS(): number;
+    get RANK(): number;
+    get INDICES(): typeof INDICES;
+    constructor(array?: Readonly<NumericArray>);
+    copy(array: Readonly<NumericArray>): this;
+    set(m00: number, m10: number, m20: number, m30: number, m01: number, m11: number, m21: number, m31: number, m02: number, m12: number, m22: number, m32: number, m03: number, m13: number, m23: number, m33: number): this;
+    setRowMajor(m00: number, m01: number, m02: number, m03: number, m10: number, m11: number, m12: number, m13: number, m20: number, m21: number, m22: number, m23: number, m30: number, m31: number, m32: number, m33: number): this;
+    toRowMajor(result: NumericArray): NumericArray;
+    /** Set to identity matrix */
+    identity(): this;
+    /**
+     *
+     * @param object
+     * @returns self
+     */
+    fromObject(object: {
+        [key: string]: any;
+    }): this;
+    /**
+     * Calculates a 4x4 matrix from the given quaternion
+     * @param quaternion Quaternion to create matrix from
+     * @returns self
+     */
+    fromQuaternion(quaternion: Readonly<NumericArray>): this;
+    /**
+     * Generates a frustum matrix with the given bounds
+     * @param view.left - Left bound of the frustum
+     * @param view.right - Right bound of the frustum
+     * @param view.bottom - Bottom bound of the frustum
+     * @param view.top - Top bound of the frustum
+     * @param view.near - Near bound of the frustum
+     * @param view.far - Far bound of the frustum. Can be set to Infinity.
+     * @returns self
+     */
+    frustum(view: {
+        left: number;
+        right: number;
+        bottom: number;
+        top: number;
+        near: number;
+        far?: number;
+    }): this;
+    /**
+     * Generates a look-at matrix with the given eye position, focal point,
+     * and up axis
+     * @param view.eye - (vector) Position of the viewer
+     * @param view.center - (vector) Point the viewer is looking at
+     * @param view.up - (vector) Up axis
+     * @returns self
+     */
+    lookAt(view: {
+        eye: Readonly<NumericArray>;
+        center?: Readonly<NumericArray>;
+        up?: Readonly<NumericArray>;
+    }): this;
+    /**
+     * Generates a orthogonal projection matrix with the given bounds
+     * from "traditional" view space parameters
+     * @param view.left - Left bound of the frustum
+     * @param view.right number  Right bound of the frustum
+     * @param view.bottom - Bottom bound of the frustum
+     * @param view.top number  Top bound of the frustum
+     * @param view.near - Near bound of the frustum
+     * @param view.far number  Far bound of the frustum
+     * @returns self
+     */
+    ortho(view: {
+        left: number;
+        right: number;
+        bottom: number;
+        top: number;
+        near?: number;
+        far?: number;
+    }): this;
+    /**
+     * Generates an orthogonal projection matrix with the same parameters
+     * as a perspective matrix (plus focalDistance)
+     * @param view.fovy Vertical field of view in radians
+     * @param view.aspect Aspect ratio. Typically viewport width / viewport height
+     * @param view.focalDistance Distance in the view frustum used for extent calculations
+     * @param view.near Near bound of the frustum
+     * @param view.far Far bound of the frustum
+     * @returns self
+     */
+    orthographic(view: {
+        fovy?: number;
+        aspect?: number;
+        focalDistance?: number;
+        near?: number;
+        far?: number;
+    }): this;
+    /**
+     * Generates a perspective projection matrix with the given bounds
+     * @param view.fovy Vertical field of view in radians
+     * @param view.aspect Aspect ratio. typically viewport width/height
+     * @param view.near Near bound of the frustum
+     * @param view.far Far bound of the frustum
+     * @returns self
+     */
+    perspective(view: {
+        fovy: number;
+        aspect?: number;
+        near?: number;
+        far?: number;
+    }): this;
+    determinant(): number;
+    /**
+     * Extracts the non-uniform scale assuming the matrix is an affine transformation.
+     * The scales are the "lengths" of the column vectors in the upper-left 3x3 matrix.
+     * @param result
+     * @returns self
+     */
+    getScale(result?: NumericArray): NumericArray;
+    /**
+     * Gets the translation portion, assuming the matrix is a affine transformation matrix.
+     * @param result
+     * @returns self
+     */
+    getTranslation(result?: NumericArray): NumericArray;
+    /**
+     * Gets upper left 3x3 pure rotation matrix (non-scaling), assume affine transformation matrix
+     * @param result
+     * @param scaleResult
+     * @returns self
+     */
+    getRotation(result?: NumericArray, scaleResult?: NumericArray): NumericArray;
+    /**
+     *
+     * @param result
+     * @param scaleResult
+     * @returns self
+     */
+    getRotationMatrix3(result?: NumericArray, scaleResult?: NumericArray): NumericArray;
+    transpose(): this;
+    invert(): this;
+    multiplyLeft(a: Readonly<NumericArray>): this;
+    multiplyRight(a: Readonly<NumericArray>): this;
+    rotateX(radians: number): this;
+    rotateY(radians: number): this;
+    /**
+     * Rotates a matrix by the given angle around the Z axis.
+     * @param radians
+     * @returns self
+     */
+    rotateZ(radians: number): this;
+    /**
+     *
+     * @param param0
+     * @returns self
+     */
+    rotateXYZ(angleXYZ: Readonly<NumericArray>): this;
+    /**
+     *
+     * @param radians
+     * @param axis
+     * @returns self
+     */
+    rotateAxis(radians: number, axis: Readonly<NumericArray>): this;
+    /**
+     *
+     * @param factor
+     * @returns self
+     */
+    scale(factor: number | Readonly<NumericArray>): this;
+    /**
+     *
+     * @param vec
+     * @returns self
+     */
+    translate(vector: Readonly<NumericArray>): this;
+    /**
+     * Transforms any 2, 3 or 4 element vector. 2 and 3 elements are treated as points
+     * @param vector
+     * @param result
+     * @returns self
+     */
+    transform(vector: Readonly<NumericArray>, result: NumericArray): NumericArray;
+    /**
+     * Transforms any 2 or 3 element array as point (w implicitly 1)
+     * @param vector
+     * @param result
+     * @returns self
+     */
+    transformAsPoint(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    /**
+     * Transforms any 2 or 3 element array as vector (w implicitly 0)
+     * @param vector
+     * @param result
+     * @returns self
+     */
+    transformAsVector(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    /** @deprecated */
+    transformPoint(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    /** @deprecated */
+    transformVector(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    /** @deprecated */
+    transformDirection(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    makeRotationX(radians: number): this;
+    makeTranslation(x: number, y: number, z: number): this;
+}
+export {};
+//# sourceMappingURL=matrix4.d.ts.map

package/dist/classes/matrix4.d.ts.map

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