goog.vec.Mat4

Provided By	`goog.vec.Mat4`

Performs a per-component addition of the matrix mat0 and mat1, storing the result into resultMat.

Parameters

`mat0`	`(Float32Array\|Float64Array\|Array<number>)`
	The first addend.
`mat1`	`(Float32Array\|Float64Array\|Array<number>)`
	The second addend.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the results (may be either mat0 or mat1).

Returns

(Float32Array|Float64Array|Array<number>)

return resultMat so that operations can be chained together.

VIEW SOURCE

Creates a clone of a 4x4 matrix of Float32.

Deprecated	Use cloneFloat32.

Parameters

`matrix`	`(Float32Array\|Array<number>)`
	The source 4x4 matrix.

Returns

Float32Array

The new 4x4 element matrix.

VIEW SOURCE

Creates a clone of a 4x4 matrix of Float32.

Parameters

`matrix`	`Float32Array`
	The source 4x4 matrix.

Returns

Float32Array

The new 4x4 element matrix.

VIEW SOURCE

Creates a clone of a 4x4 matrix of Float64.

Parameters

`matrix`	`Float64Array`
	The source 4x4 matrix.

Returns

Float64Array

The new 4x4 element matrix.

VIEW SOURCE

Creates the array representation of a 4x4 matrix of Float32. The returned matrix is cleared to all zeros.

Deprecated	Use createFloat32.

Parameters

None.

Returns

Float32Array

The new matrix.

VIEW SOURCE

Creates the array representation of a 4x4 matrix of Float32. The use of the array directly instead of a class reduces overhead. The returned matrix is cleared to all zeros.

Parameters

None.

Returns

Float32Array

The new matrix.

VIEW SOURCE

Creates a 4x4 matrix of Float32 initialized from the given array.

Parameters

`matrix`	`(Float32Array\|Float64Array\|Array<number>)`
	The array containing the matrix values in column major order.

Returns

Float32Array

The new, 16 element array.

VIEW SOURCE

Creates a 4x4 matrix of Float32 initialized from the given values.

Parameters

`v00`	`number`
	The values at (0, 0).
`v10`	`number`
	The values at (1, 0).
`v20`	`number`
	The values at (2, 0).
`v30`	`number`
	The values at (3, 0).
`v01`	`number`
	The values at (0, 1).
`v11`	`number`
	The values at (1, 1).
`v21`	`number`
	The values at (2, 1).
`v31`	`number`
	The values at (3, 1).
`v02`	`number`
	The values at (0, 2).
`v12`	`number`
	The values at (1, 2).
`v22`	`number`
	The values at (2, 2).
`v32`	`number`
	The values at (3, 2).
`v03`	`number`
	The values at (0, 3).
`v13`	`number`
	The values at (1, 3).
`v23`	`number`
	The values at (2, 3).
`v33`	`number`
	The values at (3, 3).

Returns

Float32Array

The new, 16 element array.

VIEW SOURCE

Creates a 4x4 identity matrix of Float32.

Parameters

None.

Returns

Float32Array

The new 16 element array.

VIEW SOURCE

Creates the array representation of a 4x4 matrix of Float64. The returned matrix is cleared to all zeros.

Parameters

None.

Returns

Float64Array

The new matrix.

VIEW SOURCE

Creates a 4x4 matrix of Float64 initialized from the given array.

Parameters

`matrix`	`(Float32Array\|Float64Array\|Array<number>)`
	The array containing the matrix values in column major order.

Returns

Float64Array

The new, nine element array.

VIEW SOURCE

Creates a 4x4 matrix of Float64 initialized from the given values.

Parameters

`v00`	`number`
	The values at (0, 0).
`v10`	`number`
	The values at (1, 0).
`v20`	`number`
	The values at (2, 0).
`v30`	`number`
	The values at (3, 0).
`v01`	`number`
	The values at (0, 1).
`v11`	`number`
	The values at (1, 1).
`v21`	`number`
	The values at (2, 1).
`v31`	`number`
	The values at (3, 1).
`v02`	`number`
	The values at (0, 2).
`v12`	`number`
	The values at (1, 2).
`v22`	`number`
	The values at (2, 2).
`v32`	`number`
	The values at (3, 2).
`v03`	`number`
	The values at (0, 3).
