Class Mat4

constructor

• new Mat4(data?: ArrayLike<number>): Mat4

  Parameters

  • Optionaldata: ArrayLike<number>

  Returns Mat4

Readonlydata

clone

• clone(): Mat4

  Returns a deep copy of this matrix.

  Returns Mat4

get

• get(col: number, row: number): number

  Returns the element at the given column and row.

  Parameters

  • col: number
  • row: number

  Returns number

set

• set(col: number, row: number, v: number): void

  Writes a value at the given column and row.

  Parameters

  • col: number
  • row: number
  • v: number

  Returns void

multiply

• multiply(b: Mat4): Mat4

  Returns the matrix product this * b (column-major composition: b applied first).

  Parameters

  • b: Mat4

  Returns Mat4

transformPoint

• transformPoint(v: Vec3): Vec3

  Transforms a 3D point (w = 1), applying the full affine transform and performing perspective divide.

  Parameters

  • v: Vec3

  Returns Vec3

transformDirection

• transformDirection(v: Vec3): Vec3

  Transforms a 3D direction (w = 0), ignoring the translation column.

  Parameters

  • v: Vec3

  Returns Vec3

transformVec4

• transformVec4(v: Vec4): Vec4

  Transforms a homogeneous 4D vector.

  Parameters

  • v: Vec4

  Returns Vec4

transpose

• transpose(): Mat4

  Returns the transpose.

  Returns Mat4

invert

• invert(): Mat4

  Returns the inverse, or the identity matrix if this matrix is singular.

  Returns Mat4

normalMatrix

• normalMatrix(): Mat4

  Returns the inverse-transpose of the upper-left 3x3, embedded in a 4x4 matrix.

  Use this to transform normals when the model matrix contains non-uniform scale.

  Returns Mat4

setIdentity

• setIdentity(): this

  Sets this matrix to the 4x4 identity.

  Returns this

setTranslation

• setTranslation(x: number, y: number, z: number): this

  Sets this matrix to a translation by (x, y, z).

  Parameters

  • x: number
  • y: number
  • z: number

  Returns this

setScale

• setScale(x: number, y: number, z: number): this

  Sets this matrix to a non-uniform scale with the given per-axis factors.

  Parameters

  • x: number
  • y: number
  • z: number

  Returns this

setRotationX

• setRotationX(rad: number): this

  Sets this matrix to a rotation of rad radians around the X axis.

  Parameters

  • rad: number

  Returns this

setRotationY

• setRotationY(rad: number): this

  Sets this matrix to a rotation of rad radians around the Y axis.

  Parameters

  • rad: number

  Returns this

setRotationZ

• setRotationZ(rad: number): this

  Sets this matrix to a rotation of rad radians around the Z axis.

  Parameters

  • rad: number

  Returns this

setQuaternion

• setQuaternion(qx: number, qy: number, qz: number, qw: number): this

  Sets this matrix to the rotation defined by quaternion components (qx, qy, qz, qw).

  Parameters

  • qx: number
  • qy: number
  • qz: number
  • qw: number

  Returns this

setPerspective

• setPerspective(fovY: number, aspect: number, near: number, far: number): this

  Sets this matrix to a right-handed perspective projection with the WebGPU clip-space depth range [0, 1].

  Parameters

  • fovY: number
  • aspect: number
  • near: number
  • far: number

  Returns this

setOrthographic

• setOrthographic(
      left: number,
      right: number,
      bottom: number,
      top: number,
      near: number,
      far: number,
  ): this

  Sets this matrix to an orthographic projection with the WebGPU clip-space depth range [0, 1].

  Parameters

  • left: number
  • right: number
  • bottom: number
  • top: number
  • near: number
  • far: number

  Returns this

setLookAt

• setLookAt(eye: Vec3, target: Vec3, up: Vec3): this

  Sets this matrix to a right-handed view matrix placing the camera at eye looking at target, with up defining the camera's roll. View space uses -Z as forward.

  Parameters

  • eye: Vec3
  • target: Vec3
  • up: Vec3

  Returns this

copyFrom

• copyFrom(src: Mat4): this

  In-place copy: this ← src. Returns this.

  Parameters

  • src: Mat4

  Returns this

setMultiply

• setMultiply(a: Mat4, b: Mat4): this

  In-place matrix product: this ← a * b. Alias-safe — this may equal a, b, or both. Computes into a class-private scratch buffer before writing back so the source data isn't trampled mid-multiply. Use in hot loops to avoid the per-call Float32Array allocation that multiply() does.

  Parameters

  • a: Mat4
  • b: Mat4

  Returns this

