Class IdentityMatrix44

Represents a 4x4 identity matrix that provides optimized operations for identity transformations. This class implements the identity matrix pattern where all diagonal elements are 1 and all other elements are 0. It extends AbstractMatrix and implements both IMatrix and IMatrix44 interfaces.

The identity matrix is immutable and provides efficient implementations since the result of many operations can be computed without actual matrix multiplication.

Example

const identity = new IdentityMatrix44();
const vector = new Vector4(1, 2, 3, 1);
const result = identity.multiplyVector(vector); // Returns the same vector

Hierarchy (view full)

AbstractMatrix
- IdentityMatrix44

Implements

Index

Constructors

constructor

new IdentityMatrix44(): IdentityMatrix44
Creates a new IdentityMatrix44 instance. The internal array reference points to the static identity matrix values.

Returns IdentityMatrix44
Overrides AbstractMatrix.constructor
- Defined in foundation/math/IdentityMatrix44.ts:37

Properties

_v

_v: Float32Array = ...

Internal Float32Array storage for matrix elements

`Static` `Readonly`__v

__v: Float32Array = ...

Static array representing the identity matrix values in column-major order. This is shared across all instances for memory efficiency.

Accessors

className

get className(): string
Gets the class name for debugging and reflection purposes.

Returns string
The string 'IdentityMatrix44'
Implementation of IMatrix44.className
Overrides AbstractMatrix.className
- Defined in foundation/math/IdentityMatrix44.ts:437

isIdentityMatrixClass

get isIdentityMatrixClass(): boolean
Indicates whether this matrix is an identity matrix class.

Returns boolean
Always true for IdentityMatrix44
Implementation of IMatrix44.isIdentityMatrixClass
Overrides AbstractMatrix.isIdentityMatrixClass
- Defined in foundation/math/IdentityMatrix44.ts:453

m00

get m00(): number
Gets the matrix element at row 0, column 0.

Returns number
Always 1 for identity matrix
Implementation of IMatrix44.m00
- Defined in foundation/math/IdentityMatrix44.ts:285

m01

get m01(): number
Gets the matrix element at row 0, column 1.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m01
- Defined in foundation/math/IdentityMatrix44.ts:317

m02

get m02(): number
Gets the matrix element at row 0, column 2.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m02
- Defined in foundation/math/IdentityMatrix44.ts:349

m03

get m03(): number
Gets the matrix element at row 0, column 3.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m03
- Defined in foundation/math/IdentityMatrix44.ts:381

m10

get m10(): number
Gets the matrix element at row 1, column 0.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m10
- Defined in foundation/math/IdentityMatrix44.ts:293

m11

get m11(): number
Gets the matrix element at row 1, column 1.

Returns number
Always 1 for identity matrix
Implementation of IMatrix44.m11
- Defined in foundation/math/IdentityMatrix44.ts:325

m12

get m12(): number
Gets the matrix element at row 1, column 2.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m12
- Defined in foundation/math/IdentityMatrix44.ts:357

m13

get m13(): number
Gets the matrix element at row 1, column 3.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m13
- Defined in foundation/math/IdentityMatrix44.ts:389

m20

get m20(): number
Gets the matrix element at row 2, column 0.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m20
- Defined in foundation/math/IdentityMatrix44.ts:301

m21

get m21(): number
Gets the matrix element at row 2, column 1.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m21
- Defined in foundation/math/IdentityMatrix44.ts:333

m22

get m22(): number
Gets the matrix element at row 2, column 2.

Returns number
Always 1 for identity matrix
Implementation of IMatrix44.m22
- Defined in foundation/math/IdentityMatrix44.ts:365

m23

get m23(): number
Gets the matrix element at row 2, column 3.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m23
- Defined in foundation/math/IdentityMatrix44.ts:397

m30

get m30(): number
Gets the matrix element at row 3, column 0.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m30
- Defined in foundation/math/IdentityMatrix44.ts:309

m31

get m31(): number
Gets the matrix element at row 3, column 1.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m31
- Defined in foundation/math/IdentityMatrix44.ts:341

m32

get m32(): number
Gets the matrix element at row 3, column 2.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.m32
- Defined in foundation/math/IdentityMatrix44.ts:373

m33