`v13`	`number`
	The values at (1, 3).
`v23`	`number`
	The values at (2, 3).
`v33`	`number`
	The values at (3, 3).

Returns

Float64Array

The new, 16 element array.

VIEW SOURCE

Creates a 4x4 identity matrix of Float64.

Parameters

None.

Returns

Float64Array

The new 16 element array.

VIEW SOURCE

Creates a 4x4 matrix of Float32 initialized from the given array.

Deprecated	Use createFloat32FromArray.

Parameters

`matrix`	`(Float32Array\|Array<number>)`
	The array containing the matrix values in column major order.

Returns

Float32Array

The new, nine element array.

VIEW SOURCE

Creates a 4x4 matrix of Float32 initialized from the given values.

Deprecated	Use createFloat32FromValues.

Parameters

`v00`	`number`
	The values at (0, 0).
`v10`	`number`
	The values at (1, 0).
`v20`	`number`
	The values at (2, 0).
`v30`	`number`
	The values at (3, 0).
`v01`	`number`
	The values at (0, 1).
`v11`	`number`
	The values at (1, 1).
`v21`	`number`
	The values at (2, 1).
`v31`	`number`
	The values at (3, 1).
`v02`	`number`
	The values at (0, 2).
`v12`	`number`
	The values at (1, 2).
`v22`	`number`
	The values at (2, 2).
`v32`	`number`
	The values at (3, 2).
`v03`	`number`
	The values at (0, 3).
`v13`	`number`
	The values at (1, 3).
`v23`	`number`
	The values at (2, 3).
`v33`	`number`
	The values at (3, 3).

Returns

Float32Array

The new, 16 element array.

VIEW SOURCE

Creates the array representation of a 4x4 matrix of Float32. The returned matrix is cleared to all zeros.

Deprecated	Use createFloat32Identity.

Parameters

None.

Returns

Float32Array

The new 16 element array.

VIEW SOURCE

Creates the array representation of a 4x4 matrix of Number. The returned matrix is cleared to all zeros.

Parameters

None.

Returns

Array<number>

The new matrix.

VIEW SOURCE

Creates a 4x4 identity matrix of Number. The returned matrix is cleared to all zeros.

Parameters

None.

Returns

Array<number>

The new 16 element array.

VIEW SOURCE

Computes the determinant of the matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to compute the matrix for.

Returns

number

The determinant of the matrix.

VIEW SOURCE

Returns true if the components of mat0 are equal to the components of mat1.

Parameters

`mat0`	`(Float32Array\|Float64Array\|Array<number>)`
	The first matrix.
`mat1`	`(Float32Array\|Float64Array\|Array<number>)`
	The second matrix.

Returns

boolean

True if the two matrices are equivalent.

VIEW SOURCE

Retrieves the specified column from the matrix into the given vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the values.
`column`	`number`
	The column to get the values from.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector of elements to receive the column.

Returns

(Float32Array|Float64Array|Array<number>)

return vec so that operations can be chained together.

VIEW SOURCE

Retrieves the column values from the given matrix into the given vectors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the columns.
`vec0`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive column 0.
`vec1`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive column 1.
`vec2`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive column 2.
`vec3`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive column 3.

VIEW SOURCE

Gets the diagonal values of the matrix into the given vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix containing the values.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive the values.
`opt_diagonal`	`number=`
	Which diagonal to get. A value of 0 selects the main diagonal, a positive number selects a super diagonal and a negative number selects a sub diagonal.

Returns

(Float32Array|Float64Array|Array<number>)

return vec so that operations can be chained together.

VIEW SOURCE

Retrieves the element at the requested row and column.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix containing the value to retrieve.
`row`	`number`
	The row index.
`column`	`number`
	The column index.

Returns

number

The element value at the requested row, column indices.

VIEW SOURCE

Retrieves the row values into the given vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the values.
`row`	`number`
	The index of the row supplying the values.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive the row.

Returns

(Float32Array|Float64Array|Array<number>)

return vec so that operations can be chained together.

VIEW SOURCE

Retrieves the rows of the matrix into the supplied vectors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to supply the values.
`vec0`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive row 0.
`vec1`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive row 1.
`vec2`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive row 2.
`vec3`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive row 3.

VIEW SOURCE

