Class Matrix22

Creates a new Matrix22 instance.

Gets the class name for this matrix type.

Gets the matrix element at row 0, column 0.

Gets the matrix element at row 0, column 1.

Gets the matrix element at row 1, column 0.

Gets the matrix element at row 1, column 1.

Gets the composition type for this matrix.

Gets the matrix element at the specified row and column.

Example

const mat = Matrix22.identity();
const m01 = mat.at(0, 1); // Returns 0
Copy

Creates a deep copy of this matrix.

Calculates the determinant of this 2x2 matrix.

For a 2x2 matrix | a b |, the determinant is ad - bc. | c d |

Example

const mat = Matrix22.fromCopy4RowMajor(2, 3, 1, 4);
const det = mat.determinant(); // Returns 2*4 - 3*1 = 5
Copy

Returns the matrix elements as a flat array in column-major order.

Extracts the scale factors from this transformation matrix. Calculates the length of each column vector to determine the scale.

Example

const scaleAndRotation = Matrix22.multiply(
  Matrix22.scale(Vector2.fromCopyArray2([2, 3])),
  Matrix22.rotate(Math.PI / 4)
);
const scale = scaleAndRotation.getScale(); // Returns approximately [2, 3]
Copy

Extracts the scale factors from this transformation matrix and stores them in the output vector. This method avoids creating a new vector instance for better performance.

Checks if this is a dummy matrix (empty data).

Checks if this matrix is approximately equal to another matrix within a tolerance.

Checks if this matrix is exactly equal to another matrix. Uses strict equality comparison for all elements.

Multiplies this matrix by a 2D vector and returns the result.

Example

const rotation = Matrix22.rotate(Math.PI / 2);
const vec = Vector2.fromCopyArray2([1, 0]);
const result = rotation.multiplyVector(vec); // Rotates (1,0) to (0,1)
Copy

Multiplies this matrix by a 2D vector and stores the result in the output vector. This method avoids creating a new vector instance for better performance.

Returns a string representation of the matrix in a readable format.

Example

const mat = Matrix22.identity();
console.log(mat.toString());
// Output:
// 1 0
// 0 1
Copy

Returns an approximate string representation of the matrix with rounded values. Uses financial rounding for cleaner display of floating-point numbers.

Creates a dummy matrix with empty data. Used as a placeholder when no valid matrix data is available.

Creates a new Matrix22 from individual components in column-major order.

Column-major means you specify values column by column: First column: m00, m10 Second column: m01, m11

Note: WebGL matrices are stored in column-major order internally.

Creates a new Matrix22 from individual components in row-major order.

Row-major means you specify values as they appear visually:

| m00 m01 |
| m10 m11 |
Copy

Note: Internally, WebGL matrices are stored in column-major order.

Example

const mat = Matrix22.fromCopy4RowMajor(1, 2, 3, 4);
// Creates:
// | 1 2 |
// | 3 4 |
Copy

Creates a new Matrix22 from a 4-element array in column-major order.

Creates a new Matrix22 from a 4-element array in row-major order.

Creates a new Matrix22 from a variable-length array in column-major order. Only the first 4 elements are used.

Creates a new Matrix22 from a variable-length array in row-major order. Only the first 4 elements are used.

Creates a new Matrix22 by copying values from a Float32Array in column-major order.

Creates a new Matrix22 by copying values from a Float32Array in row-major order.

Creates a new Matrix22 by copying values from another IMatrix22.

Creates a new Matrix22 that directly uses the provided Float32Array. The array is used as-is without copying, so modifications to the array will affect the matrix.

Creates a 2x2 identity matrix.

Example

const identity = Matrix22.identity();
// Returns:
// | 1 0 |
// | 0 1 |
Copy

Creates the inverse of the given matrix.

For a 2x2 matrix, the inverse is calculated using the formula: A^(-1) = (1/det(A)) * | d -b | |-c a | where A = | a b | and det(A) = ad - bc | c d |

Throws

Error if the matrix is singular (determinant is 0)

Example

const mat = Matrix22.fromCopy4RowMajor(2, 0, 0, 2);
const inverse = Matrix22.invert(mat);
// Returns:
// | 0.5   0 |
// |   0 0.5 |
Copy

Calculates the inverse of the given matrix and stores the result in the output matrix. This method avoids creating a new matrix instance for better performance.

Throws

Error if the matrix is singular (determinant is 0)

Multiplies two 2x2 matrices and returns the result. Matrix multiplication is not commutative: A * B ≠ B * A in general.

Example

const a = Matrix22.scale(Vector2.fromCopyArray2([2, 2]));
const b = Matrix22.rotate(Math.PI / 4);
const result = Matrix22.multiply(a, b); // Scale then rotate
Copy

Multiplies two matrices and stores the result in the output matrix. This method avoids creating a new matrix instance for better performance.

Note: The parameter types suggest Matrix33, but this appears to be a bug as this should operate on Matrix22 instances.

Creates a 2D rotation matrix for the given angle.

The rotation matrix is: | cos(θ) -sin(θ) | | sin(θ) cos(θ) |

Example

// 90-degree counter-clockwise rotation
const rotation = Matrix22.rotate(Math.PI / 2);
Copy

Creates a 2D scaling matrix from a 2D vector.

The scaling matrix is: | sx 0 | | 0 sy |

Example

const scale = Matrix22.scale(Vector2.fromCopyArray2([2, 3]));
// Creates a matrix that scales x by 2 and y by 3
Copy

Creates the transpose of the given matrix. The transpose swaps rows and columns: (i,j) becomes (j,i).

Example

const mat = Matrix22.fromCopy4RowMajor(1, 2, 3, 4);
const transposed = Matrix22.transpose(mat);
// Original:    Transposed:
// | 1 2 |  ->  | 1 3 |
// | 3 4 |      | 2 4 |
Copy

Creates a 2x2 zero matrix.

Example

const zero = Matrix22.zero();
// Returns:
// | 0 0 |
// | 0 0 |
Copy