[name]
A 4x4 Matrix.
Example
// Simple rig for rotating around 3 axes
var m = new THREE.Matrix4();
var m1 = new THREE.Matrix4();
var m2 = new THREE.Matrix4();
var m3 = new THREE.Matrix4();
var alpha = 0;
var beta = Math.PI;
var gamma = Math.PI/2;
m1.makeRotationX( alpha );
m2.makeRotationY( beta );
m3.makeRotationZ( gamma );
m.multiplyMatrices( m1, m2 );
m.multiply( m3 );
Constructor
[name]( [page:Float n11], [page:Float n12], [page:Float n13], [page:Float n14], [page:Float n21], [page:Float n22], [page:Float n23], [page:Float n24], [page:Float n31], [page:Float n32], [page:Float n33], [page:Float n34], [page:Float n41], [page:Float n42], [page:Float n43], [page:Float n44] )
Initialises the matrix with the supplied row-major values n11..n44, or just creates an identity matrix if no values are passed.
Properties
[property:Float32Array elements]
A column-major list of matrix values.
Methods
[method:Matrix4 set]( [page:Float n11], [page:Float n12], [page:Float n13], [page:Float n14], [page:Float n21], [page:Float n22], [page:Float n23], [page:Float n24], [page:Float n31], [page:Float n32], [page:Float n33], [page:Float n34], [page:Float n41], [page:Float n42], [page:Float n43], [page:Float n44] ) [page:Matrix4 this]
Sets all fields of this matrix to the supplied row-major values n11..n44.
[method:Matrix4 identity]() [page:Matrix4 this]
Resets this matrix to identity.
[method:Matrix4 copy]( [page:Matrix4 m] ) [page:Matrix4 this]
Copies a matrix *m* into this matrix.
[method:Matrix4 copyPosition]( [page:Matrix4 m] ) [page:Matrix4 this]
Copies the translation component of the supplied matrix *m* into this matrix translation component.
[method:Matrix4 makeBasis]( [page:Vector3 xAxis], [page:Vector3 zAxis], [page:Vector3 zAxis] ) [page:Matrix4 this]
Creates the basis matrix consisting of the three provided axis vectors. Returns the current matrix.
[method:Matrix4 extractBasis]( [page:Vector3 xAxis], [page:Vector3 zAxis], [page:Vector3 zAxis] ) [page:Matrix4 this]
Extracts basis of into the three axis vectors provided. Returns the current matrix.
[method:Matrix4 extractRotation]( [page:Matrix4 m] ) [page:Matrix4 this]
Extracts the rotation of the supplied matrix *m* into this matrix rotation component.
[method:Matrix4 lookAt]( [page:Vector3 eye], [page:Vector3 center], [page:Vector3 up], ) [page:Matrix4 this]
Constructs a rotation matrix, looking from *eye* towards *center* with defined *up* vector.
[method:Matrix4 multiply]( [page:Matrix4 m] ) [page:Matrix4 this]
Multiplies this matrix by *m*.
[method:Matrix4 multiplyMatrices]( [page:Matrix4 a], [page:Matrix4 b] ) [page:Matrix4 this]
Sets this matrix to *a x b*.
[method:Matrix4 multiplyToArray]( [page:Matrix4 a], [page:Matrix4 b], [page:Array r] ) [page:Matrix4 this]
Sets this matrix to *a x b* and stores the result into the flat array *r*.
*r* can be either a regular Array or a TypedArray.
[method:Matrix4 multiplyScalar]( [page:Float s] ) [page:Matrix4 this]
Multiplies this matrix by *s*.
[method:Float determinant]()
Computes determinant of this matrix.
Based on [link:http://www.euclideanspace.com/maths/algebra/matrix/functions/inverse/fourD/index.htm]
[method:Matrix4 transpose]() [page:Matrix4 this]
Transposes this matrix.
[method:Array flattenToArrayOffset]( [page:Array flat], [page:Integer offset] )
Flattens this matrix into supplied *flat* array starting from *offset* position in the array.
[method:Matrix4 setPosition]( [page:Vector3 v] ) [page:Matrix4 this]
Sets the position component for this matrix from vector *v*.
[method:Matrix4 getInverse]( [page:Matrix4 m] ) [page:Matrix4 this]
Sets this matrix to the inverse of matrix *m*.
Based on [link:http://www.euclideanspace.com/maths/algebra/matrix/functions/inverse/fourD/index.htm].
[method:Matrix4 makeRotationFromEuler]( [page:Euler euler] ) [page:Matrix4 this]
euler — Rotation vector followed by order of rotations. Eg. "XYZ".
Sets the rotation submatrix of this matrix to the rotation specified by Euler angles, the rest of the matrix is identity.
Default order is *"XYZ"*.
[method:Matrix4 makeRotationFromQuaternion]( [page:Quaternion q] ) [page:Matrix4 this]
Sets the rotation submatrix of this matrix to the rotation specified by *q*. The rest of the matrix is identity.
[method:Matrix4 scale]( [page:Vector3 v] ) [page:Matrix4 this]
Multiplies the columns of this matrix by vector *v*.
[method:Matrix4 compose]( [page:Vector3 translation], [page:Quaternion quaternion], [page:Vector3 scale] ) [page:Matrix4 this]
Sets this matrix to the transformation composed of *translation*, *quaternion* and *scale*.
[method:Array decompose]( [page:Vector3 translation], [page:Quaternion quaternion], [page:Vector3 scale] )
Decomposes this matrix into the *translation*, *quaternion* and *scale* components.
[method:Matrix4 makeTranslation]( [page:Float x], [page:Float y], [page:Float z] ) [page:Matrix4 this]
Sets this matrix as translation transform.
[method:Matrix4 makeRotationX]( [page:Float theta] ) [page:Matrix4 this]
theta — Rotation angle in radians.
Sets this matrix as rotation transform around x axis by *theta* radians.
[method:Matrix4 makeRotationY]( [page:Float theta] ) [page:Matrix4 this]
theta — Rotation angle in radians.
Sets this matrix as rotation transform around y axis by *theta* radians.
[method:Matrix4 makeRotationZ]( [page:Float theta] ) [page:Matrix4 this]
theta — Rotation angle in radians.
Sets this matrix as rotation transform around z axis by *theta* radians.
[method:Matrix4 makeRotationAxis]( [page:Vector3 axis], [page:Float theta] ) [page:Matrix4 this]
axis — Rotation axis, should be normalized.
theta — Rotation angle in radians.
Sets this matrix as rotation transform around *axis* by *angle* radians.
Based on [link:http://www.gamedev.net/reference/articles/article1199.asp].
[method:Matrix4 makeScale]( [page:Float x], [page:Float y], [page:Float z] ) [page:Matrix4 this]
Sets this matrix as scale transform.
[method:Matrix4 makeFrustum]( [page:Float left], [page:Float right], [page:Float bottom], [page:Float top], [page:Float near], [page:Float far] ) [page:Matrix4 this]
Creates a [page:Frustum frustum] matrix.
[method:Matrix4 makePerspective]( [page:Float fov], [page:Float aspect], [page:Float near], [page:Float far] ) [page:Matrix4 this]
Creates a perspective projection matrix.
[method:Matrix4 makeOrthographic]( [page:Float left], [page:Float right], [page:Float bottom], [page:Float top], [page:Float near], [page:Float far] ) [page:Matrix4 this]
Creates an orthographic projection matrix.
[method:Matrix4 clone]()
Clones this matrix.
[method:Array applyToVector3Array]([page:Array a])
array -- An array in the form [vector1x, vector1y, vector1z, vector2x, vector2y, vector2z, ...]
Multiply (apply) this matrix to every vector3 in the array.
[method:Float getMaxScaleOnAxis]()
Gets the max scale value of the 3 axes.
Source
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]