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

package/src/classes/pose.d.ts

@@ -1,92 +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 Matrix4 from './matrix4';
-import Vector3 from './vector3';
-import Euler from './euler';
-
-type PoseOptions = {
-  position?: number[];
-  orientation?: number[];
-  x?: number;
-  y?: number;
-  z?: number;
-  roll?: number;
-  pitch?: number;
-  yaw?: number;
-};
-
-export default class Pose {
-  /**
-   * A pose contains both rotation and rotations.
-   * Note that every single pose defines its own coordinate system
-   * (with the position of the pose in the origin, and zero rotations).
-   * These "pose relative" coordinate will be centered on the defining
-   * pose's position and with with the defining pose's orientation
-   * aligned with axis.
-   * @param {Object} options
-   * @param {Number[]} [options.position]
-   * @param {Number[]} [options.orientation]
-   * @param {Number} [options.x]
-   * @param {Number} [options.y]
-   * @param {Number} [options.z]
-   * @param {Number} [options.roll]
-   * @param {Number} [options.pitch]
-   * @param {Number} [options.yaw]
-   */
-  constructor(options?: PoseOptions);
-
-  x: number;
-  y: number;
-  z: number;
-  roll: number;
-  pitch: number;
-  yaw: number;
-
-  getPosition(): Vector3;
-  getOrientation(): Euler;
-
-  equals(pose: Pose): boolean;
-  exactEquals(pose: Pose): boolean;
-
-  /**
-   * Returns a 4x4 matrix that transforms a coordinates (in the same
-   * coordinate system as this pose) into the "pose-relative" coordinate
-   * system defined by this pose.
-   * The pose relative coordinates with have origin in the position of this
-   * pose, and axis will be aligned with the rotation of this pose.
-   */
-  getTransformationMatrix(): Matrix4;
-
-  /**
-   * Given a second pose that represent the same object in a second coordinate
-   * system, this method returns a 4x4 matrix that transforms coordinates in the
-   * second coordinate system into the coordinate system of this pose.
-   */
-  getTransformationMatrixFromPose(pose: Pose): Matrix4;
-
-  /**
-   * Given a second pose that represent the same object in a second coordinate
-   * system, this method returns a 4x4 matrix that transforms coordinates in the
-   * coordinate system of this pose into the coordinate system of the second pose.
-   *
-   * Note: This method returns the inverse of `this.getTransformationMatrixFromPose(pose)`
-   */
-  getTransformationMatrixToPose(pose: Pose): Matrix4;
-}

package/src/classes/quaternion.d.ts

