@babylonjs/core 7.19.0 → 7.20.0

package/Maths/math.constants.d.ts

@@ -17,5 +17,4 @@ export declare const PHI: number;
  * Constant used to define the minimal number value in Babylon.js
  * @ignorenaming
  */
-declare const Epsilon = 0.001;
-export { Epsilon };
+export declare const Epsilon = 0.001;

package/Maths/math.constants.js

@@ -20,6 +20,5 @@ export const PHI = (1 + Math.sqrt(5)) / 2;
  * @ignorenaming
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const Epsilon = 0.001;
-export { Epsilon };
+export const Epsilon = 0.001;
 //# sourceMappingURL=math.constants.js.map

package/Maths/math.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.constants.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,CAAC;AAEpC;;;GAGG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE1C;;;GAGG;AACH,gEAAgE;AAChE,MAAM,OAAO,GAAG,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,CAAC","sourcesContent":["/**\r\n * Constant used to convert a value to gamma space\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const ToGammaSpace = 1 / 2.2;\r\n\r\n/**\r\n * Constant used to convert a value to linear space\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const ToLinearSpace = 2.2;\r\n\r\n/**\r\n * Constant Golden Ratio value in Babylon.js\r\n * @ignorenaming\r\n */\r\nexport const PHI = (1 + Math.sqrt(5)) / 2;\r\n\r\n/**\r\n * Constant used to define the minimal number value in Babylon.js\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nconst Epsilon = 0.001;\r\nexport { Epsilon };\r\n"]}
+{"version":3,"file":"math.constants.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,CAAC;AAEpC;;;GAGG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE1C;;;GAGG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC","sourcesContent":["/**\r\n * Constant used to convert a value to gamma space\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const ToGammaSpace = 1 / 2.2;\r\n\r\n/**\r\n * Constant used to convert a value to linear space\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const ToLinearSpace = 2.2;\r\n\r\n/**\r\n * Constant Golden Ratio value in Babylon.js\r\n * @ignorenaming\r\n */\r\nexport const PHI = (1 + Math.sqrt(5)) / 2;\r\n\r\n/**\r\n * Constant used to define the minimal number value in Babylon.js\r\n * @ignorenaming\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport const Epsilon = 0.001;\r\n"]}

package/Maths/math.like.d.ts

@@ -26,6 +26,15 @@ export interface IVector2Like {
 export interface IVector3Like extends IVector2Like {
     z: float;
 }
+/**
+ * @internal
+ */
+export interface Vector3LikeInternal {
+    _x: number;
+    _y: number;
+    _z: number;
+    _isDirty?: boolean;
+}
 /**
  * @internal
  */

package/Maths/math.like.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.like.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.like.ts"],"names":[],"mappings":"","sourcesContent":["import type { float, int, DeepImmutable, Tuple } from \"../types\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IColor3Like {\r\n    r: float;\r\n    g: float;\r\n    b: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IColor4Like extends IColor3Like {\r\n    a: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector2Like {\r\n    x: float;\r\n    y: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector3Like extends IVector2Like {\r\n    z: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector4Like extends IVector3Like {\r\n    w: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IQuaternionLike extends IVector3Like {\r\n    w: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IPlaneLike {\r\n    normal: IVector3Like;\r\n    d: float;\r\n    normalize(): void;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IMatrixLike {\r\n    asArray(): DeepImmutable<Tuple<number, 16>>;\r\n    updateFlag: int;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IViewportLike {\r\n    x: float;\r\n    y: float;\r\n    width: float;\r\n    height: float;\r\n}\r\n"]}
+{"version":3,"file":"math.like.js","sourceRoot":"","sources":["../../../../dev/core/src/Maths/math.like.ts"],"names":[],"mappings":"","sourcesContent":["import type { float, int, DeepImmutable, Tuple } from \"../types\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IColor3Like {\r\n    r: float;\r\n    g: float;\r\n    b: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IColor4Like extends IColor3Like {\r\n    a: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector2Like {\r\n    x: float;\r\n    y: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector3Like extends IVector2Like {\r\n    z: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface Vector3LikeInternal {\r\n    _x: number;\r\n    _y: number;\r\n    _z: number;\r\n    _isDirty?: boolean;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IVector4Like extends IVector3Like {\r\n    w: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IQuaternionLike extends IVector3Like {\r\n    w: float;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IPlaneLike {\r\n    normal: IVector3Like;\r\n    d: float;\r\n    normalize(): void;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IMatrixLike {\r\n    asArray(): DeepImmutable<Tuple<number, 16>>;\r\n    updateFlag: int;\r\n}\r\n\r\n/**\r\n * @internal\r\n */\r\nexport interface IViewportLike {\r\n    x: float;\r\n    y: float;\r\n    width: float;\r\n    height: float;\r\n}\r\n"]}