get m33(): number
Gets the matrix element at row 3, column 3.

Returns number
Always 1 for identity matrix
Implementation of IMatrix44.m33
- Defined in foundation/math/IdentityMatrix44.ts:405

translateX

get translateX(): number
Gets the X translation component from the matrix.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.translateX
- Defined in foundation/math/IdentityMatrix44.ts:413

translateY

get translateY(): number
Gets the Y translation component from the matrix.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.translateY
- Defined in foundation/math/IdentityMatrix44.ts:421

translateZ

get translateZ(): number
Gets the Z translation component from the matrix.

Returns number
Always 0 for identity matrix
Implementation of IMatrix44.translateZ
- Defined in foundation/math/IdentityMatrix44.ts:429

`Static`compositionType

get compositionType(): CompositionTypeClass<"MAT4">
Gets the composition type for this matrix class.

Returns CompositionTypeClass<"MAT4">
CompositionType.Mat4 indicating this is a 4x4 matrix
- Defined in foundation/math/IdentityMatrix44.ts:445

Methods

at

at(row_i, column_i): number
Gets the matrix element at the specified row and column indices. For identity matrix, returns 1 for diagonal elements and 0 for off-diagonal elements.
Parameters
- row_i: number
  The row index (0-based)
- column_i: number
  The column index (0-based)
Returns number
1 if row equals column (diagonal), 0 otherwise
Implementation of IMatrix44.at
Overrides AbstractMatrix.at
- Defined in foundation/math/IdentityMatrix44.ts:159

clone

clone(): IMatrix44
Creates a copy of this identity matrix. Returns a new IdentityMatrix44 instance.

Returns IMatrix44
A new IdentityMatrix44 instance
Implementation of IMatrix44.clone
- Defined in foundation/math/IdentityMatrix44.ts:257

determinant

determinant(): number
Calculates the determinant of this identity matrix. The determinant of an identity matrix is always 1.

Returns number
Always returns 1
Implementation of IMatrix44.determinant
Overrides AbstractMatrix.determinant
- Defined in foundation/math/IdentityMatrix44.ts:180

flattenAsArray

flattenAsArray(): number[]
Returns the matrix elements as a flat array in column-major order.

Returns number[]
An array of 16 numbers representing the identity matrix
Implementation of IMatrix44.flattenAsArray
Overrides AbstractMatrix.flattenAsArray
- Defined in foundation/math/IdentityMatrix44.ts:71

getRotate

getRotate(): IMatrix44
Extracts the rotation part of this transformation matrix. For identity matrix, the rotation is also an identity matrix.

Returns IMatrix44
A new IdentityMatrix44 representing no rotation
Implementation of IMatrix44.getRotate
- Defined in foundation/math/IdentityMatrix44.ts:267

getScale

getScale(): IVector3
Extracts the scale components from this transformation matrix. For identity matrix, the scale is (1, 1, 1).

Returns IVector3
A Vector3 with all components set to 1
Implementation of IMatrix44.getScale
- Defined in foundation/math/IdentityMatrix44.ts:230

getScaleTo

getScaleTo(outVec): IMutableVector
Extracts the scale components and stores them in an output vector. For identity matrix, sets all scale components to 1.
Parameters
- outVec: IMutableVector
  The mutable vector to store the scale values
Returns IMutableVector
The output vector with scale components set to 1
- Defined in foundation/math/IdentityMatrix44.ts:241

getTranslate

getTranslate(): IVector3
Extracts the translation components from this transformation matrix. For identity matrix, the translation is (0, 0, 0).

Returns IVector3
A Vector3 with all components set to 0
Implementation of IMatrix44.getTranslate
- Defined in foundation/math/IdentityMatrix44.ts:277

isDummy

isDummy(): boolean
Indicates whether this matrix is a dummy/placeholder matrix. Identity matrix is not considered a dummy matrix.

Returns boolean
Always false for identity matrix
Implementation of IMatrix44.isDummy
Overrides AbstractMatrix.isDummy
- Defined in foundation/math/IdentityMatrix44.ts:81

isEqual

isEqual(mat, delta?): boolean
Checks if the given matrix is approximately equal to this identity matrix within a tolerance. Compares each element of the input matrix against the corresponding identity matrix element.
Parameters
- mat: IMatrix44
  The matrix to compare against this identity matrix