@@ -1,107 +0,0 @@
-import MathArray from './base/math-array';
-
-export default class Quaternion extends MathArray<Quaternion> {
-  // Getters/setters
-  ELEMENTS: number;
-
-  x: number;
-  y: number;
-  z: number;
-  w: number;
-
-  /** Creates a new identity quaternion: `w^2 + x^2 + y^2 + z^2 = 1` */
-  constructor();
-  constructor(q: Quaternion);
-  constructor(q: readonly number[]);
-  constructor(x: number, y: number, z: number, w: number);
-
-  copy(array: readonly number[]): Quaternion;
-
-  set(x: number, y: number, z: number, w: number): Quaternion;
-
-  /**
-   * Creates a quaternion from the given 3x3 rotation matrix.
-   *
-   * - The resultant quaternion is not normalized, so you should
-   * be sure to renormalize the quaternion yourself where necessary.
-   */
-  fromMatrix3(m: readonly number[]): Quaternion;
-
-  fromAxisRotation(axis, rad): Quaternion;
-
-  /** Set a quat to the identity quaternion */
-  identity(): Quaternion;
-
-  // Set the components of a quaternion to the given values
-  // set(i, j, k, l) {
-  //   quat.set(this, i, j, k, l);
-  //   return this.check();
-  // }
-
-  /** Sets a quaternion from the given angle and rotation axis, then returns it. */
-  setAxisAngle(axis, rad): Quaternion;
-
-  /** Calculates the length of a quaternion */
-  len(): number;
-
-  /** Calculates the squared length of a quaternion */
-  lengthSquared(): number;
-
-  /** Calculates the dot product of two quaternions */
-  dot(a: readonly number[]): number;
-
-  rotationTo(vectorA, vectorB): Quaternion;
-
-  /** Adds two quaternions */
-  add(a: readonly number[]): Quaternion;
-
-  /**
-   * Calculates the W component of a quat from the X, Y, and Z components.
-   * Any existing W component will be ignored.
-   */
-  calculateW(): Quaternion;
-
-  /**
-   * Calculates the conjugate of a quat If the quaternion is normalized,
-   * this function is faster than quat.inverse and produces the same result.
-   */
-  conjugate(): Quaternion;
-
-  /** Calculates the inverse of this quaternion */
-  invert(): Quaternion;
-
-  /** Performs a linear interpolation between two quaternions */
-  lerp(a, b, t): Quaternion;
-
-  /** Multiplies two quaternions */
-  multiplyRight(a, b): Quaternion;
-  /** Multiplies two quaternions */
-  multiplyLeft(a, b): Quaternion;
-
-  /** Normalize a quaternion */
-  normalize(): Quaternion;
-
-  // MODIFIERS
-
-  /** Rotates a quaternion by the given angle about the X axis */
-  rotateX(radians: number): Quaternion;
-  /** Rotates a quaternion by the given angle about the Y axis */
-  rotateY(radians: number): Quaternion;
-  /** Rotates a quaternion by the given angle about the Z axis */
-  rotateZ(radians: number): Quaternion;
-
-  /** Scales a quaternion by a scalar number */
-  scale(b: number): Quaternion;
-
-  /** Performs a spherical linear interpolation between two quaternions */
-  slerp(start: readonly number[], target: readonly number[], ratio: number): Quaternion;
-  slerp(args: {start: readonly number[]; target: readonly number[]; ratio: number}): Quaternion;
-
-  transformVector4(vector, result?);
-
-  // THREE.js Math API compatibility
-  lengthSq(): Quaternion;
-  setFromAxisAngle(axis, rad): Quaternion;
-  premultiply(a, b): Quaternion;
-  multiply(a, b): Quaternion;
-}

package/src/classes/spherical-coordinates.d.ts

@@ -1,87 +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.
-
-// Adaptation of THREE.js Spherical class, under MIT license
-import Vector3 from './vector3';
-
-type SphericalCoordinatesOptions = {
-  phi?: number;
-  theta?: number;
-  radius?: number;
-  bearing?: number;
-  pitch?: number;
-  altitude?: number;
-  radiusScale?: number;
-};
-
-type FormatOptions = {
-  printTypes?: boolean;
-};
-
-/**
- * Ref: https://en.wikipedia.org/wiki/Spherical_coordinate_system
- * The poles (phi) are at the positive and negative y axis.
- * The equator starts at positive z.
- */
-export default class SphericalCoordinates {
-  // Todo [rho, theta, phi] ?
-
-  // Cartographic (bearing 0 north, pitch 0 look from above)
-  bearing: number;
-  pitch: number;
-  altitude: number;
-
-  // lnglatZ coordinates
-  longitude: number;
-  latitude: number;
-  lng: number;
-  lat: number;
-  z: number;
-
-  /**
-   * @param {Object} options
-   * @param {Number} [options.phi] =0 - rotation around X (latitude)
-   * @param {Number} [options.theta] =0 - rotation around Y (longitude)
-   * @param {Number} [options.radius] =1 - Distance from center
-   * @param {Number} [options.bearing]
-   * @param {Number} [options.pitch]
-   * @param {Number} [options.altitude]
-   * @param {Number} [options.radiusScale] =1
-   */
-  constructor(options?: SphericalCoordinatesOptions);
-
-  fromLngLatZ(lngLatZ: number[]): SphericalCoordinates;
-  fromVector3(v: number[]): SphericalCoordinates;
-
-  clone(): SphericalCoordinates;
-  copy(other: SphericalCoordinates): SphericalCoordinates;
-  set(radius: number, phi: number, theta: number): SphericalCoordinates;
-
-  equals(other: SphericalCoordinates): boolean;
-  exactEquals(other: SphericalCoordinates): boolean;
-
-  toString(): string;
-  formatString(options?: FormatOptions): string;
-  toVector3(): Vector3;
-
-  // restrict phi to be betwee EPS and PI-EPS
-  makeSafe(): SphericalCoordinates;
-  check(): SphericalCoordinates;
-}

package/src/classes/vector2.d.ts