Retrieves the translation component of the transformation matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The transformation matrix.
`translation`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector for storing the result.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Computes the inverse of mat storing the result into resultMat. If the inverse is defined, this function returns true, false otherwise.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to invert.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the result (may be mat).

Returns

boolean

True if the inverse is defined. If false is returned, resultMat is not modified.

VIEW SOURCE

Makes the given 4x4 matrix a rotation matrix given Euler angles using the ZXZ convention. Given the euler angles [theta1, theta2, theta3], the rotation is defined as rotation = rotation_z(theta1) * rotation_x(theta2) * rotation_z(theta3), with theta1 in [0, 2 * pi], theta2 in [0, pi] and theta3 in [0, 2 * pi]. rotation_x(theta) means rotation around the X axis of theta radians,

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`theta1`	`number`
	The angle of rotation around the Z axis in radians.
`theta2`	`number`
	The angle of rotation around the X axis in radians.
`theta3`	`number`
	The angle of rotation around the Z axis in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a perspective projection matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`left`	`number`
	The coordinate of the left clipping plane.
`right`	`number`
	The coordinate of the right clipping plane.
`bottom`	`number`
	The coordinate of the bottom clipping plane.
`top`	`number`
	The coordinate of the top clipping plane.
`near`	`number`
	The distance to the near clipping plane.
`far`	`number`
	The distance to the far clipping plane.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix the identity matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a modelview matrix of a camera so that the camera is 'looking at' the given center point.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`eyePt`	`(Float32Array\|Float64Array\|Array<number>)`
	The position of the eye point (camera origin).
`centerPt`	`(Float32Array\|Float64Array\|Array<number>)`
	The point to aim the camera at.
`worldUpVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector that identifies the up direction for the camera.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix an orthographic projection matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`left`	`number`
	The coordinate of the left clipping plane.
`right`	`number`
	The coordinate of the right clipping plane.
`bottom`	`number`
	The coordinate of the bottom clipping plane.
`top`	`number`
	The coordinate of the top clipping plane.
`near`	`number`
	The distance to the near clipping plane.
`far`	`number`
	The distance to the far clipping plane.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix perspective projection matrix given a field of view and aspect ratio.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`fovy`	`number`
	The field of view along the y (vertical) axis in radians.
`aspect`	`number`
	The x (width) to y (height) aspect ratio.
`near`	`number`
	The distance to the near clipping plane.
`far`	`number`
	The distance to the far clipping plane.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a rotation matrix with the given rotation angle about the axis defined by the vector (ax, ay, az).

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The rotation angle in radians.
`ax`	`number`
	The x component of the rotation axis.
`ay`	`number`
	The y component of the rotation axis.
`az`	`number`
	The z component of the rotation axis.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a rotation matrix with the given rotation angle about the X axis.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The rotation angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a rotation matrix with the given rotation angle about the Y axis.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The rotation angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a rotation matrix with the given rotation angle about the Z axis.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The rotation angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix as a scale matrix with x, y and z scale factors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`x`	`number`
	The scale along the x axis.
`y`	`number`
	The scale along the y axis.
`z`	`number`
	The scale along the z axis.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix a translation matrix with x, y and z translation factors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`x`	`number`
	The translation along the x axis.
`y`	`number`
	The translation along the y axis.
`z`	`number`
	The translation along the z axis.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Makes the given 4x4 matrix the zero matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so operations can be chained.

VIEW SOURCE

Multiplies the two matrices mat0 and mat1 using matrix multiplication, storing the result into resultMat.

Parameters

`mat0`	`(Float32Array\|Float64Array\|Array<number>)`
	The first (left hand) matrix.
`mat1`	`(Float32Array\|Float64Array\|Array<number>)`
	The second (right hand) matrix.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the results (may be either mat0 or mat1).

Returns

(Float32Array|Float64Array|Array<number>)

return resultMat so that operations can be chained together.

VIEW SOURCE

Multiplies matrix mat with the given scalar, storing the result into resultMat.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`scalar`	`number`
	The scalar value to multiply to each element of mat.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the results (may be mat).

Returns

(Float32Array|Float64Array|Array<number>)

return resultMat so that operations can be chained together.

VIEW SOURCE

Transforms the given vector with the given matrix storing the resulting, transformed vector into resultVec. The input vector is multiplied against the upper 3x4 matrix omitting the projective component.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the transformation.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to transform.
`resultVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to receive the results (may be vec).

