@math.gl/core 3.5.6 → 3.6.0-alpha.2

package/src/classes/base/math-array.js

@@ -1,250 +0,0 @@
-// Copyright (c) 2017 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-import {config, formatValue, equals, isArray} from '../../lib/common';
-import assert from '../../lib/assert';
-
-export default class MathArray extends Array {
-  // Defined by derived class
-  get ELEMENTS() {
-    assert(false);
-    return 0;
-  }
-
-  clone() {
-    // @ts-ignore error TS2351: Cannot use 'new' with an expression whose type lacks a call or construct signature.
-    return new this.constructor().copy(this);
-  }
-
-  from(arrayOrObject) {
-    // @ts-ignore error TS2339: Property 'copy' does not exist on type 'MathArray'.
-    return Array.isArray(arrayOrObject) ? this.copy(arrayOrObject) : this.fromObject(arrayOrObject);
-  }
-
-  fromArray(array, offset = 0) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = array[i + offset];
-    }
-    return this.check();
-  }
-
-  to(arrayOrObject) {
-    if (arrayOrObject === this) {
-      return this;
-    }
-    // @ts-ignore error TS2339: Property 'toObject' does not exist on type 'MathArray'.
-    return isArray(arrayOrObject) ? this.toArray(arrayOrObject) : this.toObject(arrayOrObject);
-  }
-
-  toTarget(target) {
-    return target ? this.to(target) : this;
-  }
-
-  toArray(array = [], offset = 0) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      array[offset + i] = this[i];
-    }
-    return array;
-  }
-
-  toFloat32Array() {
-    return new Float32Array(this);
-  }
-
-  toString() {
-    return this.formatString(config);
-  }
-
-  formatString(opts) {
-    let string = '';
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      string += (i > 0 ? ', ' : '') + formatValue(this[i], opts);
-    }
-    return `${opts.printTypes ? this.constructor.name : ''}[${string}]`;
-  }
-
-  equals(array) {
-    if (!array || this.length !== array.length) {
-      return false;
-    }
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      if (!equals(this[i], array[i])) {
-        return false;
-      }
-    }
-    return true;
-  }
-
-  exactEquals(array) {
-    if (!array || this.length !== array.length) {
-      return false;
-    }
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      if (this[i] !== array[i]) {
-        return false;
-      }
-    }
-    return true;
-  }
-
-  // Modifiers
-
-  negate() {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = -this[i];
-    }
-    return this.check();
-  }
-
-  lerp(a, b, t) {
-    if (t === undefined) {
-      t = b;
-      b = a;
-      a = this; // eslint-disable-line
-    }
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      const ai = a[i];
-      this[i] = ai + t * (b[i] - ai);
-    }
-    return this.check();
-  }
-
-  min(vector) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = Math.min(vector[i], this[i]);
-    }
-    return this.check();
-  }
-
-  max(vector) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = Math.max(vector[i], this[i]);
-    }
-    return this.check();
-  }
-
-  clamp(minVector, maxVector) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = Math.min(Math.max(this[i], minVector[i]), maxVector[i]);
-    }
-    return this.check();
-  }
-
-  add(...vectors) {
-    for (const vector of vectors) {
-      for (let i = 0; i < this.ELEMENTS; ++i) {
-        this[i] += vector[i];
-      }
-    }
-    return this.check();
-  }
-
-  subtract(...vectors) {
-    for (const vector of vectors) {
-      for (let i = 0; i < this.ELEMENTS; ++i) {
-        this[i] -= vector[i];
-      }
-    }
-    return this.check();
-  }
-
-  scale(scale) {
-    if (Array.isArray(scale)) {
-      // @ts-ignore error TS2339: Property 'multiply' does not exist on type 'MathArray'.
-      return this.multiply(scale);
-    }
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] *= scale;
-    }
-    return this.check();
-  }
-
-  // three.js compatibility
-
-  sub(a) {
-    return this.subtract(a);
-  }
-
-  setScalar(a) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = a;
-    }
-    return this.check();
-  }
-
-  addScalar(a) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] += a;
-    }
-    return this.check();
-  }
-
-  subScalar(a) {
-    return this.addScalar(-a);
-  }
-
-  multiplyScalar(scalar) {
-    // Multiplies all elements
-    // `Matrix4.scale` only scales its 3x3 "minor"
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] *= scalar;
-    }
-    return this.check();
-  }
-
-  divideScalar(a) {
-    return this.scale(1 / a);
-  }
-
-  clampScalar(min, max) {
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      this[i] = Math.min(Math.max(this[i], min), max);
-    }
-    return this.check();
-  }
-
-  // Cesium compatibility
-
-  multiplyByScalar(scalar) {
-    return this.scale(scalar);
-  }
-
-  // THREE.js compatibility
-  get elements() {
-    return this;
-  }
-
-  // Debug checks
-
-  check() {
-    if (config.debug && !this.validate()) {
-      throw new Error(`math.gl: ${this.constructor.name} some fields set to invalid numbers'`);
-    }
-    return this;
-  }
-
-  validate() {
-    let valid = this.length === this.ELEMENTS;
-    for (let i = 0; i < this.ELEMENTS; ++i) {
-      valid = valid && Number.isFinite(this[i]);
-    }
-    return valid;
-  }
-}