@@ -1,65 +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 Vector from './base/vector';
-
-/* Two-element vector class */
-export default class Vector2 extends Vector<Vector2> {
-  static ZERO: number[];
-  get ELEMENTS(): number;
-
-  constructor();
-  constructor(array: readonly number[]);
-  constructor(x: number, y: number);
-
-  set(x: number, y: number): Vector2;
-
-  copy(array: readonly number[]): Vector2;
-
-  fromObject(object): Vector2;
-  //  {
-  //   if (config.debug) {
-  //     checkNumber(object.x);
-  //     checkNumber(object.y);
-  //   }
-  //   this[0] = object.x;
-  //   this[1] = object.y;
-  //   return this.check();
-  // }
-
-  toObject(object: object): object;
-
-  // x,y inherited from Vector
-
-  horizontalAngle(): number;
-
-  verticalAngle(): number;
-
-  // Transforms
-  transform(matrix4: readonly number[]): Vector2;
-  // transforms as point (4th component is implicitly 1)
-  transformAsPoint(matrix4: readonly number[]): Vector2;
-  // transforms as vector  (4th component is implicitly 0, ignores translation. slightly faster)
-  transformAsVector(matrix4: readonly number[]): Vector2;
-
-  transformByMatrix3(matrix3: readonly number[]): Vector2;
-  transformByMatrix2x3(matrix2x3: readonly number[]): Vector2;
-  transformByMatrix2(matrix2: readonly number[]): Vector2;
-}

package/src/classes/vector2.js

@@ -1,122 +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 Vector from './base/vector';
-import {config, isArray} from '../lib/common';
-import {checkNumber} from '../lib/validators';
-
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
-import * as vec2 from 'gl-matrix/vec2';
-// eslint-disable-next-line camelcase
-import {vec2_transformMat4AsVector} from '../lib/gl-matrix-extras';
-
-export default class Vector2 extends Vector {
-  // Creates a new, empty vec2
-  constructor(x = 0, y = 0) {
-    // PERF NOTE: initialize elements as double precision numbers
-    super(2); // -0, -0);
-    if (isArray(x) && arguments.length === 1) {
-      this.copy(x);
-    } else {
-      if (config.debug) {
-        checkNumber(x);
-        checkNumber(y);
-      }
-      this[0] = x;
-      this[1] = y;
-    }
-  }
-
-  set(x, y) {
-    this[0] = x;
-    this[1] = y;
-    return this.check();
-  }
-
-  copy(array) {
-    this[0] = array[0];
-    this[1] = array[1];
-    return this.check();
-  }
-
-  fromObject(object) {
-    if (config.debug) {
-      checkNumber(object.x);
-      checkNumber(object.y);
-    }
-    this[0] = object.x;
-    this[1] = object.y;
-    return this.check();
-  }
-
-  toObject(object) {
-    object.x = this[0];
-    object.y = this[1];
-    return object;
-  }
-
-  // Getters/setters
-  get ELEMENTS() {
-    return 2;
-  }
-
-  // x,y inherited from Vector
-
-  horizontalAngle() {
-    return Math.atan2(this.y, this.x);
-  }
-
-  verticalAngle() {
-    return Math.atan2(this.x, this.y);
-  }
-
-  // Transforms
-
-  transform(matrix4) {
-    return this.transformAsPoint(matrix4);
-  }
-
-  // transforms as point (4th component is implicitly 1)
-  transformAsPoint(matrix4) {
-    vec2.transformMat4(this, this, matrix4);
-    return this.check();
-  }
-
-  // transforms as vector  (4th component is implicitly 0, ignores translation. slightly faster)
-  transformAsVector(matrix4) {
-    vec2_transformMat4AsVector(this, this, matrix4);
-    return this.check();
-  }
-
-  transformByMatrix3(matrix3) {
-    vec2.transformMat3(this, this, matrix3);
-    return this.check();
-  }
-
-  transformByMatrix2x3(matrix2x3) {
-    vec2.transformMat2d(this, this, matrix2x3);
-    return this.check();
-  }
-
-  transformByMatrix2(matrix2) {
-    vec2.transformMat2(this, this, matrix2);
-    return this.check();
-  }
-}

package/src/classes/vector3.d.ts

