Class Matrix33

Immutable 3x3 matrix class for 3D transformations. Matrix values are stored in column-major order for WebGL compatibility. Provides various matrix operations including rotation, scaling, and multiplication.

Example

// Create identity matrix
const identity = Matrix33.identity();

// Create rotation matrix
const rotation = Matrix33.rotateZ(Math.PI / 4);

// Create scale matrix
const scale = Matrix33.scale(Vector3.fromCopyArray([2, 2, 2]));

// Matrix multiplication
const result = Matrix33.multiply(rotation, scale);

Hierarchy (view full)

Implements

Constructors

constructor

Properties

_v

Accessors

className glslStrAsFloat glslStrAsInt isIdentityMatrixClass m00 m01 m02 m10 m11 m12 m20 m21 m22 wgslStrAsFloat wgslStrAsInt compositionType

Methods

at clone determinant flattenAsArray getScale getScaleTo isDummy isEqual isStrictEqual isTheSourceSame multiplyVector multiplyVectorTo toString toStringApproximately v dummy fromCopy9ColumnMajor fromCopy9RowMajor fromCopyArray9ColumnMajor fromCopyArray9RowMajor fromCopyArrayColumnMajor fromCopyArrayRowMajor fromCopyFloat32ArrayColumnMajor fromCopyFloat32ArrayRowMajor fromCopyMatrix33 fromCopyMatrix44 fromCopyQuaternion fromFloat32ArrayColumnMajor identity invert invertTo multiply multiplyTo rotate rotateX rotateXYZ rotateY rotateZ scale transpose zero

Constructors

constructor

Properties

_v

_v: Float32Array = ...

Internal Float32Array storage for matrix elements

Accessors

className

glslStrAsFloat

  • get glslStrAsFloat(): string

  • Gets the matrix as a GLSL mat3 string with float precision.

    Returns string

    GLSL mat3 constructor string

glslStrAsInt

  • get glslStrAsInt(): string

  • Gets the matrix as a GLSL mat3 string with integer values.

    Returns string

    GLSL mat3 constructor string with floored values

isIdentityMatrixClass

  • get isIdentityMatrixClass(): boolean

  • Indicates whether this matrix is an identity matrix class.

    This property should be overridden in derived classes that represent identity matrices to return true.

    Returns boolean

    False for the base AbstractMatrix class

m00

m01

m02

m10

m11

m12

m20

m21

m22

wgslStrAsFloat

  • get wgslStrAsFloat(): string

  • Gets the matrix as a WGSL mat3x3f string with float precision.

    Returns string

    WGSL mat3x3f constructor string

wgslStrAsInt

  • get wgslStrAsInt(): string

  • Gets the matrix as a WGSL mat3x3i string with integer values.

    Returns string

    WGSL mat3x3i constructor string with floored values

StaticcompositionType

  • get compositionType(): CompositionTypeClass<"MAT3">

  • Gets the composition type for this matrix.

    Returns CompositionTypeClass<"MAT3">

    CompositionType.Mat3

Methods

at

  • at(row_i, column_i): number

  • Gets the matrix element at the specified row and column.

    Parameters

    • row_i: number

      The row index (0-2)

    • column_i: number

      The column index (0-2)

    Returns number

    The matrix element at the specified position

clone

determinant

flattenAsArray

getScale

getScaleTo

isDummy

isEqual

  • isEqual(mat, delta?): boolean

  • Checks if this matrix is approximately equal to another matrix.

    Parameters

    • mat: IMatrix33

      The matrix to compare with

    • delta: number = Number.EPSILON

      The tolerance for comparison (default: Number.EPSILON)

    Returns boolean

    True if matrices are approximately equal, false otherwise

isStrictEqual

isTheSourceSame

  • isTheSourceSame(arrayBuffer): boolean

  • Checks if the matrix's internal storage shares the same ArrayBuffer as the provided one.

    This method is useful for determining if two matrices share the same underlying memory, which can be important for performance optimizations and avoiding unnecessary data copying.

    Parameters

    • arrayBuffer: ArrayBuffer

      The ArrayBuffer to compare against

    Returns boolean

    True if the internal storage uses the same ArrayBuffer, false otherwise