package/src/classes/base/matrix.d.ts

@@ -1,15 +0,0 @@
-import MathArray from './math-array';
-
-export default abstract class Matrix<MatrixType> extends MathArray<MatrixType> {
-  abstract get RANK(): number;
-
-  toString(): string;
-
-  getElementIndex(row: number, col: number): number;
-  // By default assumes row major indices
-  getElement(row: number, col: number);
-  // By default assumes row major indices
-  setElement(row: number, col: number, value: number);
-  getColumn(columnIndex: number, result?: number[]);
-  setColumn(columnIndex: number, columnVector: number[]);
-}

package/src/classes/base/vector.d.ts

@@ -1,45 +0,0 @@
-import MathArray from './math-array';
-
-/** Base class for vectors */
-export default abstract class Vector<VectorType> extends MathArray<VectorType> {
-  // VIRTUAL METHODS
-  // copy(vector) {
-
-  // ACCESSORS
-
-  x: number;
-  y: number;
-
-  // NOTE: `length` is a reserved word for Arrays, so we can't use `v.length()`
-  len(): number;
-  magnitude(): number;
-  lengthSquared(): number;
-  magnitudeSquared(): number;
-
-  distance(mathArray): number;
-
-  distanceSquared(mathArray): number;
-
-  dot(mathArray): number;
-  // MODIFIERS
-
-  normalize(): VectorType;
-
-  multiply(...vectors): VectorType;
-
-  divide(...vectors): VectorType;
-
-  // THREE.js compatibility
-  lengthSq(): number;
-  distanceTo(vector: VectorType): number;
-  distanceToSquared(vector): number;
-
-  getComponent(i): number;
-  setComponent(i, value): number;
-
-  addVectors(a: VectorType, b: VectorType): VectorType;
-  subVectors(a: VectorType, b: VectorType): VectorType;
-  multiplyVectors(a: VectorType, b: VectorType): VectorType;
-
-  addScaledVector(a: VectorType, b: VectorType): VectorType;
-}

package/src/classes/euler.d.ts

@@ -1,92 +0,0 @@
-import MathArray from './base/math-array';
-import Quaternion from './quaternion';
-import Matrix3 from './matrix3';
-
-export default class Euler extends MathArray<Euler> {
-  static ZYX: number;
-  static YXZ: number;
-  static XZY: number;
-  static ZXY: number;
-  static YZX: number;
-  static XYZ: number;
-  static RollPitchYaw: number;
-  static DefaultOrder: number;
-  static RotationOrders: string[];
-
-  static rotationOrder(order: number): string;
-
-  ELEMENTS: number;
-
-  /**
-   * @class
-   * @param {Number | Number[]} x
-   * @param {Number=} [y]
-   * @param {Number=} [z]
-   * @param {Number=} [order]
-   */
-  constructor();
-  constructor(x: number, y: number, z: number, order?: number);
-  constructor(vector3: number[], order?: number);
-
-  fromQuaternion(quaternion: Quaternion): Euler;
-
-  // If copied array does contain fourth element, preserves currently set order
-  copy(array: number[]): Euler;
-
-  // Sets the three angles, and optionally sets the rotation order
-  // If order is not specified, preserves currently set order
-  set(x: number, y: number, z: number, order?: number): Euler;
-
-  validate(): boolean;
-
-  // Does not copy the orientation element
-  toArray(array?: number[], offset?: number): number[];
-
-  // Copies the orientation element
-  toArray4(array?: number[], offset?: number): number[];
-
-  toVector3(result?: number[]): number[];
-
-  // x, y, z angle notation (note: only corresponds to axis in XYZ orientation)
-  x: number;
-  y: number;
-  z: number;
-
-  // alpha, beta, gamma angle notation
-  alpha: number;
-  beta: number;
-  gamma: number;
-
-  // phi, theta, psi angle notation
-  phi: number;
-  theta: number;
-  psi: number;
-
-  // roll, pitch, yaw angle notation
-  roll: number;
-  pitch: number;
-  yaw: number;
-
-  // rotation order, in all three angle notations
-  order: number;
-
-  /* eslint-disable no-multi-spaces, brace-style, no-return-assign */
-
-  // Constructors
-  fromVector3(v: number[], order: number): Euler;
-  // TODO - with and without 4th element
-  fromArray(array: number[], offset?: number): Euler;
-
-  // Common ZYX rotation order
-  fromRollPitchYaw(roll: number, pitch: number, yaw: number): Euler;
-  fromRotationMatrix(m: number[], order?: number): Euler;
-
-  // ACCESSORS
-
-  getRotationMatrix(m: Matrix3): Matrix3;
-  getRotationMatrix(m?: number[]): number[];
-
-  // TODO - move to Quaternion
-  getQuaternion(): Quaternion;
-  toQuaternion(): Quaternion;
-}

package/src/classes/matrix3.d.ts

