melonjs 10.3.0 → 10.5.1

package/src/math/vector3.js

@@ -4,17 +4,15 @@ import pool from "./../system/pooling.js";
 /**
  * @classdesc
  * a generic 3D Vector Object
- * @class Vector3d
- * @memberof me
- * @param {number} [x=0] x value of the vector
- * @param {number} [y=0] y value of the vector
- * @param {number} [z=0] z value of the vector
  */
-
 class Vector3d {
-
-    constructor(...args) {
-        this.onResetEvent(...args);
+    /**
+     * @param {number} [x=0] x value of the vector
+     * @param {number} [y=0] y value of the vector
+     * @param {number} [z=0] z value of the vector
+     */
+    constructor(x = 0, y = 0, z = 0) {
+        this.onResetEvent(x, y, z);
     }
 
     /**
@@ -41,12 +39,12 @@ class Vector3d {
     /**
      * set the Vector x and y properties to the given values<br>
      * @name set
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} x
      * @param {number} y
      * @param {number} [z=0]
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     set(x, y, z) {
         if (x !== +x || y !== +y || (typeof z !== "undefined" && z !== +z)) {
@@ -60,7 +58,7 @@ class Vector3d {
          * @public
          * @type {number}
          * @name x
-         * @memberof me.Vector3d
+         * @memberof Vector3d
          */
         //this.x = x;
 
@@ -69,7 +67,7 @@ class Vector3d {
          * @public
          * @type {number}
          * @name y
-         * @memberof me.Vector3d
+         * @memberof Vector3d
          */
         //this.y = y;
 
@@ -78,7 +76,7 @@ class Vector3d {
          * @public
          * @type {number}
          * @name z
-         * @memberof me.Vector3d
+         * @memberof Vector3d
          */
         //this.z = z;
 
@@ -88,9 +86,9 @@ class Vector3d {
     /**
      * set the Vector x and y properties to 0
      * @name setZero
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     setZero() {
         return this.set(0, 0, 0);
@@ -99,10 +97,10 @@ class Vector3d {
     /**
      * set the Vector x and y properties using the passed vector
      * @name setV
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     setV(v) {
         return this._set(v.x, v.y, v.z);
@@ -111,10 +109,10 @@ class Vector3d {
     /**
      * Add the passed vector to this vector
      * @name add
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     add(v) {
         return this._set(this.x + v.x, this.y + v.y, this.z + (v.z || 0));
@@ -123,10 +121,10 @@ class Vector3d {
     /**
      * Substract the passed vector to this vector
      * @name sub
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     sub(v) {
         return this._set(this.x - v.x, this.y - v.y, this.z - (v.z || 0));
@@ -135,12 +133,12 @@ class Vector3d {
     /**
      * Multiply this vector values by the given scalar
      * @name scale
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} x
      * @param {number} [y=x]
      * @param {number} [z=1]
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     scale(x, y, z) {
         y = (typeof (y) !== "undefined" ? y : x);
@@ -150,10 +148,10 @@ class Vector3d {
     /**
      * Multiply this vector values by the passed vector
      * @name scaleV
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     scaleV(v) {
         return this.scale(v.x, v.y, v.z);
@@ -162,9 +160,9 @@ class Vector3d {
     /**
      * Convert this vector into isometric coordinate space
      * @name toIso
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     toIso() {
         return this._set(this.x - this.y, (this.x + this.y) * 0.5, this.z);
@@ -173,9 +171,9 @@ class Vector3d {
     /**
      * Convert this vector into 2d coordinate space
      * @name to2d
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     to2d() {
         return this._set(this.y + this.x / 2, this.y - this.x / 2, this.z);
@@ -184,10 +182,10 @@ class Vector3d {
     /**
      * Divide this vector values by the passed value
      * @name div
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} n the value to divide the vector by
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     div(n) {
         return this._set(this.x / n, this.y / n, this.z / n);
@@ -196,9 +194,9 @@ class Vector3d {
     /**
      * Update this vector values to absolute values
      * @name abs
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     abs() {
         return this._set((this.x < 0) ? -this.x : this.x, (this.y < 0) ? -this.y : this.y, (this.z < 0) ? -this.z : this.z);
@@ -207,11 +205,11 @@ class Vector3d {
     /**
      * Clamp the vector value within the specified value range
      * @name clamp
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} low
      * @param {number} high
-     * @returns {me.Vector3d} new me.Vector3d
+     * @returns {Vector3d} new me.Vector3d
      */
     clamp(low, high) {
         return new Vector3d(clamp(this.x, low, high), clamp(this.y, low, high), clamp(this.z, low, high));
@@ -220,11 +218,11 @@ class Vector3d {
     /**
      * Clamp this vector value within the specified value range
      * @name clampSelf
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} low
      * @param {number} high
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     clampSelf(low, high) {
         return this._set(clamp(this.x, low, high), clamp(this.y, low, high), clamp(this.z, low, high));
@@ -233,10 +231,10 @@ class Vector3d {
     /**
      * Update this vector with the minimum value between this and the passed vector
      * @name minV
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     minV(v) {
         var _vz = v.z || 0;
@@ -246,10 +244,10 @@ class Vector3d {
     /**
      * Update this vector with the maximum value between this and the passed vector
      * @name maxV
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     maxV(v) {
         var _vz = v.z || 0;
@@ -259,9 +257,9 @@ class Vector3d {
     /**
      * Floor the vector values
      * @name floor
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} new me.Vector3d
+     * @returns {Vector3d} new me.Vector3d
      */
     floor() {
         return new Vector3d(Math.floor(this.x), Math.floor(this.y), Math.floor(this.z));
@@ -270,9 +268,9 @@ class Vector3d {
     /**
      * Floor this vector values
      * @name floorSelf
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     floorSelf() {
         return this._set(Math.floor(this.x), Math.floor(this.y), Math.floor(this.z));
@@ -281,9 +279,9 @@ class Vector3d {
     /**
      * Ceil the vector values
      * @name ceil
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} new me.Vector3d
+     * @returns {Vector3d} new me.Vector3d
      */
     ceil() {
         return new Vector3d(Math.ceil(this.x), Math.ceil(this.y), Math.ceil(this.z));
@@ -292,9 +290,9 @@ class Vector3d {
     /**
      * Ceil this vector values
      * @name ceilSelf
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     ceilSelf() {
         return this._set(Math.ceil(this.x), Math.ceil(this.y), Math.ceil(this.z));
@@ -303,9 +301,9 @@ class Vector3d {
     /**
      * Negate the vector values
      * @name negate
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} new me.Vector3d
+     * @returns {Vector3d} new me.Vector3d
      */
     negate() {
         return new Vector3d(-this.x, -this.y, -this.z);
@@ -314,9 +312,9 @@ class Vector3d {
     /**
      * Negate this vector values
      * @name negateSelf
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     negateSelf() {
         return this._set(-this.x, -this.y, -this.z);
@@ -325,10 +323,10 @@ class Vector3d {
     /**
      * Copy the components of the given vector into this one
      * @name copy
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     copy(v) {
         return this._set(v.x, v.y, v.z || 0);
@@ -337,15 +335,15 @@ class Vector3d {
     /**
      * return true if the two vectors are the same
      * @name equals
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
+     * @param {Vector2d|Vector3d} v
      * @returns {boolean}
      */
     /**
      * return true if this vector is equal to the given values
      * @name equals
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} x
      * @param {number} y
@@ -376,9 +374,9 @@ class Vector3d {
     /**
      * normalize this vector (scale the vector so that its magnitude is 1)
      * @name normalize
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     normalize() {
         return this.div(this.length() || 1);
@@ -388,9 +386,9 @@ class Vector3d {
      * change this vector to be perpendicular to what it was before.<br>
      * (Effectively rotates it 90 degrees in a clockwise direction around the z axis)
      * @name perp
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     perp() {
         return this._set(this.y, -this.x, this.z);
@@ -399,11 +397,11 @@ class Vector3d {
     /**
      * Rotate this vector (counter-clockwise) by the specified angle (in radians) around the z axis
      * @name rotate
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @param {number} angle The angle to rotate (in radians)
-     * @param {me.Vector2d|me.ObservableVector2d} [v] an optional point to rotate around (on the same z axis)
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|ObservableVector2d} [v] an optional point to rotate around (on the same z axis)
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     rotate(angle, v) {
         var cx = 0;
@@ -427,9 +425,9 @@ class Vector3d {
     /**
      * return the dot product of this vector and the passed one
      * @name dot
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
+     * @param {Vector2d|Vector3d} v
      * @returns {number} The dot product.
      */
     dot(v) {
@@ -439,10 +437,10 @@ class Vector3d {
     /**
      * calculate the cross product of this vector and the passed one
      * @name cross
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector3d} v
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector3d} v
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     cross(v) {
         var ax = this.x, ay = this.y, az = this.z;
@@ -458,7 +456,7 @@ class Vector3d {
    /**
     * return the square length of this vector
     * @name length2
-    * @memberof me.Vector3d
+    * @memberof Vector3d
     * @function
     * @returns {number} The length^2 of this vector.
     */
@@ -469,7 +467,7 @@ class Vector3d {
     /**
      * return the length (magnitude) of this vector
      * @name length
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @returns {number} the length of this vector
      */
@@ -480,11 +478,11 @@ class Vector3d {
     /**
      * Linearly interpolate between this vector and the given one.
      * @name lerp
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector3d} v
+     * @param {Vector3d} v
      * @param {number} alpha distance along the line (alpha = 0 will be this vector, and alpha = 1 will be the given one).
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     lerp(v, alpha) {
         this.x += ( v.x - this.x ) * alpha;
@@ -496,9 +494,9 @@ class Vector3d {
     /**
      * return the distance between this vector and the passed one
      * @name distance
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
+     * @param {Vector2d|Vector3d} v
      * @returns {number}
      */
     distance(v) {
@@ -511,9 +509,9 @@ class Vector3d {
     /**
      * return the angle between this vector and the passed one
      * @name angle
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v
+     * @param {Vector2d|Vector3d} v
      * @returns {number} angle in radians
      */
     angle(v) {
@@ -523,10 +521,10 @@ class Vector3d {
     /**
      * project this vector on to another vector.
      * @name project
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v The vector to project onto.
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v The vector to project onto.
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     project(v) {
         var ratio = this.dot(v) / v.length2();
@@ -537,10 +535,10 @@ class Vector3d {
      * Project this vector onto a vector of unit length.<br>
      * This is slightly more efficient than `project` when dealing with unit vectors.
      * @name projectN
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @param {me.Vector2d|me.Vector3d} v The unit vector to project onto.
-     * @returns {me.Vector3d} Reference to this object for method chaining
+     * @param {Vector2d|Vector3d} v The unit vector to project onto.
+     * @returns {Vector3d} Reference to this object for method chaining
      */
     projectN(v) {
         var ratio = this.dot(v) / v.length2();
@@ -550,9 +548,9 @@ class Vector3d {
     /**
      * return a clone copy of this vector
      * @name clone
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
-     * @returns {me.Vector3d} new me.Vector3d
+     * @returns {Vector3d} new me.Vector3d
      */
     clone() {
         return pool.pull("Vector3d", this.x, this.y, this.z);
@@ -561,7 +559,7 @@ class Vector3d {
     /**
      * convert the object to a string representation
      * @name toString
-     * @memberof me.Vector3d
+     * @memberof Vector3d
      * @function
      * @returns {string}
      */