@babylonjs/core 5.38.0 → 5.40.0

package/Maths/math.vector.d.ts

@@ -2632,20 +2632,25 @@ export declare class Quaternion {
 }
 /**
  * Class used to store matrix data (4x4)
- * Note on matrix definitions in Babylon.js for setting values directly rather than using one of the methods available.
+ * Note on matrix definitions in Babylon.js for setting values directly
+ * rather than using one of the methods available.
  * Matrix size is given by rows x columns.
  * A Vector3 is a 1 X 3 matrix [x, y, z].
+ *
  * In Babylon.js multiplying a 1 x 3 matrix by a 4 x 4 matrix
- * is done using BABYLON.Vector4.TransformCoordinates(vector3, matrix)
- * and extending the passed Vector3 to a Vector4 [x, y, z, w] with w = 1.
- * The multiplication has this form
- * [x, y, z, w] |m0,  m1,  m2,  m3 |
- *              |m4,  m5,  m6,  m7 |
- *              |m8,  m9,  m10, m11|
- *              |m12, m13, m14, m15|
+ * is done using BABYLON.Vector4.TransformCoordinates(Vector3, Matrix).
+ * and extending the passed Vector3 to a Vector4, V = [x, y, z, 1].
+ * Let M be a matrix with elements m(row, column), so that
+ * m(2, 3) is the element in row 2 column 3 of M.
  *
- * = [xm0 + ym4 + zm8 + wm12, xm1 + ym5 + zm9 + wm13, xm2 + ym6 + zm10 + wm14, xm3 + ym7 + zm11 + wm15]
+ * Multiplication is of the form VM and has the resulting Vector4
+ * VM = [xm(0, 0) + ym(1, 0) + zm(2, 0) + m(3, 0), xm(0, 1) + ym(1, 1) + zm(2, 1) + m(3, 1), xm(0, 2) + ym(1, 2) + zm(2, 2) + m(3, 2), xm(0, 3) + ym(1, 3) + zm(2, 3) + m(3, 3)].
+ * On the web you will find many examples that use the opposite convention of MV,
+ * in which case to make use of the examples you will need to transpose the matrix.
  *
+ * Example Playground - Overview Linear Algebra - https://playground.babylonjs.com/#AV9X17
+ * Example Playground - Overview Transformation - https://playground.babylonjs.com/#AV9X17#1
+ * Example Playground - Overview Projection - https://playground.babylonjs.com/#AV9X17#2
  */
 export declare class Matrix {
     /**
@@ -2690,21 +2695,25 @@ export declare class Matrix {
     isIdentityAs3x2(): boolean;
     /**
      * Gets the determinant of the matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#34
      * @returns the matrix determinant
      */
     determinant(): number;
     /**
      * Returns the matrix as a Float32Array or Array<number>
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#49
      * @returns the matrix underlying array
      */
     toArray(): DeepImmutable<Float32Array | Array<number>>;
     /**
      * Returns the matrix as a Float32Array or Array<number>
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#114
      * @returns the matrix underlying array.
      */
     asArray(): DeepImmutable<Float32Array | Array<number>>;
     /**
      * Inverts the current matrix in place
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#118
      * @returns the current inverted matrix
      */
     invert(): this;
@@ -2715,12 +2724,14 @@ export declare class Matrix {
     reset(): this;
     /**
      * Adds the current matrix with a second one
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#44
      * @param other defines the matrix to add
      * @returns a new matrix as the addition of the current matrix and the given one
      */
     add(other: DeepImmutable<Matrix>): this;
     /**
      * Sets the given matrix "result" to the addition of the current matrix and the given one
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#45
      * @param other defines the matrix to add
      * @param result defines the target matrix
      * @returns result input
@@ -2728,18 +2739,21 @@ export declare class Matrix {
     addToRef<T extends Matrix>(other: DeepImmutable<Matrix>, result: T): T;
     /**
      * Adds in place the given matrix to the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#46
      * @param other defines the second operand
      * @returns the current updated matrix
      */
     addToSelf(other: DeepImmutable<Matrix>): this;
     /**
      * Sets the given matrix to the current inverted Matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#119
      * @param other defines the target matrix
      * @returns result input
      */
     invertToRef<T extends Matrix>(other: T): T;
     /**
      * add a value at the specified position in the current Matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#47
      * @param index the index of the value within the matrix. between 0 and 15.
      * @param value the value to be added
      * @returns the current updated matrix
@@ -2754,6 +2768,7 @@ export declare class Matrix {
     multiplyAtIndex(index: number, value: number): this;
     /**
      * Inserts the translation vector (using 3 floats) in the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#120
      * @param x defines the 1st component of the translation
      * @param y defines the 2nd component of the translation
      * @param z defines the 3rd component of the translation
@@ -2762,6 +2777,8 @@ export declare class Matrix {
     setTranslationFromFloats(x: number, y: number, z: number): this;
     /**
      * Adds the translation vector (using 3 floats) in the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#20
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#48
      * @param x defines the 1st component of the translation
      * @param y defines the 2nd component of the translation
      * @param z defines the 3rd component of the translation
@@ -2770,17 +2787,20 @@ export declare class Matrix {
     addTranslationFromFloats(x: number, y: number, z: number): this;
     /**
      * Inserts the translation vector in the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#121
      * @param vector3 defines the translation to insert
      * @returns the current updated matrix
      */
     setTranslation(vector3: DeepImmutable<Vector3>): this;
     /**
      * Gets the translation value of the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#122
      * @returns a new Vector3 as the extracted translation from the matrix
      */
     getTranslation(): Vector3;
     /**
      * Fill a Vector3 with the extracted translation from the matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#123
      * @param result defines the Vector3 where to store the translation
      * @returns the current matrix
      */
@@ -2792,6 +2812,7 @@ export declare class Matrix {
     removeRotationAndScaling(): this;
     /**
      * Multiply two matrices
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#15
      * A.multiply(B) means apply B to A so result is B x A
      * @param other defines the second operand
      * @returns a new matrix set with the multiplication result of the current Matrix and the given one
@@ -2799,6 +2820,7 @@ export declare class Matrix {
     multiply(other: DeepImmutable<Matrix>): this;
     /**
      * Copy the current matrix from the given one
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#21
      * @param other defines the source matrix
      * @returns the current updated matrix
      */
@@ -2813,6 +2835,7 @@ export declare class Matrix {
     /**
      * Sets the given matrix "result" with the multiplication result of the current Matrix and the given one
      * A.multiplyToRef(B, R) means apply B to A and store in R and R = B x A
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#16
      * @param other defines the second operand
      * @param result defines the matrix where to store the multiplication
      * @returns result input
@@ -2834,6 +2857,7 @@ export declare class Matrix {
     equals(value: DeepImmutable<Matrix>): boolean;
     /**
      * Clone the current matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#18
      * @returns a new matrix from the current matrix
      */
     clone(): this;
@@ -2849,12 +2873,14 @@ export declare class Matrix {
     getHashCode(): number;
     /**
      * Decomposes the current Matrix into a translation, rotation and scaling components of the provided node
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#13
      * @param node the node to decompose the matrix to
      * @returns true if operation was successful
      */
     decomposeToTransformNode(node: TransformNode): boolean;
     /**
      * Decomposes the current Matrix into a translation, rotation and scaling components
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#12
      * @param scale defines the scale vector3 given as a reference to update
      * @param rotation defines the rotation quaternion given as a reference to update
      * @param translation defines the translation vector3 given as a reference to update
@@ -2864,12 +2890,14 @@ export declare class Matrix {
     decompose(scale?: Vector3, rotation?: Quaternion, translation?: Vector3, preserveScalingNode?: TransformNode): boolean;
     /**
      * Gets specific row of the matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#36
      * @param index defines the number of the row to get
      * @returns the index-th row of the current matrix as a new Vector4
      */
     getRow(index: number): Nullable<Vector4>;
     /**
      * Gets specific row of the matrix to ref
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#36
      * @param index defines the number of the row to get
      * @param rowVector vector to store the index-th row of the current matrix
      * @returns result input
@@ -2877,6 +2905,7 @@ export declare class Matrix {
     getRowToRef<T extends Vector4>(index: number, rowVector: T): T;
     /**
      * Sets the index-th row of the current matrix to the vector4 values
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#36
      * @param index defines the number of the row to set
      * @param row defines the target vector4
      * @returns the updated current matrix
@@ -2884,17 +2913,20 @@ export declare class Matrix {
     setRow(index: number, row: Vector4): this;
     /**
      * Compute the transpose of the matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#40
      * @returns the new transposed matrix
      */
     transpose(): this;
     /**
      * Compute the transpose of the matrix and store it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#41
      * @param result defines the target matrix
      * @returns result input
      */
     transposeToRef<T extends Matrix>(result: T): T;
     /**
      * Sets the index-th row of the current matrix with the given 4 x float values
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#36
      * @param index defines the row index
      * @param x defines the x component to set
      * @param y defines the y component to set
@@ -2925,6 +2957,7 @@ export declare class Matrix {
     scaleAndAddToRef<T extends Matrix>(scale: number, result: T): T;
     /**
      * Writes to the given matrix a normal matrix, computed from this one (using values from identity matrix for fourth row and column).
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#17
      * @param ref matrix to store the result
      */
     toNormalMatrix<T extends Matrix>(ref: T): T;
@@ -2949,6 +2982,7 @@ export declare class Matrix {
     toggleProjectionMatrixHandInPlace(): this;
     /**
      * Creates a matrix from an array
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#42
      * @param array defines the source array
      * @param offset defines an offset in the source array
      * @returns a new Matrix set from the starting index of the given array
@@ -2956,6 +2990,7 @@ export declare class Matrix {
     static FromArray(array: DeepImmutable<ArrayLike<number>>, offset?: number): Matrix;
     /**
      * Copy the content of an array into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#43
      * @param array defines the source array
      * @param offset defines an offset in the source array
      * @param result defines the target matrix
@@ -2964,6 +2999,7 @@ export declare class Matrix {
     static FromArrayToRef<T extends Matrix>(array: DeepImmutable<ArrayLike<number>>, offset: number, result: T): T;
     /**
      * Stores an array into a matrix after having multiplied each component by a given factor
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#50
      * @param array defines the source array
      * @param offset defines the offset in the source array
      * @param scale defines the scaling factor
@@ -3020,6 +3056,7 @@ export declare class Matrix {
     static FromValues(initialM11: number, initialM12: number, initialM13: number, initialM14: number, initialM21: number, initialM22: number, initialM23: number, initialM24: number, initialM31: number, initialM32: number, initialM33: number, initialM34: number, initialM41: number, initialM42: number, initialM43: number, initialM44: number): Matrix;
     /**
      * Creates a new matrix composed by merging scale (vector3), rotation (quaternion) and translation (vector3)
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#24
      * @param scale defines the scale vector3
      * @param rotation defines the rotation quaternion
      * @param translation defines the translation vector3
@@ -3028,6 +3065,7 @@ export declare class Matrix {
     static Compose(scale: DeepImmutable<Vector3>, rotation: DeepImmutable<Quaternion>, translation: DeepImmutable<Vector3>): Matrix;
     /**
      * Sets a matrix to a value composed by merging scale (vector3), rotation (quaternion) and translation (vector3)
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#25
      * @param scale defines the scale vector3
      * @param rotation defines the rotation quaternion
      * @param translation defines the translation vector3
@@ -3053,18 +3091,21 @@ export declare class Matrix {
     static Zero(): Matrix;
     /**
      * Creates a new rotation matrix for "angle" radians around the X axis
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#97
      * @param angle defines the angle (in radians) to use
      * @returns the new matrix
      */
     static RotationX(angle: number): Matrix;
     /**
      * Creates a new matrix as the invert of a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#124
      * @param source defines the source matrix
      * @returns the new matrix
      */
     static Invert<T extends Matrix>(source: DeepImmutable<T>): T;
     /**
      * Creates a new rotation matrix for "angle" radians around the X axis and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#98
      * @param angle defines the angle (in radians) to use
      * @param result defines the target matrix
      * @returns result input
@@ -3072,12 +3113,14 @@ export declare class Matrix {
     static RotationXToRef<T extends Matrix>(angle: number, result: T): T;
     /**
      * Creates a new rotation matrix for "angle" radians around the Y axis
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#99
      * @param angle defines the angle (in radians) to use
      * @returns the new matrix
      */
     static RotationY(angle: number): Matrix;
     /**
      * Creates a new rotation matrix for "angle" radians around the Y axis and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#100
      * @param angle defines the angle (in radians) to use
      * @param result defines the target matrix
      * @returns result input
@@ -3085,12 +3128,14 @@ export declare class Matrix {
     static RotationYToRef<T extends Matrix>(angle: number, result: T): T;
     /**
      * Creates a new rotation matrix for "angle" radians around the Z axis
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#101
      * @param angle defines the angle (in radians) to use
      * @returns the new matrix
      */
     static RotationZ(angle: number): Matrix;
     /**
      * Creates a new rotation matrix for "angle" radians around the Z axis and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#102
      * @param angle defines the angle (in radians) to use
      * @param result defines the target matrix
      * @returns result input
@@ -3098,6 +3143,7 @@ export declare class Matrix {
     static RotationZToRef<T extends Matrix>(angle: number, result: T): T;
     /**
      * Creates a new rotation matrix for "angle" radians around the given axis
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#96
      * @param axis defines the axis to use
      * @param angle defines the angle (in radians) to use
      * @returns the new matrix
@@ -3105,6 +3151,7 @@ export declare class Matrix {
     static RotationAxis(axis: DeepImmutable<Vector3>, angle: number): Matrix;
     /**
      * Creates a new rotation matrix for "angle" radians around the given axis and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#94
      * @param axis defines the axis to use
      * @param angle defines the angle (in radians) to use
      * @param result defines the target matrix
@@ -3114,6 +3161,7 @@ export declare class Matrix {
     /**
      * Takes normalised vectors and returns a rotation matrix to align "from" with "to".
      * Taken from http://www.iquilezles.org/www/articles/noacos/noacos.htm
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#93
      * @param from defines the vector to align
      * @param to defines the vector to align to
      * @param result defines the target matrix
@@ -3122,6 +3170,8 @@ export declare class Matrix {
     static RotationAlignToRef<T extends Matrix>(from: DeepImmutable<Vector3>, to: DeepImmutable<Vector3>, result: T): T;
     /**
      * Creates a rotation matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#103
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#105
      * @param yaw defines the yaw angle in radians (Y axis)
      * @param pitch defines the pitch angle in radians (X axis)
      * @param roll defines the roll angle in radians (Z axis)
@@ -3130,6 +3180,7 @@ export declare class Matrix {
     static RotationYawPitchRoll(yaw: number, pitch: number, roll: number): Matrix;
     /**
      * Creates a rotation matrix and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#104
      * @param yaw defines the yaw angle in radians (Y axis)
      * @param pitch defines the pitch angle in radians (X axis)
      * @param roll defines the roll angle in radians (Z axis)
@@ -3139,6 +3190,7 @@ export declare class Matrix {
     static RotationYawPitchRollToRef<T extends Matrix>(yaw: number, pitch: number, roll: number, result: T): T;
     /**
      * Creates a scaling matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#107
      * @param x defines the scale factor on X axis
      * @param y defines the scale factor on Y axis
      * @param z defines the scale factor on Z axis
@@ -3147,6 +3199,7 @@ export declare class Matrix {
     static Scaling(x: number, y: number, z: number): Matrix;
     /**
      * Creates a scaling matrix and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#108
      * @param x defines the scale factor on X axis
      * @param y defines the scale factor on Y axis
      * @param z defines the scale factor on Z axis
@@ -3156,6 +3209,7 @@ export declare class Matrix {
     static ScalingToRef<T extends Matrix>(x: number, y: number, z: number, result: T): T;
     /**
      * Creates a translation matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#109
      * @param x defines the translation on X axis
      * @param y defines the translation on Y axis
      * @param z defines the translationon Z axis
@@ -3164,6 +3218,7 @@ export declare class Matrix {
     static Translation(x: number, y: number, z: number): Matrix;
     /**
      * Creates a translation matrix and stores it in a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#110
      * @param x defines the translation on X axis
      * @param y defines the translation on Y axis
      * @param z defines the translationon Z axis
@@ -3173,6 +3228,7 @@ export declare class Matrix {
     static TranslationToRef<T extends Matrix>(x: number, y: number, z: number, result: T): T;
     /**
      * Returns a new Matrix whose values are the interpolated values for "gradient" (float) between the ones of the matrices "startValue" and "endValue".
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#55
      * @param startValue defines the start value
      * @param endValue defines the end value
      * @param gradient defines the gradient factor
@@ -3181,6 +3237,7 @@ export declare class Matrix {
     static Lerp<T extends Matrix>(startValue: DeepImmutable<T>, endValue: DeepImmutable<Matrix>, gradient: number): T;
     /**
      * Set the given matrix "result" as the interpolated values for "gradient" (float) between the ones of the matrices "startValue" and "endValue".
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#54
      * @param startValue defines the start value
      * @param endValue defines the end value
      * @param gradient defines the gradient factor
@@ -3193,6 +3250,8 @@ export declare class Matrix {
      * * decomposing the the "startValue" and "endValue" matrices into their respective scale, rotation and translation matrices
      * * interpolating for "gradient" (float) the values between each of these decomposed matrices between the start and the end
      * * recomposing a new matrix from these 3 interpolated scale, rotation and translation matrices
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#22
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#51
      * @param startValue defines the first matrix
      * @param endValue defines the second matrix
      * @param gradient defines the gradient between the two matrices
@@ -3204,6 +3263,8 @@ export declare class Matrix {
      * * decomposing the the "startValue" and "endValue" matrices into their respective scale, rotation and translation matrices
      * * interpolating for "gradient" (float) the values between each of these decomposed matrices between the start and the end
      * * recomposing a new matrix from these 3 interpolated scale, rotation and translation matrices
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#23
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#53
      * @param startValue defines the first matrix
      * @param endValue defines the second matrix
      * @param gradient defines the gradient between the two matrices
@@ -3214,6 +3275,8 @@ export declare class Matrix {
     /**
      * Creates a new matrix that transforms vertices from world space to camera space. It takes three vectors as arguments that together describe the position and orientation of the camera.
      * This function generates a matrix suitable for a left handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#58
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#59
      * @param eye defines the final position of the entity
      * @param target defines where the entity should look at
      * @param up defines the up vector for the entity
@@ -3223,6 +3286,8 @@ export declare class Matrix {
     /**
      * Sets the given "result" Matrix to a matrix that transforms vertices from world space to camera space. It takes three vectors as arguments that together describe the position and orientation of the camera.
      * This function generates a matrix suitable for a left handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#60
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#61
      * @param eye defines the final position of the entity
      * @param target defines where the entity should look at
      * @param up defines the up vector for the entity
@@ -3233,6 +3298,8 @@ export declare class Matrix {
     /**
      * Creates a new matrix that transforms vertices from world space to camera space. It takes three vectors as arguments that together describe the position and orientation of the camera.
      * This function generates a matrix suitable for a right handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#62
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#63
      * @param eye defines the final position of the entity
      * @param target defines where the entity should look at
      * @param up defines the up vector for the entity
@@ -3242,6 +3309,8 @@ export declare class Matrix {
     /**
      * Sets the given "result" Matrix to a matrix that transforms vertices from world space to camera space. It takes three vectors as arguments that together describe the position and orientation of the camera.
      * This function generates a matrix suitable for a right handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#64
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#65
      * @param eye defines the final position of the entity
      * @param target defines where the entity should look at
      * @param up defines the up vector for the entity
@@ -3252,6 +3321,7 @@ export declare class Matrix {
     /**
      * Creates a new matrix that transforms vertices from world space to camera space. It takes two vectors as arguments that together describe the orientation of the camera. The position is assumed to be at the origin (0,0,0)
      * This function generates a matrix suitable for a left handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#66
      * @param forward defines the forward direction - Must be normalized and orthogonal to up.
      * @param up defines the up vector for the entity - Must be normalized and orthogonal to forward.
      * @returns the new matrix
@@ -3260,6 +3330,7 @@ export declare class Matrix {
     /**
      * Sets the given "result" Matrix to a matrix that transforms vertices from world space to camera space. It takes two vectors as arguments that together describe the orientation of the camera. The position is assumed to be at the origin (0,0,0)
      * This function generates a matrix suitable for a left handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#67
      * @param forward defines the forward direction - Must be normalized and orthogonal to up.
      * @param up defines the up vector for the entity - Must be normalized and orthogonal to forward.
      * @param result defines the target matrix
@@ -3269,6 +3340,7 @@ export declare class Matrix {
     /**
      * Creates a new matrix that transforms vertices from world space to camera space. It takes two vectors as arguments that together describe the orientation of the camera. The position is assumed to be at the origin (0,0,0)
      * This function generates a matrix suitable for a right handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#68
      * @param forward defines the forward direction - Must be normalized and orthogonal to up.
      * @param up defines the up vector for the entity - Must be normalized and orthogonal to forward.
      * @returns the new matrix
@@ -3277,6 +3349,7 @@ export declare class Matrix {
     /**
      * Sets the given "result" Matrix to a matrix that transforms vertices from world space to camera space. It takes two vectors as arguments that together describe the orientation of the camera. The position is assumed to be at the origin (0,0,0)
      * This function generates a matrix suitable for a right handed coordinate system
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#69
      * @param forward defines the forward direction - Must be normalized and orthogonal to up.
      * @param up defines the up vector for the entity - Must be normalized and orthogonal to forward.
      * @param result defines the target matrix
@@ -3285,6 +3358,7 @@ export declare class Matrix {
     static LookDirectionRHToRef<T extends Matrix>(forward: DeepImmutable<Vector3>, up: DeepImmutable<Vector3>, result: T): T;
     /**
      * Create a left-handed orthographic projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#70
      * @param width defines the viewport width
      * @param height defines the viewport height
      * @param znear defines the near clip plane
@@ -3295,6 +3369,7 @@ export declare class Matrix {
     static OrthoLH(width: number, height: number, znear: number, zfar: number, halfZRange?: boolean): Matrix;
     /**
      * Store a left-handed orthographic projection to a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#71
      * @param width defines the viewport width
      * @param height defines the viewport height
      * @param znear defines the near clip plane
@@ -3306,6 +3381,7 @@ export declare class Matrix {
     static OrthoLHToRef<T extends Matrix>(width: number, height: number, znear: number, zfar: number, result: T, halfZRange?: boolean): T;
     /**
      * Create a left-handed orthographic projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#72
      * @param left defines the viewport left coordinate
      * @param right defines the viewport right coordinate
      * @param bottom defines the viewport bottom coordinate
@@ -3318,6 +3394,7 @@ export declare class Matrix {
     static OrthoOffCenterLH(left: number, right: number, bottom: number, top: number, znear: number, zfar: number, halfZRange?: boolean): Matrix;
     /**
      * Stores a left-handed orthographic projection into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#73
      * @param left defines the viewport left coordinate
      * @param right defines the viewport right coordinate
      * @param bottom defines the viewport bottom coordinate
@@ -3331,6 +3408,7 @@ export declare class Matrix {
     static OrthoOffCenterLHToRef<T extends Matrix>(left: number, right: number, bottom: number, top: number, znear: number, zfar: number, result: T, halfZRange?: boolean): T;
     /**
      * Creates a right-handed orthographic projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#76
      * @param left defines the viewport left coordinate
      * @param right defines the viewport right coordinate
      * @param bottom defines the viewport bottom coordinate
@@ -3343,6 +3421,7 @@ export declare class Matrix {
     static OrthoOffCenterRH(left: number, right: number, bottom: number, top: number, znear: number, zfar: number, halfZRange?: boolean): Matrix;
     /**
      * Stores a right-handed orthographic projection into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#77
      * @param left defines the viewport left coordinate
      * @param right defines the viewport right coordinate
      * @param bottom defines the viewport bottom coordinate
@@ -3356,6 +3435,7 @@ export declare class Matrix {
     static OrthoOffCenterRHToRef<T extends Matrix>(left: number, right: number, bottom: number, top: number, znear: number, zfar: number, result: T, halfZRange?: boolean): T;
     /**
      * Creates a left-handed perspective projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#85
      * @param width defines the viewport width
      * @param height defines the viewport height
      * @param znear defines the near clip plane
@@ -3367,6 +3447,7 @@ export declare class Matrix {
     static PerspectiveLH(width: number, height: number, znear: number, zfar: number, halfZRange?: boolean, projectionPlaneTilt?: number): Matrix;
     /**
      * Creates a left-handed perspective projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#78
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3379,6 +3460,7 @@ export declare class Matrix {
     static PerspectiveFovLH(fov: number, aspect: number, znear: number, zfar: number, halfZRange?: boolean, projectionPlaneTilt?: number, reverseDepthBufferMode?: boolean): Matrix;
     /**
      * Stores a left-handed perspective projection into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#81
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3393,6 +3475,7 @@ export declare class Matrix {
     static PerspectiveFovLHToRef<T extends Matrix>(fov: number, aspect: number, znear: number, zfar: number, result: T, isVerticalFovFixed?: boolean, halfZRange?: boolean, projectionPlaneTilt?: number, reverseDepthBufferMode?: boolean): T;
     /**
      * Stores a left-handed perspective projection into a given matrix with depth reversed
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#89
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3406,6 +3489,7 @@ export declare class Matrix {
     static PerspectiveFovReverseLHToRef<T extends Matrix>(fov: number, aspect: number, znear: number, zfar: number, result: T, isVerticalFovFixed?: boolean, halfZRange?: boolean, projectionPlaneTilt?: number): T;
     /**
      * Creates a right-handed perspective projection matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#83
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3418,6 +3502,7 @@ export declare class Matrix {
     static PerspectiveFovRH(fov: number, aspect: number, znear: number, zfar: number, halfZRange?: boolean, projectionPlaneTilt?: number, reverseDepthBufferMode?: boolean): Matrix;
     /**
      * Stores a right-handed perspective projection into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#84
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3432,6 +3517,7 @@ export declare class Matrix {
     static PerspectiveFovRHToRef<T extends Matrix>(fov: number, aspect: number, znear: number, zfar: number, result: T, isVerticalFovFixed?: boolean, halfZRange?: boolean, projectionPlaneTilt?: number, reverseDepthBufferMode?: boolean): T;
     /**
      * Stores a right-handed perspective projection into a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#90
      * @param fov defines the horizontal field of view
      * @param aspect defines the aspect ratio
      * @param znear defines the near clip plane
@@ -3445,6 +3531,7 @@ export declare class Matrix {
     static PerspectiveFovReverseRHToRef<T extends Matrix>(fov: number, aspect: number, znear: number, zfar: number, result: T, isVerticalFovFixed?: boolean, halfZRange?: boolean, projectionPlaneTilt?: number): T;
     /**
      * Stores a perspective projection for WebVR info a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#92
      * @param fov defines the field of view
      * @param fov.upDegrees
      * @param fov.downDegrees
@@ -3466,6 +3553,7 @@ export declare class Matrix {
     }, znear: number, zfar: number, result: T, rightHanded?: boolean, halfZRange?: boolean, projectionPlaneTilt?: number): T;
     /**
      * Computes a complete transformation matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#113
      * @param viewport defines the viewport to use
      * @param world defines the world matrix
      * @param view defines the view matrix
@@ -3489,12 +3577,14 @@ export declare class Matrix {
     static GetAsMatrix3x3(matrix: DeepImmutable<Matrix>): Float32Array | Array<number>;
     /**
      * Compute the transpose of a given matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#111
      * @param matrix defines the matrix to transpose
      * @returns the new matrix
      */
     static Transpose<T extends Matrix>(matrix: DeepImmutable<T>): T;
     /**
      * Compute the transpose of a matrix and store it in a target matrix
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#112
      * @param matrix defines the matrix to transpose
      * @param result defines the target matrix
      * @returns result input
@@ -3502,12 +3592,14 @@ export declare class Matrix {
     static TransposeToRef<T extends Matrix>(matrix: DeepImmutable<Matrix>, result: T): T;
     /**
      * Computes a reflection matrix from a plane
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#87
      * @param plane defines the reflection plane
      * @returns a new matrix
      */
     static Reflection(plane: DeepImmutable<IPlaneLike>): Matrix;
     /**
      * Computes a reflection matrix from a plane
+     * Example Playground - https://playground.babylonjs.com/#AV9X17#88
      * @param plane defines the reflection plane
      * @param result defines the target matrix
      * @returns result input