package/Maths/math.vector.d.ts

@@ -3,7 +3,7 @@ import type { DeepImmutable, Nullable, FloatArray, float, Tuple } from "../types
 import type { Plane } from "./math.plane";
 import type { TransformNode } from "../Meshes/transformNode";
 import type { Dimension, Tensor, TensorLike, TensorStatic } from "./tensor";
-import type { IVector2Like, IVector3Like, IVector4Like, IQuaternionLike, IMatrixLike, IPlaneLike } from "./math.like";
+import type { IVector2Like, IVector3Like, IVector4Like, IQuaternionLike, IMatrixLike, IPlaneLike, Vector3LikeInternal } from "./math.like";
 /**
  * Represents a vector of any dimension
  */
@@ -726,7 +726,7 @@ export declare class Vector2 implements Vector<Tuple<number, 2>, IVector2Like>,
  * Reminder: js uses a left handed forward facing system
  * Example Playground - Overview - https://playground.babylonjs.com/#R1F8YU
  */
-export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVector3Like {
+export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3LikeInternal>, IVector3Like {
     private static _UpReadOnly;
     private static _DownReadOnly;
     private static _LeftHandedForwardReadOnly;
@@ -835,7 +835,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param otherVector defines the second operand
      * @returns the resulting Vector3
      */
-    add(otherVector: DeepImmutable<Vector3>): Vector3;
+    add(otherVector: DeepImmutable<Vector3LikeInternal>): Vector3;
     /**
      * Adds the current Vector3 to the given one and stores the result in the vector "result"
      * Example Playground https://playground.babylonjs.com/#R1F8YU#6
@@ -843,21 +843,21 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    addToRef<T extends Vector3>(otherVector: DeepImmutable<Vector3>, result: T): T;
+    addToRef<T extends Vector3LikeInternal>(otherVector: DeepImmutable<Vector3LikeInternal>, result: T): T;
     /**
      * Subtract the given vector from the current Vector3
      * Example Playground https://playground.babylonjs.com/#R1F8YU#61
      * @param otherVector defines the second operand
      * @returns the current updated Vector3
      */
-    subtractInPlace(otherVector: DeepImmutable<Vector3>): this;
+    subtractInPlace(otherVector: DeepImmutable<Vector3LikeInternal>): this;
     /**
      * Returns a new Vector3, result of the subtraction of the given vector from the current Vector3
      * Example Playground https://playground.babylonjs.com/#R1F8YU#60
      * @param otherVector defines the second operand
      * @returns the resulting Vector3
      */
-    subtract(otherVector: DeepImmutable<Vector3>): Vector3;
+    subtract(otherVector: DeepImmutable<Vector3LikeInternal>): Vector3;
     /**
      * Subtracts the given vector from the current Vector3 and stores the result in the vector "result".
      * Example Playground https://playground.babylonjs.com/#R1F8YU#63
@@ -865,7 +865,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    subtractToRef<T extends Vector3>(otherVector: DeepImmutable<Vector3>, result: T): T;
+    subtractToRef<T extends Vector3LikeInternal>(otherVector: DeepImmutable<Vector3LikeInternal>, result: T): T;
     /**
      * Returns a new Vector3 set with the subtraction of the given floats from the current Vector3 coordinates
      * Example Playground https://playground.babylonjs.com/#R1F8YU#62
@@ -884,7 +884,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    subtractFromFloatsToRef<T extends Vector3>(x: number, y: number, z: number, result: T): T;
+    subtractFromFloatsToRef<T extends Vector3LikeInternal>(x: number, y: number, z: number, result: T): T;
     /**
      * Gets a new Vector3 set with the current Vector3 negated coordinates
      * Example Playground https://playground.babylonjs.com/#R1F8YU#35
@@ -903,7 +903,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    negateToRef<T extends Vector3 = Vector3>(result: T): T;
+    negateToRef<T extends Vector3LikeInternal>(result: T): T;
     /**
      * Multiplies the Vector3 coordinates by the float "scale"
      * Example Playground https://playground.babylonjs.com/#R1F8YU#56
@@ -925,7 +925,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    scaleToRef<T extends Vector3>(scale: number, result: T): T;
+    scaleToRef<T extends Vector3LikeInternal>(scale: number, result: T): T;
     /**
      * Creates a vector normal (perpendicular) to the current Vector3 and stores the result in the given vector
      * Out of the infinite possibilities the normal chosen is the one formed by rotating the current vector
@@ -967,7 +967,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns result input
      */
-    scaleAndAddToRef<T extends Vector3>(scale: number, result: T): T;
+    scaleAndAddToRef<T extends Vector3LikeInternal>(scale: number, result: T): T;
     /**
      * Projects the current point Vector3 to a plane along a ray starting from a specified origin and passing through the current point Vector3.
      * Example Playground https://playground.babylonjs.com/#R1F8YU#48
@@ -1015,14 +1015,14 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param otherVector defines the second operand
      * @returns the current updated Vector3
      */
-    multiplyInPlace(otherVector: DeepImmutable<Vector3>): this;
+    multiplyInPlace(otherVector: DeepImmutable<Vector3LikeInternal>): this;
     /**
      * Returns a new Vector3, result of the multiplication of the current Vector3 by the given vector
      * Example Playground https://playground.babylonjs.com/#R1F8YU#31
      * @param otherVector defines the second operand
      * @returns the new Vector3
      */
-    multiply(otherVector: DeepImmutable<Vector3>): Vector3;
+    multiply(otherVector: DeepImmutable<Vector3LikeInternal>): Vector3;
     /**
      * Multiplies the current Vector3 by the given one and stores the result in the given vector "result"
      * Example Playground https://playground.babylonjs.com/#R1F8YU#33
@@ -1030,7 +1030,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    multiplyToRef<T extends Vector3>(otherVector: DeepImmutable<Vector3>, result: T): T;
+    multiplyToRef<T extends Vector3LikeInternal>(otherVector: DeepImmutable<Vector3LikeInternal>, result: T): T;
     /**
      * Returns a new Vector3 set with the result of the multiplication of the current Vector3 coordinates by the given floats
      * Example Playground https://playground.babylonjs.com/#R1F8YU#34
@@ -1046,7 +1046,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param otherVector defines the second operand
      * @returns the new Vector3
      */
-    divide(otherVector: DeepImmutable<Vector3>): Vector3;
+    divide(otherVector: DeepImmutable<Vector3LikeInternal>): Vector3;
     /**
      * Divides the current Vector3 coordinates by the given ones and stores the result in the given vector "result"
      * Example Playground https://playground.babylonjs.com/#R1F8YU#18
@@ -1054,28 +1054,28 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result defines the Vector3 object where to store the result
      * @returns the result
      */
-    divideToRef<T extends Vector3>(otherVector: DeepImmutable<Vector3>, result: T): T;
+    divideToRef<T extends Vector3LikeInternal>(otherVector: DeepImmutable<Vector3LikeInternal>, result: T): T;
     /**
      * Divides the current Vector3 coordinates by the given ones.
      * Example Playground https://playground.babylonjs.com/#R1F8YU#17
      * @param otherVector defines the second operand
      * @returns the current updated Vector3
      */
-    divideInPlace(otherVector: DeepImmutable<Vector3>): this;
+    divideInPlace(otherVector: DeepImmutable<Vector3LikeInternal>): this;
     /**
      * Updates the current Vector3 with the minimal coordinate values between its and the given vector ones
      * Example Playground https://playground.babylonjs.com/#R1F8YU#29
      * @param other defines the second operand
      * @returns the current updated Vector3
      */
-    minimizeInPlace(other: DeepImmutable<Vector3>): this;
+    minimizeInPlace(other: DeepImmutable<Vector3LikeInternal>): this;
     /**
      * Updates the current Vector3 with the maximal coordinate values between its and the given vector ones.
      * Example Playground https://playground.babylonjs.com/#R1F8YU#27
      * @param other defines the second operand
      * @returns the current updated Vector3
      */
-    maximizeInPlace(other: DeepImmutable<Vector3>): this;
+    maximizeInPlace(other: DeepImmutable<Vector3LikeInternal>): this;
     /**
      * Updates the current Vector3 with the minimal coordinate values between its and the given coordinates
      * Example Playground https://playground.babylonjs.com/#R1F8YU#30
@@ -1110,7 +1110,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result the vector to store the result in
      * @returns the result vector
      */
-    floorToRef<T extends Vector3>(result: T): T;
+    floorToRef<T extends Vector3LikeInternal>(result: T): T;
     /**
      * Gets a new Vector3 from current Vector3 floored values
      * Example Playground https://playground.babylonjs.com/#R1F8YU#22
@@ -1122,7 +1122,7 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
      * @param result the vector to store the result in
      * @returns the result vector
      */
-    fractToRef<T extends Vector3>(result: T): T;
+    fractToRef<T extends Vector3LikeInternal>(result: T): T;
     /**
      * Gets a new Vector3 from current Vector3 fractional values
      * Example Playground https://playground.babylonjs.com/#R1F8YU#23
@@ -1202,10 +1202,10 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, Vector3>, IVect
     /**
      * Normalize the current Vector3 to the reference
      * Example Playground https://playground.babylonjs.com/#R1F8YU#125
-     * @param reference define the Vector3 to update
+     * @param result define the Vector3 to update
      * @returns the updated Vector3
      */
-    normalizeToRef<T extends Vector3>(reference: T): T;
+    normalizeToRef<T extends Vector3LikeInternal>(result: T): T;
     /**
      * Creates a new Vector3 copied from the current Vector3
      * Example Playground https://playground.babylonjs.com/#R1F8YU#11

package/Maths/math.vector.js

@@ -1098,7 +1098,11 @@ export class Vector3 {
      * @returns the result
      */
     addToRef(otherVector, result) {
-        return result.copyFromFloats(this._x + otherVector._x, this._y + otherVector._y, this._z + otherVector._z);
+        result._x = this._x + otherVector._x;
+        result._y = this._y + otherVector._y;
+        result._z = this._z + otherVector._z;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Subtract the given vector from the current Vector3
@@ -1153,7 +1157,11 @@ export class Vector3 {
      * @returns the result
      */
     subtractFromFloatsToRef(x, y, z, result) {
-        return result.copyFromFloats(this._x - x, this._y - y, this._z - z);
+        result._x = this._x - x;
+        result._y = this._y - y;
+        result._z = this._z - z;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Gets a new Vector3 set with the current Vector3 negated coordinates
@@ -1182,7 +1190,11 @@ export class Vector3 {
      * @returns the result
      */
     negateToRef(result) {
-        return result.copyFromFloats(this._x * -1, this._y * -1, this._z * -1);
+        result._x = this._x * -1;
+        result._y = this._y * -1;
+        result._z = this._z * -1;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Multiplies the Vector3 coordinates by the float "scale"
@@ -1214,7 +1226,11 @@ export class Vector3 {
      * @returns the result
      */
     scaleToRef(scale, result) {
-        return result.copyFromFloats(this._x * scale, this._y * scale, this._z * scale);
+        result._x = this._x * scale;
+        result._y = this._y * scale;
+        result._z = this._z * scale;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Creates a vector normal (perpendicular) to the current Vector3 and stores the result in the given vector
@@ -1297,7 +1313,11 @@ export class Vector3 {
      * @returns result input
      */
     scaleAndAddToRef(scale, result) {
-        return result.addInPlaceFromFloats(this._x * scale, this._y * scale, this._z * scale);
+        result._x += this._x * scale;
+        result._y += this._y * scale;
+        result._z += this._z * scale;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Projects the current point Vector3 to a plane along a ray starting from a specified origin and passing through the current point Vector3.
@@ -1397,7 +1417,11 @@ export class Vector3 {
      * @returns the result
      */
     multiplyToRef(otherVector, result) {
-        return result.copyFromFloats(this._x * otherVector._x, this._y * otherVector._y, this._z * otherVector._z);
+        result._x = this._x * otherVector._x;
+        result._y = this._y * otherVector._y;
+        result._z = this._z * otherVector._z;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Returns a new Vector3 set with the result of the multiplication of the current Vector3 coordinates by the given floats
@@ -1427,7 +1451,11 @@ export class Vector3 {
      * @returns the result
      */
     divideToRef(otherVector, result) {
-        return result.copyFromFloats(this._x / otherVector._x, this._y / otherVector._y, this._z / otherVector._z);
+        result._x = this._x / otherVector._x;
+        result._y = this._y / otherVector._y;
+        result._z = this._z / otherVector._z;
+        result._isDirty = true;
+        return result;
     }
     /**
      * Divides the current Vector3 coordinates by the given ones.
@@ -1686,15 +1714,19 @@ export class Vector3 {
     /**
      * Normalize the current Vector3 to the reference
      * Example Playground https://playground.babylonjs.com/#R1F8YU#125
-     * @param reference define the Vector3 to update
+     * @param result define the Vector3 to update
      * @returns the updated Vector3
      */
-    normalizeToRef(reference) {
+    normalizeToRef(result) {
         const len = this.length();
         if (len === 0 || len === 1.0) {
-            return reference.copyFrom(this);
+            result._x = this._x;
+            result._y = this._y;
+            result._z = this._z;
+            result._isDirty = true;
+            return result;
         }
-        return this.scaleToRef(1.0 / len, reference);
+        return this.scaleToRef(1.0 / len, result);
     }
     /**
      * Creates a new Vector3 copied from the current Vector3