Returns

(Float32Array|Float64Array|Array<number>)

return resultVec so that operations can be chained together.

VIEW SOURCE

Transforms the given vector with the given matrix storing the resulting, transformed vector into resultVec. The input vector is multiplied against the upper 3x3 matrix omitting the projective component and translation components.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the transformation.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to transform.
`resultVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to receive the results (may be vec).

Returns

(Float32Array|Float64Array|Array<number>)

return resultVec so that operations can be chained together.

VIEW SOURCE

Transforms the given vector with the given matrix storing the resulting, transformed vector into resultVec. The input vector is multiplied against the full 4x4 matrix with the homogeneous divide applied to reduce the 4 element vector to a 3 element vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the transformation.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to transform.
`resultVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The 3 element vector to receive the results (may be vec).

Returns

(Float32Array|Float64Array|Array<number>)

return resultVec so that operations can be chained together.

VIEW SOURCE

Transforms the given vector with the given matrix storing the resulting, transformed vector into resultVec.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix supplying the transformation.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to transform.
`resultVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector to receive the results (may be vec).

Returns

(Float32Array|Float64Array|Array<number>)

return resultVec so that operations can be chained together.

VIEW SOURCE

Rotate the given matrix by angle about the x,y,z axis. Equivalent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeRotate(goog.vec.Mat4.create(), angle, x, y, z), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The angle in radians.
`x`	`number`
	The x component of the rotation axis.
`y`	`number`
	The y component of the rotation axis.
`z`	`number`
	The z component of the rotation axis.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Rotate the given matrix by angle about the x axis. Equivalent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeRotateX(goog.vec.Mat4.create(), angle), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Rotate the given matrix by angle about the y axis. Equivalent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeRotateY(goog.vec.Mat4.create(), angle), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Rotate the given matrix by angle about the z axis. Equivalent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeRotateZ(goog.vec.Mat4.create(), angle), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`angle`	`number`
	The angle in radians.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Scales the given matrix by x,y,z. Equivalent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeScale(goog.vec.Mat4.create(), x, y, z), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`x`	`number`
	The x scale factor.
`y`	`number`
	The y scale factor.
`z`	`number`
	The z scale factor.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Sets the specified column with the value from the supplied vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`column`	`number`
	The column index to set the values on.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector of elements for the column.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the specified column with the supplied values.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`column`	`number`
	The column index to set the values on.
`v0`	`number`
	The value for row 0.
`v1`	`number`
	The value for row 1.
`v2`	`number`
	The value for row 2.
`v3`	`number`
	The value for row 3.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the columns of the matrix from the given vectors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`vec0`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for column 0.
`vec1`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for column 1.
`vec2`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for column 2.
`vec3`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for column 3.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the diagonal values of the matrix from the given vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector containing the values.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the diagonal values of the matrix from the given values.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`v00`	`number`
	The values for (0, 0).
`v11`	`number`
	The values for (1, 1).
`v22`	`number`
	The values for (2, 2).
`v33`	`number`
	The values for (3, 3).

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the element at the requested row and column.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to set the value on.
`row`	`number`
	The row index.
`column`	`number`
	The column index.
`value`	`number`
	The value to set at the requested row, column.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the matrix from the array of values stored in column major order.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`values`	`(Float32Array\|Float64Array\|Array<number>)`
	The column major ordered array of values to store in the matrix.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the matrix from the array of values stored in row major order.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`values`	`(Float32Array\|Float64Array\|Array<number>)`
	The row major ordered array of values to store in the matrix.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Initializes the matrix from the set of values. Note the values supplied are in column major order.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`v00`	`number`
	The values at (0, 0).
`v10`	`number`
	The values at (1, 0).
`v20`	`number`
	The values at (2, 0).
`v30`	`number`
	The values at (3, 0).
`v01`	`number`
	The values at (0, 1).
`v11`	`number`
	The values at (1, 1).
`v21`	`number`
	The values at (2, 1).
`v31`	`number`
	The values at (3, 1).
`v02`	`number`
	The values at (0, 2).
`v12`	`number`
	The values at (1, 2).
`v22`	`number`
	The values at (2, 2).
`v32`	`number`
	The values at (3, 2).
`v03`	`number`
	The values at (0, 3).
`v13`	`number`
	The values at (1, 3).
`v23`	`number`
	The values at (2, 3).
`v33`	`number`
	The values at (3, 3).

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the row values from the supplied vector.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the row values.
`row`	`number`
	The index of the row.
`vec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector containing the values.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the row values from the supplied values.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`row`	`number`
	The index of the row to receive the values.
