@babylonjs/core 5.45.2 → 5.47.0

package/Maths/math.vector.js

@@ -436,6 +436,15 @@ export class Vector2 {
     static One() {
         return new Vector2(1, 1);
     }
+    /**
+     * Returns a new Vector2 with random values between min and max
+     * @param min the minimum random value
+     * @param max the maximum random value
+     * @returns a Vector2 with random values between min and max
+     */
+    static Random(min = 0, max = 1) {
+        return new Vector2(Scalar.RandomRange(min, max), Scalar.RandomRange(min, max));
+    }
     /**
      * Gets a zero Vector2 that must not be updated
      */
@@ -753,19 +762,6 @@ Vector2._ZeroReadOnly = Vector2.Zero();
  * Example Playground - Overview - https://playground.babylonjs.com/#R1F8YU
  */
 export class Vector3 {
-    /**
-     * Creates a new Vector3 object from the given x, y, z (floats) coordinates.
-     * @param x defines the first coordinates (on X axis)
-     * @param y defines the second coordinates (on Y axis)
-     * @param z defines the third coordinates (on Z axis)
-     */
-    constructor(x = 0, y = 0, z = 0) {
-        /** @internal */
-        this._isDirty = true;
-        this._x = x;
-        this._y = y;
-        this._z = z;
-    }
     /** Gets or sets the x coordinate */
     get x() {
         return this._x;
@@ -790,6 +786,19 @@ export class Vector3 {
         this._z = value;
         this._isDirty = true;
     }
+    /**
+     * Creates a new Vector3 object from the given x, y, z (floats) coordinates.
+     * @param x defines the first coordinates (on X axis)
+     * @param y defines the second coordinates (on Y axis)
+     * @param z defines the third coordinates (on Z axis)
+     */
+    constructor(x = 0, y = 0, z = 0) {
+        /** @internal */
+        this._isDirty = true;
+        this._x = x;
+        this._y = y;
+        this._z = z;
+    }
     /**
      * Creates a string representation of the Vector3
      * Example Playground https://playground.babylonjs.com/#R1F8YU#67
@@ -1839,6 +1848,15 @@ export class Vector3 {
     static Left() {
         return new Vector3(-1.0, 0.0, 0.0);
     }
+    /**
+     * Returns a new Vector3 with random values between min and max
+     * @param min the minimum random value
+     * @param max the maximum random value
+     * @returns a Vector3 with random values between min and max
+     */
+    static Random(min = 0, max = 1) {
+        return new Vector3(Scalar.RandomRange(min, max), Scalar.RandomRange(min, max), Scalar.RandomRange(min, max));
+    }
     /**
      * Returns a new Vector3 set with the result of the transformation by the given matrix of the given vector.
      * This method computes transformed coordinates only, not transformed direction vectors (ie. it takes translation in account)
@@ -3129,6 +3147,15 @@ export class Vector4 {
     static One() {
         return new Vector4(1.0, 1.0, 1.0, 1.0);
     }
+    /**
+     * Returns a new Vector4 with random values between min and max
+     * @param min the minimum random value
+     * @param max the maximum random value
+     * @returns a Vector4 with random values between min and max
+     */
+    static Random(min = 0, max = 1) {
+        return new Vector4(Scalar.RandomRange(min, max), Scalar.RandomRange(min, max), Scalar.RandomRange(min, max), Scalar.RandomRange(min, max));
+    }
     /**
      * Gets a zero Vector4 that must not be updated
      */
@@ -3338,21 +3365,6 @@ Vector4._ZeroReadOnly = Vector4.Zero();
  * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/transforms
  */
 export class Quaternion {
-    /**
-     * Creates a new Quaternion from the given floats
-     * @param x defines the first component (0 by default)
-     * @param y defines the second component (0 by default)
-     * @param z defines the third component (0 by default)
-     * @param w defines the fourth component (1.0 by default)
-     */
-    constructor(x = 0.0, y = 0.0, z = 0.0, w = 1.0) {
-        /** @internal */
-        this._isDirty = true;
-        this._x = x;
-        this._y = y;
-        this._z = z;
-        this._w = w;
-    }
     /** Gets or sets the x coordinate */
     get x() {
         return this._x;
@@ -3385,6 +3397,21 @@ export class Quaternion {
         this._w = value;
         this._isDirty = true;
     }
+    /**
+     * Creates a new Quaternion from the given floats
+     * @param x defines the first component (0 by default)
+     * @param y defines the second component (0 by default)
+     * @param z defines the third component (0 by default)
+     * @param w defines the fourth component (1.0 by default)
+     */
+    constructor(x = 0.0, y = 0.0, z = 0.0, w = 1.0) {
+        /** @internal */
+        this._isDirty = true;
+        this._x = x;
+        this._y = y;
+        this._z = z;
+        this._w = w;
+    }
     /**
      * Gets a string representation for the current quaternion
      * @returns a string with the Quaternion coordinates
@@ -4371,26 +4398,6 @@ export class Quaternion {
  * Example Playground - Overview Projection - https://playground.babylonjs.com/#AV9X17#2
  */
 export class Matrix {
-    /**
-     * Creates an empty matrix (filled with zeros)
-     */
-    constructor() {
-        this._isIdentity = false;
-        this._isIdentityDirty = true;
-        this._isIdentity3x2 = true;
-        this._isIdentity3x2Dirty = true;
-        /**
-         * Gets the update flag of the matrix which is an unique number for the matrix.
-         * It will be incremented every time the matrix data change.
-         * You can use it to speed the comparison between two versions of the same matrix.
-         */
-        this.updateFlag = -1;
-        if (PerformanceConfigurator.MatrixTrackPrecisionChange) {
-            PerformanceConfigurator.MatrixTrackedMatrices.push(this);
-        }
-        this._m = new PerformanceConfigurator.MatrixCurrentType(16);
-        this.markAsUpdated();
-    }
     /**
      * Gets the precision of matrix computations
      */
@@ -4419,6 +4426,26 @@ export class Matrix {
         this._isIdentityDirty = this._isIdentity ? false : isIdentityDirty;
         this._isIdentity3x2Dirty = this._isIdentity3x2 ? false : isIdentity3x2Dirty;
     }
+    /**
+     * Creates an empty matrix (filled with zeros)
+     */
+    constructor() {
+        this._isIdentity = false;
+        this._isIdentityDirty = true;
+        this._isIdentity3x2 = true;
+        this._isIdentity3x2Dirty = true;
+        /**
+         * Gets the update flag of the matrix which is an unique number for the matrix.
+         * It will be incremented every time the matrix data change.
+         * You can use it to speed the comparison between two versions of the same matrix.
+         */
+        this.updateFlag = -1;
+        if (PerformanceConfigurator.MatrixTrackPrecisionChange) {
+            PerformanceConfigurator.MatrixTrackedMatrices.push(this);
+        }
+        this._m = new PerformanceConfigurator.MatrixCurrentType(16);
+        this.markAsUpdated();
+    }
     // Properties
     /**
      * Check if the current matrix is identity