setNormalMatrix

• setNormalMatrix(src: Mat4): this

  In-place: this ← inverse-transpose of the upper-left 3x3 of src, with the 4th row/column zeroed and [15] = 1 (the same shape as normalMatrix()). Alias-safe — src may equal this because we read every src entry into a local before writing the output. Use in hot loops.

  Parameters

  • src: Mat4

  Returns this

setTrs

• setTrs(t: Vec3, qx: number, qy: number, qz: number, qw: number, s: Vec3): this

  Sets this matrix to Translate * Rotate * Scale.

  Parameters

  • t: Vec3
  • qx: number
  • qy: number
  • qz: number
  • qw: number
  • s: Vec3

  Returns this

Staticidentity

• identity(): Mat4

  Returns the 4x4 identity matrix.

  Returns Mat4

Statictranslation

• translation(x: number, y: number, z: number): Mat4

  Returns a translation matrix by (x, y, z).

  Parameters

  • x: number
  • y: number
  • z: number

  Returns Mat4

Staticscale

• scale(x: number, y: number, z: number): Mat4

  Returns a non-uniform scale matrix with the given per-axis factors.

  Parameters

  • x: number
  • y: number
  • z: number

  Returns Mat4

StaticrotationX

• rotationX(rad: number): Mat4

  Returns a rotation matrix of rad radians around the X axis.

  Parameters

  • rad: number

  Returns Mat4

StaticrotationY

• rotationY(rad: number): Mat4

  Returns a rotation matrix of rad radians around the Y axis.

  Parameters

  • rad: number

  Returns Mat4

StaticrotationZ

• rotationZ(rad: number): Mat4

  Returns a rotation matrix of rad radians around the Z axis.

  Parameters

  • rad: number

  Returns Mat4

StaticfromQuaternion

• fromQuaternion(qx: number, qy: number, qz: number, qw: number): Mat4

  Builds a rotation matrix from quaternion components (qx, qy, qz, qw).

  Parameters

  • qx: number
  • qy: number
  • qz: number
  • qw: number

  Returns Mat4

Staticperspective

• perspective(fovY: number, aspect: number, near: number, far: number): Mat4

  Builds a right-handed perspective projection with the WebGPU clip-space depth range [0, 1].

  Parameters

  • fovY: number

    vertical field of view in radians

  • aspect: number

    viewport width / height

  • near: number

    near plane distance (positive)

  • far: number

    far plane distance (positive)

  Returns Mat4

StaticperspectiveReversed

• perspectiveReversed(
      fovY: number,
      aspect: number,
      near: number,
      far: number,
  ): Mat4

  Reversed-Z perspective (WebGPU clip-space depth [0,1], but mapping the NEAR plane to 1 and the FAR plane to 0). Paired with a float depth buffer and a greater/greater-equal depth test, this spreads depth precision near- uniformly across the frustum, so a very large far/near ratio no longer z-fights. Drop-in for perspective; its inverse is still a valid invViewProj, so shaders that reconstruct world position from the depth buffer work unchanged — only explicit far-plane tests (far is now 0) and hardcoded depth-linearization formulas need flipping.

  Parameters

  • fovY: number
  • aspect: number
  • near: number
  • far: number

  Returns Mat4

Staticorthographic

• orthographic(
      left: number,
      right: number,
      bottom: number,
      top: number,
      near: number,
      far: number,
  ): Mat4

  Builds an orthographic projection with the WebGPU clip-space depth range [0, 1].

  Parameters

  • left: number
  • right: number
  • bottom: number
  • top: number
  • near: number
  • far: number

  Returns Mat4

StaticlookAt

• lookAt(eye: Vec3, target: Vec3, up: Vec3): Mat4

  Builds a right-handed view matrix that places the camera at eye looking at target, with up defining the camera's roll. View space uses -Z as forward.

  Parameters

  • eye: Vec3
  • target: Vec3
  • up: Vec3

  Returns Mat4

Statictrs

• trs(t: Vec3, qx: number, qy: number, qz: number, qw: number, s: Vec3): Mat4

  Builds a Translate * Rotate * Scale matrix.

  Parameters

  • t: Vec3

    translation

  • qx: number

    quaternion x component

  • qy: number

    quaternion y component

  • qz: number

    quaternion z component

  • qw: number

    quaternion w (scalar) component

  • s: Vec3

    per-axis scale factors

  Returns Mat4