`v0`	`number`
	The value for column 0.
`v1`	`number`
	The value for column 1.
`v2`	`number`
	The value for column 2.
`v3`	`number`
	The value for column 3.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Sets the rows of the matrix from the supplied vectors.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the values.
`vec0`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for row 0.
`vec1`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for row 1.
`vec2`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for row 2.
`vec3`	`(Float32Array\|Float64Array\|Array<number>)`
	The values for row 3.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained together.

VIEW SOURCE

Performs a per-component subtraction of the matrix mat0 and mat1, storing the result into resultMat.

Parameters

`mat0`	`(Float32Array\|Float64Array\|Array<number>)`
	The minuend.
`mat1`	`(Float32Array\|Float64Array\|Array<number>)`
	The subtrahend.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the results (may be either mat0 or mat1).

Returns

(Float32Array|Float64Array|Array<number>)

return resultMat so that operations can be chained together.

VIEW SOURCE

Decomposes a rotation matrix into Euler angles using the ZXZ convention so that rotation = rotation_z(theta1) * rotation_x(theta2) * rotation_z(theta3), with theta1 in [0, 2 * pi], theta2 in [0, pi] and theta3 in [0, 2 * pi]. rotation_x(theta) means rotation around the X axis of theta radians.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`euler`	`(Float32Array\|Float64Array\|Array<number>)`
	The ZXZ Euler angles in radians as [theta1, theta2, theta3].
`opt_theta2IsNegative`	`boolean=`
	Whether theta2 is in [-pi, 0] instead of the default [0, pi].

Returns

(Float32Array|Float64Array|Array<number>)

return euler so that operations can be chained together.

VIEW SOURCE

Decomposes a matrix into the lookAt vectors eyePt, fwdVec and worldUpVec. The matrix represents the modelview matrix of a camera. It is the inverse of lookAt except for the output of the fwdVec instead of centerPt. The centerPt itself cannot be recovered from a modelview matrix.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`eyePt`	`(Float32Array\|Float64Array\|Array<number>)`
	The position of the eye point (camera origin).
`fwdVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector describing where the camera points to.
`worldUpVec`	`(Float32Array\|Float64Array\|Array<number>)`
	The vector that identifies the up direction for the camera.

Returns

boolean

True if the method succeeds, false otherwise. The method can only fail if the inverse of viewMatrix is not defined.

VIEW SOURCE

Translates the given matrix by x,y,z. Equvialent to: goog.vec.Mat4.multMat( mat, goog.vec.Mat4.makeTranslate(goog.vec.Mat4.create(), x, y, z), mat);

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix.
`x`	`number`
	The translation along the x axis.
`y`	`number`
	The translation along the y axis.
`z`	`number`
	The translation along the z axis.

Returns

(Float32Array|Float64Array|Array<number>)

return mat so that operations can be chained.

VIEW SOURCE

Transposes the given matrix mat storing the result into resultMat.

Parameters

`mat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to transpose.
`resultMat`	`(Float32Array\|Float64Array\|Array<number>)`
	The matrix to receive the results (may be mat).

Returns

(Float32Array|Float64Array|Array<number>)

return resultMat so that operations can be chained together.

VIEW SOURCE

goog.vec.Mat4

Functions

addMat( mat0, mat1, resultMat ) → (Float32Array|Float64Array|Array<number>)

clone( matrix ) → Float32Array

cloneFloat32( matrix ) → Float32Array

cloneFloat64( matrix ) → Float64Array

create() → Float32Array

createFloat32() → Float32Array

createFloat32FromArray( matrix ) → Float32Array

createFloat32FromValues( v00, v10, v20, v30, v01, v11, v21, v31, v02, v12, v22, v32, v03, v13, v23, v33 ) → Float32Array

createFloat32Identity() → Float32Array

createFloat64() → Float64Array

createFloat64FromArray( matrix ) → Float64Array

createFloat64FromValues( v00, v10, v20, v30, v01, v11, v21, v31, v02, v12, v22, v32, v03, v13, v23, v33 ) → Float64Array

createFloat64Identity() → Float64Array

createFromArray( matrix ) → Float32Array

createFromValues( v00, v10, v20, v30, v01, v11, v21, v31, v02, v12, v22, v32, v03, v13, v23, v33 ) → Float32Array

createIdentity() → Float32Array

createNumber() → Array<number>

createNumberIdentity() → Array<number>

determinant( mat ) → number

equals( mat0, mat1 ) → boolean

getColumn( mat, column, vec ) → (Float32Array|Float64Array|Array<number>)

getColumns( mat, vec0, vec1, vec2, vec3 ) → void

getDiagonal( mat, vec, opt_diagonal ) → (Float32Array|Float64Array|Array<number>)

getElement( mat, row, column ) → number

getRow( mat, row, vec ) → (Float32Array|Float64Array|Array<number>)

getRows( mat, vec0, vec1, vec2, vec3 ) → void

getTranslation( mat, translation ) → (Float32Array|Float64Array|Array<number>)

invert( mat, resultMat ) → boolean

makeEulerZXZ( mat, theta1, theta2, theta3 ) → (Float32Array|Float64Array|Array<number>)

makeFrustum( mat, left, right, bottom, top, near, far ) → (Float32Array|Float64Array|Array<number>)

makeIdentity( mat ) → (Float32Array|Float64Array|Array<number>)

makeLookAt( mat, eyePt, centerPt, worldUpVec ) → (Float32Array|Float64Array|Array<number>)

makeOrtho( mat, left, right, bottom, top, near, far ) → (Float32Array|Float64Array|Array<number>)

makePerspective( mat, fovy, aspect, near, far ) → (Float32Array|Float64Array|Array<number>)

makeRotate( mat, angle, ax, ay, az ) → (Float32Array|Float64Array|Array<number>)

makeRotateX( mat, angle ) → (Float32Array|Float64Array|Array<number>)

makeRotateY( mat, angle ) → (Float32Array|Float64Array|Array<number>)

makeRotateZ( mat, angle ) → (Float32Array|Float64Array|Array<number>)

makeScale( mat, x, y, z ) → (Float32Array|Float64Array|Array<number>)

makeTranslate( mat, x, y, z ) → (Float32Array|Float64Array|Array<number>)

makeZero( mat ) → (Float32Array|Float64Array|Array<number>)

multMat( mat0, mat1, resultMat ) → (Float32Array|Float64Array|Array<number>)

multScalar( mat, scalar, resultMat ) → (Float32Array|Float64Array|Array<number>)

multVec3( mat, vec, resultVec ) → (Float32Array|Float64Array|Array<number>)

multVec3NoTranslate( mat, vec, resultVec ) → (Float32Array|Float64Array|Array<number>)

multVec3Projective( mat, vec, resultVec ) → (Float32Array|Float64Array|Array<number>)

multVec4( mat, vec, resultVec ) → (Float32Array|Float64Array|Array<number>)

rotate( mat, angle, x, y, z ) → (Float32Array|Float64Array|Array<number>)

rotateX( mat, angle ) → (Float32Array|Float64Array|Array<number>)

rotateY( mat, angle ) → (Float32Array|Float64Array|Array<number>)

rotateZ( mat, angle ) → (Float32Array|Float64Array|Array<number>)

scale( mat, x, y, z ) → (Float32Array|Float64Array|Array<number>)

setColumn( mat, column, vec ) → (Float32Array|Float64Array|Array<number>)

setColumnValues( mat, column, v0, v1, v2, v3 ) → (Float32Array|Float64Array|Array<number>)

setColumns( mat, vec0, vec1, vec2, vec3 ) → (Float32Array|Float64Array|Array<number>)

setDiagonal( mat, vec ) → (Float32Array|Float64Array|Array<number>)

setDiagonalValues( mat, v00, v11, v22, v33 ) → (Float32Array|Float64Array|Array<number>)

setElement( mat, row, column, value ) → (Float32Array|Float64Array|Array<number>)

setFromArray( mat, values ) → (Float32Array|Float64Array|Array<number>)

setFromRowMajorArray( mat, values ) → (Float32Array|Float64Array|Array<number>)

setFromValues( mat, v00, v10, v20, v30, v01, v11, v21, v31, v02, v12, v22, v32, v03, v13, v23, v33 ) → (Float32Array|Float64Array|Array<number>)

setRow( mat, row, vec ) → (Float32Array|Float64Array|Array<number>)

setRowValues( mat, row, v0, v1, v2, v3 ) → (Float32Array|Float64Array|Array<number>)

setRows( mat, vec0, vec1, vec2, vec3 ) → (Float32Array|Float64Array|Array<number>)

subMat( mat0, mat1, resultMat ) → (Float32Array|Float64Array|Array<number>)

toEulerZXZ( mat, euler, opt_theta2IsNegative ) → (Float32Array|Float64Array|Array<number>)

toLookAt( mat, eyePt, fwdVec, worldUpVec ) → boolean

translate( mat, x, y, z ) → (Float32Array|Float64Array|Array<number>)

transpose( mat, resultMat ) → (Float32Array|Float64Array|Array<number>)

Properties

AnyType → (Float32Array|Float64Array|Array<number>)

Float32 → Float32Array

Float64 → Float64Array

Mat4Like → (Float32Array|Array<number>)

Number → Array<number>

Type → Float32Array

addMat( `mat0`, `mat1`, `resultMat` ) `→` `(Float32Array|Float64Array|Array<number>)`

clone( `matrix` ) `→` `Float32Array`

cloneFloat32( `matrix` ) `→` `Float32Array`

cloneFloat64( `matrix` ) `→` `Float64Array`

create() `→` `Float32Array`

createFloat32() `→` `Float32Array`

createFloat32FromArray( `matrix` ) `→` `Float32Array`

createFloat32FromValues( `v00`, `v10`, `v20`, `v30`, `v01`, `v11`, `v21`, `v31`, `v02`, `v12`, `v22`, `v32`, `v03`, `v13`, `v23`, `v33` ) `→` `Float32Array`

createFloat32Identity() `→` `Float32Array`

createFloat64() `→` `Float64Array`

createFloat64FromArray( `matrix` ) `→` `Float64Array`

createFloat64FromValues( `v00`, `v10`, `v20`, `v30`, `v01`, `v11`, `v21`, `v31`, `v02`, `v12`, `v22`, `v32`, `v03`, `v13`, `v23`, `v33` ) `→` `Float64Array`

createFloat64Identity() `→` `Float64Array`

createFromArray( `matrix` ) `→` `Float32Array`

createFromValues( `v00`, `v10`, `v20`, `v30`, `v01`, `v11`, `v21`, `v31`, `v02`, `v12`, `v22`, `v32`, `v03`, `v13`, `v23`, `v33` ) `→` `Float32Array`

createIdentity() `→` `Float32Array`

createNumber() `→` `Array<number>`

createNumberIdentity() `→` `Array<number>`

determinant( `mat` ) `→` `number`

equals( `mat0`, `mat1` ) `→` `boolean`

getColumn( `mat`, `column`, `vec` ) `→` `(Float32Array|Float64Array|Array<number>)`

getColumns( `mat`, `vec0`, `vec1`, `vec2`, `vec3` ) `→` `void`

getDiagonal( `mat`, `vec`, `opt_diagonal` ) `→` `(Float32Array|Float64Array|Array<number>)`

getElement( `mat`, `row`, `column` ) `→` `number`

getRow( `mat`, `row`, `vec` ) `→` `(Float32Array|Float64Array|Array<number>)`

getRows( `mat`, `vec0`, `vec1`, `vec2`, `vec3` ) `→` `void`

getTranslation( `mat`, `translation` ) `→` `(Float32Array|Float64Array|Array<number>)`

invert( `mat`, `resultMat` ) `→` `boolean`

makeEulerZXZ( `mat`, `theta1`, `theta2`, `theta3` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeFrustum( `mat`, `left`, `right`, `bottom`, `top`, `near`, `far` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeIdentity( `mat` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeLookAt( `mat`, `eyePt`, `centerPt`, `worldUpVec` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeOrtho( `mat`, `left`, `right`, `bottom`, `top`, `near`, `far` ) `→` `(Float32Array|Float64Array|Array<number>)`

makePerspective( `mat`, `fovy`, `aspect`, `near`, `far` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeRotate( `mat`, `angle`, `ax`, `ay`, `az` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeRotateX( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeRotateY( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeRotateZ( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeScale( `mat`, `x`, `y`, `z` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeTranslate( `mat`, `x`, `y`, `z` ) `→` `(Float32Array|Float64Array|Array<number>)`

makeZero( `mat` ) `→` `(Float32Array|Float64Array|Array<number>)`

multMat( `mat0`, `mat1`, `resultMat` ) `→` `(Float32Array|Float64Array|Array<number>)`

multScalar( `mat`, `scalar`, `resultMat` ) `→` `(Float32Array|Float64Array|Array<number>)`

multVec3( `mat`, `vec`, `resultVec` ) `→` `(Float32Array|Float64Array|Array<number>)`

multVec3NoTranslate( `mat`, `vec`, `resultVec` ) `→` `(Float32Array|Float64Array|Array<number>)`

multVec3Projective( `mat`, `vec`, `resultVec` ) `→` `(Float32Array|Float64Array|Array<number>)`

multVec4( `mat`, `vec`, `resultVec` ) `→` `(Float32Array|Float64Array|Array<number>)`

rotate( `mat`, `angle`, `x`, `y`, `z` ) `→` `(Float32Array|Float64Array|Array<number>)`

rotateX( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

rotateY( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

rotateZ( `mat`, `angle` ) `→` `(Float32Array|Float64Array|Array<number>)`

scale( `mat`, `x`, `y`, `z` ) `→` `(Float32Array|Float64Array|Array<number>)`

setColumn( `mat`, `column`, `vec` ) `→` `(Float32Array|Float64Array|Array<number>)`

setColumnValues( `mat`, `column`, `v0`, `v1`, `v2`, `v3` ) `→` `(Float32Array|Float64Array|Array<number>)`

setColumns( `mat`, `vec0`, `vec1`, `vec2`, `vec3` ) `→` `(Float32Array|Float64Array|Array<number>)`

setDiagonal( `mat`, `vec` ) `→` `(Float32Array|Float64Array|Array<number>)`

setDiagonalValues( `mat`, `v00`, `v11`, `v22`, `v33` ) `→` `(Float32Array|Float64Array|Array<number>)`

setElement( `mat`, `row`, `column`, `value` ) `→` `(Float32Array|Float64Array|Array<number>)`

setFromArray( `mat`, `values` ) `→` `(Float32Array|Float64Array|Array<number>)`

setFromRowMajorArray( `mat`, `values` ) `→` `(Float32Array|Float64Array|Array<number>)`

setFromValues( `mat`, `v00`, `v10`, `v20`, `v30`, `v01`, `v11`, `v21`, `v31`, `v02`, `v12`, `v22`, `v32`, `v03`, `v13`, `v23`, `v33` ) `→` `(Float32Array|Float64Array|Array<number>)`

setRow( `mat`, `row`, `vec` ) `→` `(Float32Array|Float64Array|Array<number>)`

setRowValues( `mat`, `row`, `v0`, `v1`, `v2`, `v3` ) `→` `(Float32Array|Float64Array|Array<number>)`

setRows( `mat`, `vec0`, `vec1`, `vec2`, `vec3` ) `→` `(Float32Array|Float64Array|Array<number>)`

subMat( `mat0`, `mat1`, `resultMat` ) `→` `(Float32Array|Float64Array|Array<number>)`

toEulerZXZ( `mat`, `euler`, `opt_theta2IsNegative` ) `→` `(Float32Array|Float64Array|Array<number>)`

toLookAt( `mat`, `eyePt`, `fwdVec`, `worldUpVec` ) `→` `boolean`

translate( `mat`, `x`, `y`, `z` ) `→` `(Float32Array|Float64Array|Array<number>)`

transpose( `mat`, `resultMat` ) `→` `(Float32Array|Float64Array|Array<number>)`

AnyType `→` `(Float32Array|Float64Array|Array<number>)`

Float32 `→` `Float32Array`

Float64 `→` `Float64Array`

Mat4Like `→` `(Float32Array|Array<number>)`

Number `→` `Array<number>`

Type `→` `Float32Array`