- delta: number = Number.EPSILON
  The tolerance for floating-point comparison (default: Number.EPSILON)
Returns boolean
True if the matrix is approximately an identity matrix, false otherwise
- Defined in foundation/math/IdentityMatrix44.ts:93

isStrictEqual

isStrictEqual(mat): boolean
Performs a strict equality check against another matrix. Uses exact floating-point comparison without tolerance.
Parameters
- mat: IMatrix
  The matrix to compare for strict equality
Returns boolean
True if the matrix is exactly an identity matrix, false otherwise
- Defined in foundation/math/IdentityMatrix44.ts:125

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
Implementation of IMatrix44.isTheSourceSame
Inherited from AbstractMatrix.isTheSourceSame
- Defined in foundation/math/AbstractMatrix.ts:131

multiplyVector

multiplyVector(vec): IVector4
Multiplies this identity matrix with a 4D vector. Since this is an identity matrix, the result is the input vector unchanged.
Parameters
- vec: IVector4
  The 4D vector to multiply
Returns IVector4
The same vector (identity transformation)
Implementation of IMatrix44.multiplyVector
- Defined in foundation/math/IdentityMatrix44.ts:191

multiplyVector3

multiplyVector3(vec): IVector3
Multiplies this identity matrix with a 3D vector. Since this is an identity matrix, the result is the input vector unchanged.
Parameters
- vec: IVector3
  The 3D vector to multiply
Returns IVector3
The same vector (identity transformation)
Implementation of IMatrix44.multiplyVector3
- Defined in foundation/math/IdentityMatrix44.ts:202

multiplyVectorTo

multiplyVectorTo(vec, outVec): IMutableVector
Multiplies this identity matrix with a vector and stores the result in an output vector. Since this is an identity matrix, copies the input vector to the output vector.
Parameters
- vec: IVector
  The input vector to multiply
- outVec: IMutableVector
  The mutable vector to store the result
Returns IMutableVector
The output vector containing the copied values
- Defined in foundation/math/IdentityMatrix44.ts:214

toString

toString(): string
Returns a string representation of the identity matrix in a readable format. Each row is separated by newlines for visual clarity.

Returns string
A formatted string showing the 4x4 identity matrix
Implementation of IMatrix44.toString
Overrides AbstractMatrix.toString
- Defined in foundation/math/IdentityMatrix44.ts:48

toStringApproximately

toStringApproximately(): string
Returns an approximate string representation of the matrix. For identity matrix, this is identical to toString() since all values are exact.

Returns string
A formatted string showing the 4x4 identity matrix
Implementation of IMatrix44.toStringApproximately
Overrides AbstractMatrix.toStringApproximately
- Defined in foundation/math/IdentityMatrix44.ts:62

v

v(i): number
Gets the matrix element at the specified linear index in column-major order. For identity matrix, returns 1 for diagonal positions and 0 elsewhere.
Parameters
- i: number
  The linear index (0-15) in column-major order
Returns number
1 for diagonal elements (indices 0, 5, 10, 15), 0 otherwise
Implementation of IMatrix44.v
Overrides AbstractMatrix.v
- Defined in foundation/math/IdentityMatrix44.ts:170

Class IdentityMatrix44

Example

Hierarchy (view full)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns IdentityMatrix44

Properties

_v

Static Readonly__v

Accessors

className

Returns string

isIdentityMatrixClass

Returns boolean

m00

Returns number

m01

Returns number

m02

Returns number

m03

Returns number

m10

Returns number

m11

Returns number

m12

Returns number

m13

Returns number

m20

Returns number

m21

Returns number

m22

Returns number

m23

Returns number

m30

Returns number

m31

Returns number

m32

Returns number

m33

Returns number

translateX

Returns number

translateY

Returns number

translateZ

Returns number

StaticcompositionType

Returns CompositionTypeClass<"MAT4">

Methods

at

Parameters

Returns number

clone

Returns IMatrix44

determinant

Returns number

flattenAsArray

Returns number[]

getRotate

Returns IMatrix44

getScale

Returns IVector3

getScaleTo

Parameters

Returns IMutableVector

getTranslate

Returns IVector3

isDummy

`Static` `Readonly`__v

`Static`compositionType