multiplyVector

  • multiplyVector(vec): any

  • Multiplies this matrix with a vector.

    Parameters

    Returns any

    A new vector representing the result of matrix * vector

multiplyVectorTo

toString

toStringApproximately

v

Staticdummy

StaticfromCopy9ColumnMajor

  • fromCopy9ColumnMajor(m00, m10, m20, m01, m11, m21, m02, m12, m22): Matrix33

  • Creates a Matrix33 from 9 values in column-major order.

    Parameters

    • m00: number

      Element at row 0, column 0

    • m10: number

      Element at row 1, column 0

    • m20: number

      Element at row 2, column 0

    • m01: number

      Element at row 0, column 1

    • m11: number

      Element at row 1, column 1

    • m21: number

      Element at row 2, column 1

    • m02: number

      Element at row 0, column 2

    • m12: number

      Element at row 1, column 2

    • m22: number

      Element at row 2, column 2

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopy9RowMajor

  • fromCopy9RowMajor(m00, m01, m02, m10, m11, m12, m20, m21, m22): Matrix33

  • Creates a Matrix33 from 9 values in row-major order. Values are stored internally in column-major order for WebGL compatibility.

    Parameters

    • m00: number

      Element at row 0, column 0

    • m01: number

      Element at row 0, column 1

    • m02: number

      Element at row 0, column 2

    • m10: number

      Element at row 1, column 0

    • m11: number

      Element at row 1, column 1

    • m12: number

      Element at row 1, column 2

    • m20: number

      Element at row 2, column 0

    • m21: number

      Element at row 2, column 1

    • m22: number

      Element at row 2, column 2

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopyArray9ColumnMajor

StaticfromCopyArray9RowMajor

StaticfromCopyArrayColumnMajor

  • fromCopyArrayColumnMajor(array): Matrix33

  • Creates a Matrix33 from a regular array in column-major order.

    Parameters

    • array: number[]

      The array containing at least 9 numbers

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopyArrayRowMajor

  • fromCopyArrayRowMajor(array): Matrix33

  • Creates a Matrix33 from a regular array in row-major order.

    Parameters

    • array: number[]

      The array containing at least 9 numbers in row-major order

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopyFloat32ArrayColumnMajor

  • fromCopyFloat32ArrayColumnMajor(float32Array): Matrix33

  • Creates a Matrix33 by copying from a Float32Array in column-major order.

    Parameters

    • float32Array: Float32Array

      The Float32Array to copy from

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopyFloat32ArrayRowMajor

  • fromCopyFloat32ArrayRowMajor(array): Matrix33

  • Creates a Matrix33 by copying from a Float32Array in row-major order.

    Parameters

    • array: Float32Array

      The Float32Array in row-major order

    Returns Matrix33

    A new Matrix33 instance

StaticfromCopyMatrix33

StaticfromCopyMatrix44

StaticfromCopyQuaternion

StaticfromFloat32ArrayColumnMajor

  • fromFloat32ArrayColumnMajor(float32Array): Matrix33

  • Creates a Matrix33 using the provided Float32Array directly (no copy).

    Parameters

    • float32Array: Float32Array

      The Float32Array in column-major order

    Returns Matrix33

    A new Matrix33 instance

Staticidentity

Staticinvert

StaticinvertTo

  • invertTo(mat, outMat): MutableMatrix33

  • Calculates the inverse of the given matrix and stores the result in the output matrix.

    Parameters

    Returns MutableMatrix33

    The output matrix containing the inverted matrix

    Throws

    Will log an error if the matrix is not invertible (determinant is 0)

Staticmultiply

StaticmultiplyTo

Staticrotate

StaticrotateX

StaticrotateXYZ

  • rotateXYZ(x, y, z): Matrix33

  • Creates a rotation matrix from Euler angles in XYZ order.

    Parameters

    • x: number

      Rotation around X-axis in radians

    • y: number

      Rotation around Y-axis in radians

    • z: number

      Rotation around Z-axis in radians

    Returns Matrix33

    A new rotation matrix representing the combined rotations

StaticrotateY

StaticrotateZ

Staticscale

Statictranspose

Staticzero

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods