Matrix4

A 4x4 column-major matrix stored as a Float32Array of 16 values. Used for 3D transformations including projection, view, and model matrices. This is the primary matrix class for WebGL rendering operations in Phaser, supporting perspective/orthographic projection, look-at camera setup, and affine transforms (translate, rotate, scale).

Adapted from gl-matrix by toji and vecmath by mattdesl

Constructor

new Matrix4([m])

Parameters

name	type	optional	description
m	Phaser.Math.Matrix4	Yes	Optional Matrix4 to copy values from.

---

Scope: static

Source: src/math/Matrix4.js#L15
Since: 3.0.0

Public Members

val

val: Float32Array

Description:

The matrix values.

Source: src/math/Matrix4.js#L39
Since: 3.0.0

---

Public Methods

adjoint

<instance> adjoint()

Description:

Calculate the adjoint, or adjugate, of this Matrix.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L422
Since: 3.0.0

---

clone

<instance> clone()

Description:

Make a clone of this Matrix4.

Returns: Phaser.Math.Matrix4 - A clone of this Matrix4.

Source: src/math/Matrix4.js#L60
Since: 3.0.0

---

copy

<instance> copy(src)

Description:

Copy the values of a given Matrix into this Matrix.

Parameters:

name	type	optional	description
src	Phaser.Math.Matrix4	No	The Matrix to copy the values from.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L137
Since: 3.0.0

---

determinant

<instance> determinant()

Description:

Calculate the determinant of this Matrix.

Returns: number - The determinant of this Matrix.

Source: src/math/Matrix4.js#L474
Since: 3.0.0

---

fromArray

<instance> fromArray(a)

Description:

Set the values of this Matrix from the given array.

Parameters:

name	type	optional	description
a	Array.<number>	No	The array to copy the values from. Must have at least 16 elements.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L154
Since: 3.0.0

---

fromQuat

<instance> fromQuat(q)

Description:

Set the values of this Matrix from the given Quaternion.

Parameters:

name	type	optional	description
q	Phaser.Math.Quaternion	No	The Quaternion to set the values of this Matrix from.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1109
Since: 3.0.0

---

fromRotationTranslation

<instance> fromRotationTranslation(q, v)

Description:

Set the values of this Matrix from the given rotation Quaternion and translation Vector.

Parameters:

name	type	optional	description
q	Phaser.Math.Quaternion	No	The Quaternion to set rotation from.
v	Phaser.Math.Vector3	No	The Vector to set translation from.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1051
Since: 3.0.0

---

fromRotationXYTranslation

<instance> fromRotationXYTranslation(rotation, position, translateFirst)

Description:

Takes the rotation and position vectors and builds this Matrix4 from them.

Parameters:

name	type	optional	description
rotation	Phaser.Math.Vector3	No	The rotation vector.
position	Phaser.Math.Vector3	No	The position vector.
translateFirst	boolean	No	Should the operation translate then rotate (true), or rotate then translate? (false)

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1677
Since: 3.50.0

---

frustum

<instance> frustum(left, right, bottom, top, near, far)

Description:

Generate a frustum matrix with the given bounds.

Parameters:

name	type	optional	description
left	number	No	The left bound of the frustum.
right	number	No	The right bound of the frustum.
bottom	number	No	The bottom bound of the frustum.
top	number	No	The top bound of the frustum.
near	number	No	The near bound of the frustum.
far	number	No	The far bound of the frustum.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1165
Since: 3.0.0

---

getInverse

<instance> getInverse(m)

Description:

Copies the given Matrix4 into this Matrix and then inverses it.

Parameters:

name	type	optional	description
m	Phaser.Math.Matrix4	No	The Matrix4 to invert into this Matrix4.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L328
Since: 3.50.0

---

getMaxScaleOnAxis

<instance> getMaxScaleOnAxis()

Description:

Returns the maximum axis scale from this Matrix4.

Returns: number - The maximum axis scale.

Source: src/math/Matrix4.js#L1748
Since: 3.50.0

---

identity

<instance> identity()

Description:

Reset this Matrix to an identity (default) matrix.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L280
Since: 3.0.0

---

invert

<instance> invert()

Description:

Invert this Matrix.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L345
Since: 3.0.0

---

lookAt

<instance> lookAt(eye, center, up)

Description:

Generate a look-at matrix with the given eye position, focal point, and up axis.

Parameters:

name	type	optional	description
eye	Phaser.Math.Vector3	No	Position of the viewer
center	Phaser.Math.Vector3	No	Point the viewer is looking at
up	Phaser.Math.Vector3	No	A Vector3 pointing up, used to orient the camera roll.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1400
Since: 3.0.0

---

lookAtRH

<instance> lookAtRH(eye, target, up)