@@ -1,91 +0,0 @@
-import Matrix from './base/matrix';
-// import Quaternion from './quaternion';
-
-export default class Matrix3 extends Matrix<Matrix3> {
-  static IDENTITY: Matrix3;
-  static ZERO: Matrix3;
-
-  // inherited
-  get ELEMENTS(): number;
-  get RANK(): number;
-  INDICES: number[];
-
-  constructor();
-  constructor(array: number[]);
-  constructor(
-    m00: number,
-    m10: number,
-    m20: number,
-    m01: number,
-    m11: number,
-    m21: number,
-    m02: number,
-    m12: number,
-    m22: number
-  );
-
-  copy(array): Matrix3;
-
-  // accepts column major order, stores in column major order
-  // eslint-disable-next-line max-params
-  set(
-    m00: number,
-    m10: number,
-    m20: number,
-    m01: number,
-    m11: number,
-    m21: number,
-    m02: number,
-    m12: number,
-    m22: number
-  );
-
-  // accepts row major order, stores as column major
-  // eslint-disable-next-line max-params
-  setRowMajor(
-    m00: number,
-    m01: number,
-    m02: number,
-    m10: number,
-    m11: number,
-    m12: number,
-    m20: number,
-    m21: number,
-    m22: number
-  );
-  setRowMajor(...array: number[]);
-
-  // Accessors
-  determinant(): number;
-
-  // Constructors
-  identity(): Matrix3;
-
-  // Calculates a 3x3 matrix from the given quaternion
-  // q quat  Quaternion to create matrix from
-  fromQuaternion(q: number[]): Matrix3;
-
-  // Modifiers
-  transpose(): Matrix3;
-  invert(): Matrix3;
-
-  // Operations
-  multiplyLeft(a: Matrix3): Matrix3;
-  multiplyRight(a: Matrix3): Matrix3;
-
-  rotate(radians: number): Matrix3;
-
-  scale(scale: number): Matrix3;
-  scale([scaleX, scaleY, scaleZ]: number[]): Matrix3;
-
-  translate(vec): Matrix3;
-
-  // Transforms
-
-  transform(vector: number[], result?: number[]): number[];
-
-  // DEPRECATED IN 3.0
-  transformVector(vector, result);
-  transformVector2(vector, result);
-  transformVector3(vector, result);
-}

package/src/classes/matrix3.js

@@ -1,225 +0,0 @@
-// Copyright (c) 2017 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-import Matrix from './base/matrix';
-import {checkVector, deprecated} from '../lib/validators';
-// eslint-disable-next-line camelcase
-import {vec4_transformMat3} from '../lib/gl-matrix-extras';
-
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
-import * as mat3 from 'gl-matrix/mat3';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
-import * as vec2 from 'gl-matrix/vec2';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
-import * as vec3 from 'gl-matrix/vec3';
-
-const IDENTITY = Object.freeze([1, 0, 0, 0, 1, 0, 0, 0, 1]);
-const ZERO = Object.freeze([0, 0, 0, 0, 0, 0, 0, 0, 0]);
-
-const INDICES = Object.freeze({
-  COL0ROW0: 0,
-  COL0ROW1: 1,
-  COL0ROW2: 2,
-  COL1ROW0: 3,
-  COL1ROW1: 4,
-  COL1ROW2: 5,
-  COL2ROW0: 6,
-  COL2ROW1: 7,
-  COL2ROW2: 8
-});
-
-const constants = {};
-
-export default class Matrix3 extends Matrix {
-  static get IDENTITY() {
-    constants.IDENTITY = constants.IDENTITY || Object.freeze(new Matrix3(IDENTITY));
-    return constants.IDENTITY;
-  }
-
-  static get ZERO() {
-    constants.ZERO = constants.ZERO || Object.freeze(new Matrix3(ZERO));
-    return constants.ZERO;
-  }
-
-  get ELEMENTS() {
-    return 9;
-  }
-
-  get RANK() {
-    return 3;
-  }
-
-  get INDICES() {
-    return INDICES;
-  }
-
-  constructor(array) {
-    // 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 {
-      this.identity();
-    }
-  }
-
-  copy(array) {
-    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();
-  }
-
-  // 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);
-  }
-
-  // Constructors
-
-  identity() {
-    return this.copy(IDENTITY);
-  }
-
-  // Calculates a 3x3 matrix from the given quaternion
-  // q quat  Quaternion to create matrix from
-  fromQuaternion(q) {
-    mat3.fromQuat(this, q);
-    return this.check();
-  }
-
-  // Modifiers
-
-  transpose() {
-    mat3.transpose(this, this);
-    return this.check();
-  }
-
-  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, 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 IN 3.0
-
-  transformVector(vector, result) {
-    deprecated('Matrix3.transformVector');
-    return this.transform(vector, result);
-  }
-
-  transformVector2(vector, result) {
-    deprecated('Matrix3.transformVector');
-    return this.transform(vector, result);
-  }
-
-  transformVector3(vector, result) {
-    deprecated('Matrix3.transformVector');
-    return this.transform(vector, result);
-  }
-}