@babylonjs/core 8.8.5 → 8.9.1

package/Maths/math.vector.js

@@ -1258,8 +1258,8 @@ export class Vector3 {
          * so saves on memory rather than importing whole Spherical Class
          */
         const radius = this.length();
-        let theta = Math.acos(this.y / radius);
-        const phi = Math.atan2(this.z, this.x);
+        let theta = Math.acos(this._y / radius);
+        const phi = Math.atan2(this._z, this._x);
         //makes angle 90 degs to current vector
         if (theta > Math.PI / 2) {
             theta -= Math.PI / 2;
@@ -1591,7 +1591,7 @@ export class Vector3 {
      * @returns a new Vector3
      */
     floor() {
-        return new Vector3(Math.floor(this.x), Math.floor(this.y), Math.floor(this.z));
+        return new Vector3(Math.floor(this._x), Math.floor(this._y), Math.floor(this._z));
     }
     /**
      * Gets the current Vector3's fractional values and stores them in result
@@ -1599,9 +1599,9 @@ export class Vector3 {
      * @returns the result vector
      */
     fractToRef(result) {
-        result._x = this.x - Math.floor(this._x);
-        result._y = this.y - Math.floor(this._y);
-        result._z = this.z - Math.floor(this._z);
+        result._x = this._x - Math.floor(this._x);
+        result._y = this._y - Math.floor(this._y);
+        result._z = this._z - Math.floor(this._z);
         result._isDirty = true;
         return result;
     }
@@ -1611,7 +1611,7 @@ export class Vector3 {
      * @returns a new Vector3
      */
     fract() {
-        return new Vector3(this.x - Math.floor(this._x), this.y - Math.floor(this._y), this.z - Math.floor(this._z));
+        return new Vector3(this._x - Math.floor(this._x), this._y - Math.floor(this._y), this._z - Math.floor(this._z));
     }
     // Properties
     /**
@@ -2887,6 +2887,41 @@ Object.defineProperties(Vector3.prototype, {
  * Vector4 class created for EulerAngle class conversion to Quaternion
  */
 export class Vector4 {
+    // ---------------------------------
+    // Getters / setters (same pattern as Vector3)
+    // ---------------------------------
+    /** Gets or sets the x coordinate */
+    get x() {
+        return this._x;
+    }
+    set x(value) {
+        this._x = value;
+        this._isDirty = true;
+    }
+    /** Gets or sets the y coordinate */
+    get y() {
+        return this._y;
+    }
+    set y(value) {
+        this._y = value;
+        this._isDirty = true;
+    }
+    /** Gets or sets the z coordinate */
+    get z() {
+        return this._z;
+    }
+    set z(value) {
+        this._z = value;
+        this._isDirty = true;
+    }
+    /** Gets or sets the w coordinate */
+    get w() {
+        return this._w;
+    }
+    set w(value) {
+        this._w = value;
+        this._isDirty = true;
+    }
     /**
      * Creates a Vector4 object from the given floats.
      * @param x x value of the vector
@@ -2894,26 +2929,20 @@ export class Vector4 {
      * @param z z value of the vector
      * @param w w value of the vector
      */
-    constructor(
-    /** [0] x value of the vector */
-    x = 0, 
-    /** [0] y value of the vector */
-    y = 0, 
-    /** [0] z value of the vector */
-    z = 0, 
-    /** [0] w value of the vector */
-    w = 0) {
-        this.x = x;
-        this.y = y;
-        this.z = z;
-        this.w = w;
+    constructor(x = 0, y = 0, z = 0, w = 0) {
+        /** @internal */
+        this._isDirty = true;
+        this._x = x;
+        this._y = y;
+        this._z = z;
+        this._w = w;
     }
     /**
      * Returns the string with the Vector4 coordinates.
      * @returns a string containing all the vector values
      */
     toString() {
-        return `{X: ${this.x} Y: ${this.y} Z: ${this.z} W: ${this.w}}`;
+        return `{X: ${this._x} Y: ${this._y} Z: ${this._z} W: ${this._w}}`;
     }
     /**
      * Returns the string "Vector4".
@@ -2927,10 +2956,10 @@ export class Vector4 {
      * @returns a unique hash code
      */
     getHashCode() {
-        const x = ExtractAsInt(this.x);
-        const y = ExtractAsInt(this.y);
-        const z = ExtractAsInt(this.z);
-        const w = ExtractAsInt(this.w);
+        const x = ExtractAsInt(this._x);
+        const y = ExtractAsInt(this._y);
+        const z = ExtractAsInt(this._z);
+        const w = ExtractAsInt(this._w);
         let hash = x;
         hash = (hash * 397) ^ y;
         hash = (hash * 397) ^ z;
@@ -2943,7 +2972,7 @@ export class Vector4 {
      * @returns the resulting array
      */
     asArray() {
-        return [this.x, this.y, this.z, this.w];
+        return [this._x, this._y, this._z, this._w];
     }
     /**
      * Populates the given array from the given index with the Vector4 coordinates.
@@ -2955,10 +2984,10 @@ export class Vector4 {
         if (index === undefined) {
             index = 0;
         }
-        array[index] = this.x;
-        array[index + 1] = this.y;
-        array[index + 2] = this.z;
-        array[index + 3] = this.w;
+        array[index] = this._x;
+        array[index + 1] = this._y;
+        array[index + 2] = this._z;
+        array[index + 3] = this._w;
         return this;
     }
     /**
@@ -2977,10 +3006,10 @@ export class Vector4 {
      * @returns the updated Vector4.
      */
     addInPlace(otherVector) {
-        this.x += otherVector.x;
-        this.y += otherVector.y;
-        this.z += otherVector.z;
-        this.w += otherVector.w;
+        this.x += otherVector._x;
+        this.y += otherVector._y;
+        this.z += otherVector._z;
+        this.w += otherVector._w;
         return this;
     }
     /**
@@ -3004,7 +3033,7 @@ export class Vector4 {
      * @returns the resulting vector
      */
     add(otherVector) {
-        return new Vector4(this.x + otherVector.x, this.y + otherVector.y, this.z + otherVector.z, this.w + otherVector.w);
+        return new Vector4(this._x + otherVector.x, this._y + otherVector.y, this._z + otherVector.z, this._w + otherVector.w);
     }
     /**
      * Updates the given vector "result" with the result of the addition of the current Vector4 and the given one.
@@ -3013,10 +3042,10 @@ export class Vector4 {
      * @returns result input
      */
     addToRef(otherVector, result) {
-        result.x = this.x + otherVector.x;
-        result.y = this.y + otherVector.y;
-        result.z = this.z + otherVector.z;
-        result.w = this.w + otherVector.w;
+        result.x = this._x + otherVector.x;
+        result.y = this._y + otherVector.y;
+        result.z = this._z + otherVector.z;
+        result.w = this._w + otherVector.w;
         return result;
     }
     /**
@@ -3037,7 +3066,7 @@ export class Vector4 {
      * @returns the new vector with the result
      */
     subtract(otherVector) {
-        return new Vector4(this.x - otherVector.x, this.y - otherVector.y, this.z - otherVector.z, this.w - otherVector.w);
+        return new Vector4(this._x - otherVector.x, this._y - otherVector.y, this._z - otherVector.z, this._w - otherVector.w);
     }
     /**
      * Sets the given vector "result" with the result of the subtraction of the given vector from the current Vector4.
@@ -3046,10 +3075,10 @@ export class Vector4 {
      * @returns result input
      */
     subtractToRef(otherVector, result) {
-        result.x = this.x - otherVector.x;
-        result.y = this.y - otherVector.y;
-        result.z = this.z - otherVector.z;
-        result.w = this.w - otherVector.w;
+        result.x = this._x - otherVector.x;
+        result.y = this._y - otherVector.y;
+        result.z = this._z - otherVector.z;
+        result.w = this._w - otherVector.w;
         return result;
     }
     /**
@@ -3061,7 +3090,7 @@ export class Vector4 {
      * @returns new vector containing the result
      */
     subtractFromFloats(x, y, z, w) {
-        return new Vector4(this.x - x, this.y - y, this.z - z, this.w - w);
+        return new Vector4(this._x - x, this._y - y, this._z - z, this._w - w);
     }
     /**
      * Sets the given vector "result" set with the result of the subtraction of the given floats from the current Vector4 coordinates.
@@ -3073,10 +3102,10 @@ export class Vector4 {
      * @returns result input
      */
     subtractFromFloatsToRef(x, y, z, w, result) {
-        result.x = this.x - x;
-        result.y = this.y - y;
-        result.z = this.z - z;
-        result.w = this.w - w;
+        result.x = this._x - x;
+        result.y = this._y - y;
+        result.z = this._z - z;
+        result.w = this._w - w;
         return result;
     }
     /**
@@ -3084,7 +3113,7 @@ export class Vector4 {
      * @returns a new vector with the negated values
      */
     negate() {
-        return new Vector4(-this.x, -this.y, -this.z, -this.w);
+        return new Vector4(-this._x, -this._y, -this._z, -this._w);
     }
     /**
      * Negate this vector in place
@@ -3103,10 +3132,10 @@ export class Vector4 {
      * @returns the result
      */
     negateToRef(result) {
-        result.x = -this.x;
-        result.y = -this.y;
-        result.z = -this.z;
-        result.w = -this.w;
+        result.x = -this._x;
+        result.y = -this._y;
+        result.z = -this._z;
+        result.w = -this._w;
         return result;
     }
     /**
@@ -3127,7 +3156,7 @@ export class Vector4 {
      * @returns a new vector with the result
      */
     scale(scale) {
-        return new Vector4(this.x * scale, this.y * scale, this.z * scale, this.w * scale);
+        return new Vector4(this._x * scale, this._y * scale, this._z * scale, this._w * scale);
     }
     /**
      * Sets the given vector "result" with the current Vector4 coordinates multiplied by scale (float).
@@ -3136,10 +3165,10 @@ export class Vector4 {
      * @returns result input
      */
     scaleToRef(scale, result) {
-        result.x = this.x * scale;
-        result.y = this.y * scale;
-        result.z = this.z * scale;
-        result.w = this.w * scale;
+        result.x = this._x * scale;
+        result.y = this._y * scale;
+        result.z = this._z * scale;
+        result.w = this._w * scale;
         return result;
     }
     /**
@@ -3149,10 +3178,10 @@ export class Vector4 {
      * @returns result input
      */
     scaleAndAddToRef(scale, result) {
-        result.x += this.x * scale;
-        result.y += this.y * scale;
-        result.z += this.z * scale;
-        result.w += this.w * scale;
+        result.x += this._x * scale;
+        result.y += this._y * scale;
+        result.z += this._z * scale;
+        result.w += this._w * scale;
         return result;
     }
     /**
@@ -3161,7 +3190,7 @@ export class Vector4 {
      * @returns true if they are equal
      */
     equals(otherVector) {
-        return otherVector && this.x === otherVector.x && this.y === otherVector.y && this.z === otherVector.z && this.w === otherVector.w;
+        return otherVector && this._x === otherVector.x && this._y === otherVector.y && this._z === otherVector.z && this._w === otherVector.w;
     }
     /**
      * Boolean : True if the current Vector4 coordinates are each beneath the distance "epsilon" from the given vector ones.
@@ -3171,10 +3200,10 @@ export class Vector4 {
      */
     equalsWithEpsilon(otherVector, epsilon = Epsilon) {
         return (otherVector &&
-            WithinEpsilon(this.x, otherVector.x, epsilon) &&
-            WithinEpsilon(this.y, otherVector.y, epsilon) &&
-            WithinEpsilon(this.z, otherVector.z, epsilon) &&
-            WithinEpsilon(this.w, otherVector.w, epsilon));
+            WithinEpsilon(this._x, otherVector.x, epsilon) &&
+            WithinEpsilon(this._y, otherVector.y, epsilon) &&
+            WithinEpsilon(this._z, otherVector.z, epsilon) &&
+            WithinEpsilon(this._w, otherVector.w, epsilon));
     }
     /**
      * Boolean : True if the given floats are strictly equal to the current Vector4 coordinates.
@@ -3185,7 +3214,7 @@ export class Vector4 {
      * @returns true if equal
      */
     equalsToFloats(x, y, z, w) {
-        return this.x === x && this.y === y && this.z === z && this.w === w;
+        return this._x === x && this._y === y && this._z === z && this._w === w;
     }
     /**
      * Multiplies in place the current Vector4 by the given one.
@@ -3205,7 +3234,7 @@ export class Vector4 {
      * @returns resulting new vector
      */
     multiply(otherVector) {
-        return new Vector4(this.x * otherVector.x, this.y * otherVector.y, this.z * otherVector.z, this.w * otherVector.w);
+        return new Vector4(this._x * otherVector.x, this._y * otherVector.y, this._z * otherVector.z, this._w * otherVector.w);
     }
     /**
      * Updates the given vector "result" with the multiplication result of the current Vector4 and the given one.
@@ -3214,10 +3243,10 @@ export class Vector4 {
      * @returns result input
      */
     multiplyToRef(otherVector, result) {
-        result.x = this.x * otherVector.x;
-        result.y = this.y * otherVector.y;
-        result.z = this.z * otherVector.z;
-        result.w = this.w * otherVector.w;
+        result.x = this._x * otherVector.x;
+        result.y = this._y * otherVector.y;
+        result.z = this._z * otherVector.z;
+        result.w = this._w * otherVector.w;
         return result;
     }
     /**
@@ -3229,7 +3258,7 @@ export class Vector4 {
      * @returns resulting new vector
      */
     multiplyByFloats(x, y, z, w) {
-        return new Vector4(this.x * x, this.y * y, this.z * z, this.w * w);
+        return new Vector4(this._x * x, this._y * y, this._z * z, this._w * w);
     }
     /**
      * Returns a new Vector4 set with the division result of the current Vector4 by the given one.
@@ -3237,7 +3266,7 @@ export class Vector4 {
      * @returns resulting new vector
      */
     divide(otherVector) {
-        return new Vector4(this.x / otherVector.x, this.y / otherVector.y, this.z / otherVector.z, this.w / otherVector.w);
+        return new Vector4(this._x / otherVector.x, this._y / otherVector.y, this._z / otherVector.z, this._w / otherVector.w);
     }
     /**
      * Updates the given vector "result" with the division result of the current Vector4 by the given one.
@@ -3246,10 +3275,10 @@ export class Vector4 {
      * @returns result input
      */
     divideToRef(otherVector, result) {
-        result.x = this.x / otherVector.x;
-        result.y = this.y / otherVector.y;
-        result.z = this.z / otherVector.z;
-        result.w = this.w / otherVector.w;
+        result.x = this._x / otherVector.x;
+        result.y = this._y / otherVector.y;
+        result.z = this._z / otherVector.z;
+        result.w = this._w / otherVector.w;
         return result;
     }
     /**
@@ -3266,16 +3295,16 @@ export class Vector4 {
      * @returns the current updated Vector4
      */
     minimizeInPlace(other) {
-        if (other.x < this.x) {
+        if (other.x < this._x) {
             this.x = other.x;
         }
-        if (other.y < this.y) {
+        if (other.y < this._y) {
             this.y = other.y;
         }
-        if (other.z < this.z) {
+        if (other.z < this._z) {
             this.z = other.z;
         }
-        if (other.w < this.w) {
+        if (other.w < this._w) {
             this.w = other.w;
         }
         return this;
@@ -3286,16 +3315,16 @@ export class Vector4 {
      * @returns the current updated Vector4
      */
     maximizeInPlace(other) {
-        if (other.x > this.x) {
+        if (other.x > this._x) {
             this.x = other.x;
         }
-        if (other.y > this.y) {
+        if (other.y > this._y) {
             this.y = other.y;
         }
-        if (other.z > this.z) {
+        if (other.z > this._z) {
             this.z = other.z;
         }
-        if (other.w > this.w) {
+        if (other.w > this._w) {
             this.w = other.w;
         }
         return this;
@@ -3309,10 +3338,10 @@ export class Vector4 {
      * @returns the current updated Vector4
      */
     minimizeInPlaceFromFloats(x, y, z, w) {
-        this.x = Math.min(x, this.x);
-        this.y = Math.min(y, this.y);
-        this.z = Math.min(z, this.z);
-        this.w = Math.min(w, this.w);
+        this.x = Math.min(x, this._x);
+        this.y = Math.min(y, this._y);
+        this.z = Math.min(z, this._z);
+        this.w = Math.min(w, this._w);
         return this;
     }
     /**
@@ -3324,10 +3353,10 @@ export class Vector4 {
      * @returns the current updated Vector4
      */
     maximizeInPlaceFromFloats(x, y, z, w) {
-        this.x = Math.max(x, this.x);
-        this.y = Math.max(y, this.y);
-        this.z = Math.max(z, this.z);
-        this.w = Math.max(w, this.w);
+        this.x = Math.max(x, this._x);
+        this.y = Math.max(y, this._y);
+        this.z = Math.max(z, this._z);
+        this.w = Math.max(w, this._w);
         return this;
     }
     /**
@@ -3336,10 +3365,10 @@ export class Vector4 {
      * @returns the result vector
      */
     floorToRef(result) {
-        result.x = Math.floor(this.x);
-        result.y = Math.floor(this.y);
-        result.z = Math.floor(this.z);
-        result.w = Math.floor(this.w);
+        result.x = Math.floor(this._x);
+        result.y = Math.floor(this._y);
+        result.z = Math.floor(this._z);
+        result.w = Math.floor(this._w);
         return result;
     }
     /**
@@ -3347,7 +3376,7 @@ export class Vector4 {
      * @returns a new Vector4
      */
     floor() {
-        return new Vector4(Math.floor(this.x), Math.floor(this.y), Math.floor(this.z), Math.floor(this.w));
+        return new Vector4(Math.floor(this._x), Math.floor(this._y), Math.floor(this._z), Math.floor(this._w));
     }
     /**
      * Gets the current Vector4's fractional values and stores them in result
@@ -3355,10 +3384,10 @@ export class Vector4 {
      * @returns the result vector
      */
     fractToRef(result) {
-        result.x = this.x - Math.floor(this.x);
-        result.y = this.y - Math.floor(this.y);
-        result.z = this.z - Math.floor(this.z);
-        result.w = this.w - Math.floor(this.w);
+        result.x = this._x - Math.floor(this._x);
+        result.y = this._y - Math.floor(this._y);
+        result.z = this._z - Math.floor(this._z);
+        result.w = this._w - Math.floor(this._w);
         return result;
     }
     /**
@@ -3366,7 +3395,7 @@ export class Vector4 {
      * @returns a new Vector4
      */
     fract() {
-        return new Vector4(this.x - Math.floor(this.x), this.y - Math.floor(this.y), this.z - Math.floor(this.z), this.w - Math.floor(this.w));
+        return new Vector4(this._x - Math.floor(this._x), this._y - Math.floor(this._y), this._z - Math.floor(this._z), this._w - Math.floor(this._w));
     }
     // Properties
     /**
@@ -3374,14 +3403,14 @@ export class Vector4 {
      * @returns the length
      */
     length() {
-        return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z + this.w * this.w);
+        return Math.sqrt(this._x * this._x + this._y * this._y + this._z * this._z + this._w * this._w);
     }
     /**
      * Returns the Vector4 squared length (float).
      * @returns the length squared
      */
     lengthSquared() {
-        return this.x * this.x + this.y * this.y + this.z * this.z + this.w * this.w;
+        return this._x * this._x + this._y * this._y + this._z * this._z + this._w * this._w;
     }
     // Methods
     /**
@@ -3418,10 +3447,10 @@ export class Vector4 {
     normalizeToRef(reference) {
         const len = this.length();
         if (len === 0 || len === 1.0) {
-            reference.x = this.x;
-            reference.y = this.y;
-            reference.z = this.z;
-            reference.w = this.w;
+            reference.x = this._x;
+            reference.y = this._y;
+            reference.z = this._z;
+            reference.w = this._w;
             return reference;
         }
         return this.scaleToRef(1.0 / len, reference);
@@ -3431,14 +3460,14 @@ export class Vector4 {
      * @returns this converted to a new vector3
      */
     toVector3() {
-        return new Vector3(this.x, this.y, this.z);
+        return new Vector3(this._x, this._y, this._z);
     }
     /**
      * Returns a new Vector4 copied from the current one.
      * @returns the new cloned vector
      */
     clone() {
-        return new Vector4(this.x, this.y, this.z, this.w);
+        return new Vector4(this._x, this._y, this._z, this._w);
     }
     /**
      * Updates the current Vector4 with the given one coordinates.
@@ -3493,7 +3522,7 @@ export class Vector4 {
      * @returns the dot product
      */
     dot(otherVector) {
-        return this.x * otherVector.x + this.y * otherVector.y + this.z * otherVector.z + this.w * otherVector.w;
+        return this._x * otherVector.x + this._y * otherVector.y + this._z * otherVector.z + this._w * otherVector.w;
     }
     // Statics
     /**