Description:

Generate a right-handed look-at matrix with the given eye position, target and up axis.

Parameters:

name	type	optional	description
eye	Phaser.Math.Vector3	No	Position of the viewer.
target	Phaser.Math.Vector3	No	Point the viewer is looking at.
up	Phaser.Math.Vector3	No	A Vector3 pointing up, used to orient the camera roll.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1340
Since: 3.50.0

---

makeRotationAxis

<instance> makeRotationAxis(axis, angle)

Description:

Derive a rotation matrix around the given axis.

Parameters:

name	type	optional	description
axis	Phaser.Math.Vector3 | Phaser.Math.Vector4	No	The rotation axis.
angle	number	No	The rotation angle in radians.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L818
Since: 3.0.0

---

multiply

<instance> multiply(src)

Description:

Multiply this Matrix by the given Matrix.

Parameters:

name	type	optional	description
src	Phaser.Math.Matrix4	No	The Matrix to multiply this Matrix by.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L523
Since: 3.0.0

---

multiplyLocal

<instance> multiplyLocal(src)

Description:

Multiply the values of this Matrix4 by those given in the src argument.

Parameters:

name	type	optional	description
src	Phaser.Math.Matrix4	No	The source Matrix4 that this Matrix4 is multiplied by.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L603
Since: 3.0.0

---

multiplyMatrices

<instance> multiplyMatrices(a, b)

Description:

Multiplies the two given Matrix4 objects and stores the results in this Matrix.

Parameters:

name	type	optional	description
a	Phaser.Math.Matrix4	No	The first Matrix4 to multiply.
b	Phaser.Math.Matrix4	No	The second Matrix4 to multiply.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L658
Since: 3.50.0

---

multiplyToMat4

<instance> multiplyToMat4(src, out)

Description:

Multiplies this Matrix4 by the given src Matrix4 and stores the results in the out Matrix4.

Parameters:

name	type	optional	description
src	Phaser.Math.Matrix4	No	The Matrix4 to multiply with this one.
out	Phaser.Math.Matrix4	No	The receiving Matrix.

Returns: Phaser.Math.Matrix4 - This out Matrix4.

Source: src/math/Matrix4.js#L1604
Since: 3.50.0

---

ortho

<instance> ortho(left, right, bottom, top, near, far)

Description:

Generate an orthogonal projection matrix with the given bounds.

Parameters:

name	type	optional	description
left	number	No	The left bound of the frustum.
right	number	No	The right bound of the frustum.
bottom	number	No	The bottom bound of the frustum.
top	number	No	The top bound of the frustum.
near	number	No	The near bound of the frustum.
far	number	No	The far bound of the frustum.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1291
Since: 3.0.0

---

perspective

<instance> perspective(fovy, aspect, near, far)

Description:

Generate a perspective projection matrix with the given bounds.

Parameters:

name	type	optional	description
fovy	number	No	Vertical field of view in radians
aspect	number	No	Aspect ratio. Typically viewport width / height.
near	number	No	Near bound of the frustum.
far	number	No	Far bound of the frustum.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1209
Since: 3.0.0

---

perspectiveLH

<instance> perspectiveLH(width, height, near, far)

Description:

Generate a left-handed perspective projection matrix with the given frustum dimensions.

Unlike perspective, this method takes explicit pixel width and height for the frustum rather than a field-of-view angle and aspect ratio.

Parameters:

name	type	optional	description
width	number	No	The width of the frustum.
height	number	No	The height of the frustum.
near	number	No	Near bound of the frustum.
far	number	No	Far bound of the frustum.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1250
Since: 3.0.0

---

premultiply

<instance> premultiply(m)

Description:

Multiplies the given Matrix4 object with this Matrix.

This is the same as calling multiplyMatrices(m, this).

Parameters:

name	type	optional	description
m	Phaser.Math.Matrix4	No	The Matrix4 to multiply with this one.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L641
Since: 3.50.0

---

rotate

<instance> rotate(rad, axis)

Description:

Apply a rotation transformation to this Matrix.

Parameters:

name	type	optional	description
rad	number	No	The angle in radians to rotate by.
axis	Phaser.Math.Vector3	No	The axis to rotate upon.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L850
Since: 3.0.0

---

rotateX

<instance> rotateX(rad)

Description:

Rotate this matrix on its X axis.

Parameters:

name	type	optional	description
rad	number	No	The angle in radians to rotate by.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L934
Since: 3.0.0

---

rotateY

<instance> rotateY(rad)

Description:

Rotate this matrix on its Y axis.

Parameters:

name	type	optional	description
rad	number	No	The angle to rotate by, in radians.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L973
Since: 3.0.0

---

rotateZ

<instance> rotateZ(rad)

Description:

Rotate this matrix on its Z axis.

Parameters:

name	type	optional	description
rad	number	No	The angle to rotate by, in radians.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1012
Since: 3.0.0

---

scale

<instance> scale(v)

Description:

Apply a scale transformation to this Matrix.

Uses the x, y and z components of the given Vector to scale the Matrix.

Parameters:

name	type	optional	description
v	Phaser.Math.Vector3 | Phaser.Math.Vector4	No	The Vector to scale this Matrix with.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L767
Since: 3.0.0

---

scaleXYZ

<instance> scaleXYZ(x, y, z)

Description:

Apply a scale transformation to this Matrix.

Parameters:

name	type	optional	description
x	number	No	The x component.
y	number	No	The y component.
z	number	No	The z component.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L784
Since: 3.16.0

---

scaling

<instance> scaling(x, y, z)

Description:

Set the scaling values of this Matrix.

Parameters:

name	type	optional	description
x	number	No	The x scaling value.
y	number	No	The y scaling value.
z	number	No	The z scaling value.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L254
Since: 3.0.0

---

set

<instance> set(src)

Description:

This method is an alias for Matrix4.copy.

Parameters:

name	type	optional	description
src	Phaser.Math.Matrix4	No	The Matrix to set the values of this Matrix from.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L73
Since: 3.0.0

---

setValues

<instance> setValues(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33)

Description:

Sets all values of this Matrix4.

Parameters:

name	type	optional	description
m00	number	No	The m00 value.
m01	number	No	The m01 value.
m02	number	No	The m02 value.
m03	number	No	The m03 value.
m10	number	No	The m10 value.
m11	number	No	The m11 value.
m12	number	No	The m12 value.
m13	number	No	The m13 value.
m20	number	No	The m20 value.
m21	number	No	The m21 value.
m22	number	No	The m22 value.
m23	number	No	The m23 value.
m30	number	No	The m30 value.
m31	number	No	The m31 value.
m32	number	No	The m32 value.
m33	number	No	The m33 value.

Returns: Phaser.Math.Matrix4 - This Matrix4 instance.

Source: src/math/Matrix4.js#L88
Since: 3.50.0

---

setWorldMatrix

<instance> setWorldMatrix(rotation, position, scale, [viewMatrix], [projectionMatrix])

Description:

Generate a world matrix from the given rotation, position, scale, view matrix and projection matrix.

Parameters:

name	type	optional	description
rotation	Phaser.Math.Vector3	No	The rotation of the world matrix.
position	Phaser.Math.Vector3	No	The position of the world matrix.
scale	Phaser.Math.Vector3	No	The scale of the world matrix.
viewMatrix	Phaser.Math.Matrix4	Yes	The view matrix.
projectionMatrix	Phaser.Math.Matrix4	Yes	The projection matrix.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1567
Since: 3.0.0

---

transform

<instance> transform(position, scale, rotation)

Description:

Generates a transform matrix based on the given position, scale and rotation.

Parameters:

name	type	optional	description
position	Phaser.Math.Vector3	No	The position vector.
scale	Phaser.Math.Vector3	No	The scale vector.
rotation	Phaser.Math.Quaternion	No	The rotation quaternion.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L184
Since: 3.50.0

---

translate

<instance> translate(v)

Description:

Translate this Matrix using the given Vector.

Parameters:

name	type	optional	description
v	Phaser.Math.Vector3 | Phaser.Math.Vector4	No	The Vector to translate this Matrix with.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L728
Since: 3.0.0

---

translateXYZ

<instance> translateXYZ(x, y, z)

Description:

Translate this Matrix using the given values.

Parameters:

name	type	optional	description
x	number	No	The x component.
y	number	No	The y component.
z	number	No	The z component.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L743
Since: 3.16.0

---

transpose

<instance> transpose()

Description:

Transpose this Matrix.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L293
Since: 3.0.0

---

xyz

<instance> xyz(x, y, z)

Description:

Set the x, y and z values of this Matrix.

Parameters:

name	type	optional	description
x	number	No	The x value.
y	number	No	The y value.
z	number	No	The z value.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L229
Since: 3.0.0

---

yawPitchRoll

<instance> yawPitchRoll(yaw, pitch, roll)

Description:

Set the values of this matrix from the given yaw, pitch and roll values.

Parameters:

name	type	optional	description
yaw	number	No	The yaw angle, in radians.
pitch	number	No	The pitch angle, in radians.
roll	number	No	The roll angle, in radians.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L1506
Since: 3.0.0

---

zero

<instance> zero()

Description:

Reset this Matrix.

Sets all values to 0.

Returns: Phaser.Math.Matrix4 - This Matrix4.

Source: src/math/Matrix4.js#L169
Since: 3.0.0

---