@@ -1,65 +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 Vector from './base/vector';
-
-/** Three-element vector class */
-export default class Vector3 extends Vector<Vector3> {
-  static readonly ZERO: Vector3;
-  get ELEMENTS(): number;
-
-  constructor();
-  constructor(array: readonly number[]);
-  constructor(x: number, y: number, z: number);
-
-  set(x: number, y: number, z: number);
-
-  copy(array: readonly number[]);
-
-  fromObject(object);
-  toObject(object);
-
-  // x,y inherited from Vector
-
-  z: number;
-
-  // ACCESSORS
-  angle(vector: readonly number[]): number;
-
-  // MODIFIERS
-  cross(vector: readonly number[]): Vector3;
-
-  rotateX(args: {radians: number; origin?: readonly number[]}): Vector3;
-  rotateY(args: {radians: number; origin?: readonly number[]}): Vector3;
-  rotateZ(args: {radians: number; origin?: readonly number[]}): Vector3;
-
-  // Transforms
-
-  // transforms as point (4th component is implicitly 1)
-  transform(matrix4: readonly number[]): Vector3;
-  // transforms as point (4th component is implicitly 1)
-  transformAsPoint(matrix4: readonly number[]): Vector3;
-  // transforms as vector  (4th component is implicitly 0, ignores translation. slightly faster)
-  transformAsVector(matrix4: readonly number[]): Vector3;
-
-  transformByMatrix3(matrix3: readonly number[]): Vector3;
-  transformByMatrix2(matrix2: readonly number[]): Vector3;
-  transformByQuaternion(quaternion: readonly number[]): Vector3;
-}

package/src/classes/vector4.d.ts

@@ -1,34 +0,0 @@
-import Vector from './base/vector';
-
-/** Four-element vector class */
-export default class Vector4 extends Vector<Vector4> {
-  static ZERO: number[];
-  get ELEMENTS(): number;
-
-  /** construct a new Vector4 initialize to [0, 0, 0, 0] */
-  constructor();
-  /** construct a new Vector4 initialize to ...x, y, z, w */
-  constructor(x: number, y: number, z: number, w: number);
-  /** construct a new Vector4 initialize to array [x, y, z, w] */
-  constructor(array: readonly number[]);
-
-  set(x, y, z, w);
-
-  copy(array);
-
-  fromObject(object);
-
-  toObject(object);
-
-  // x,y inherited from Vector
-  z: number;
-  w: number;
-
-  transform(matrix4: readonly number[]): Vector4;
-  transformByMatrix3(matrix3: readonly number[]): Vector4;
-  transformByMatrix2(matrix2: readonly number[]): Vector4;
-  transformByQuaternion(quaternion: readonly number[]): Vector4;
-
-  // three.js compatibility
-  applyMatrix4(m: readonly number[]): Vector4;
-}

package/src/index.d.ts

@@ -1,54 +0,0 @@
-// lib
-export * from './lib/common';
-
-// classes
-export {default as Vector2} from './classes/vector2';
-export {default as Vector3} from './classes/vector3';
-export {default as Vector4} from './classes/vector4';
-export {default as Matrix3} from './classes/matrix3';
-export {default as Matrix4} from './classes/matrix4';
-export {default as Quaternion} from './classes/quaternion';
-
-// extras
-
-// export {checkNumber} from './lib/validators';
-export function assert(condition: boolean, message?: string): void;
-
-// experimental
-export {default as SphericalCoordinates} from './classes/spherical-coordinates';
-export {default as Pose} from './classes/pose';
-export {default as Euler} from './classes/euler';
-
-export const _MathUtils: {
-  EPSILON1: number;
-  EPSILON2: number;
-  EPSILON3: number;
-  EPSILON4: number;
-  EPSILON5: number;
-  EPSILON6: number;
-  EPSILON7: number;
-  EPSILON8: number;
-  EPSILON9: number;
-  EPSILON10: number;
-  EPSILON11: number;
-  EPSILON12: number;
-  EPSILON13: number;
-  EPSILON14: number;
-  EPSILON15: number;
-  EPSILON16: number;
-  EPSILON17: number;
-  EPSILON18: number;
-  EPSILON19: number;
-  EPSILON20: number;
-
-  PI_OVER_TWO: number;
-  PI_OVER_FOUR: number;
-  PI_OVER_SIX: number;
-
-  TWO_PI: number;
-};
-
-// DEPRECATED
-export {default as _SphericalCoordinates} from './classes/spherical-coordinates';
-export {default as _Pose} from './classes/pose';
-export {default as _Euler} from './classes/euler';