Cocos2d-x  v3.10
All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Groups
Mat4 Class Reference

Defines a 4 x 4 floating point matrix representing a 3D transformation. More...

Public Member Functions

 Mat4 ()
 Default constructor. More...
 
 Mat4 (float m11, float m12, float m13, float m14, float m21, float m22, float m23, float m24, float m31, float m32, float m33, float m34, float m41, float m42, float m43, float m44)
 Constructs a matrix initialized to the specified value. More...
 
 Mat4 (const float *mat)
 Creates a matrix initialized to the specified column-major array. More...
 
 Mat4 (const Mat4 &copy)
 Constructs a new matrix by copying the values from the specified matrix. More...
 
 ~Mat4 ()
 Destructor.
 
void add (float scalar)
 Adds a scalar value to each component of this matrix. More...
 
void add (float scalar, Mat4 *dst)
 Adds a scalar value to each component of this matrix and stores the result in dst. More...
 
void add (const Mat4 &mat)
 Adds the specified matrix to this matrix. More...
 
bool decompose (Vec3 *scale, Quaternion *rotation, Vec3 *translation) const
 Decomposes the scale, rotation and translation components of this matrix. More...
 
float determinant () const
 Computes the determinant of this matrix. More...
 
void getScale (Vec3 *scale) const
 Gets the scalar component of this matrix in the specified vector. More...
 
bool getRotation (Quaternion *rotation) const
 Gets the rotational component of this matrix in the specified quaternion. More...
 
void getTranslation (Vec3 *translation) const
 Gets the translational component of this matrix in the specified vector. More...
 
void getUpVector (Vec3 *dst) const
 Gets the up vector of this matrix. More...
 
void getDownVector (Vec3 *dst) const
 Gets the down vector of this matrix. More...
 
void getLeftVector (Vec3 *dst) const
 Gets the left vector of this matrix. More...
 
void getRightVector (Vec3 *dst) const
 Gets the right vector of this matrix. More...
 
void getForwardVector (Vec3 *dst) const
 Gets the forward vector of this matrix. More...
 
void getBackVector (Vec3 *dst) const
 Gets the backward vector of this matrix. More...
 
bool inverse ()
 Inverts this matrix. More...
 
Mat4 getInversed () const
 Get the inversed matrix.
 
bool isIdentity () const
 Determines if this matrix is equal to the identity matrix. More...
 
void multiply (float scalar)
 Multiplies the components of this matrix by the specified scalar. More...
 
void multiply (float scalar, Mat4 *dst) const
 Multiplies the components of this matrix by a scalar and stores the result in dst. More...
 
void multiply (const Mat4 &mat)
 Multiplies this matrix by the specified one. More...
 
void negate ()
 Negates this matrix.
 
Mat4 getNegated () const
 Get the Negated matrix.
 
void rotate (const Quaternion &q)
 Post-multiplies this matrix by the matrix corresponding to the specified quaternion rotation. More...
 
void rotate (const Quaternion &q, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified quaternion rotation and stores the result in dst. More...
 
void rotate (const Vec3 &axis, float angle)
 Post-multiplies this matrix by the matrix corresponding to the specified rotation about the specified axis. More...
 
void rotate (const Vec3 &axis, float angle, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified rotation about the specified axis and stores the result in dst. More...
 
void rotateX (float angle)
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the x-axis. More...
 
void rotateX (float angle, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the x-axis and stores the result in dst. More...
 
void rotateY (float angle)
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the y-axis. More...
 
void rotateY (float angle, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the y-axis and stores the result in dst. More...
 
void rotateZ (float angle)
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the z-axis. More...
 
void rotateZ (float angle, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified rotation around the z-axis and stores the result in dst. More...
 
void scale (float value)
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation. More...
 
void scale (float value, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst. More...
 
void scale (float xScale, float yScale, float zScale)
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation. More...
 
void scale (float xScale, float yScale, float zScale, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst. More...
 
void scale (const Vec3 &s)
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation. More...
 
void scale (const Vec3 &s, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst. More...
 
void set (float m11, float m12, float m13, float m14, float m21, float m22, float m23, float m24, float m31, float m32, float m33, float m34, float m41, float m42, float m43, float m44)
 Sets the values of this matrix. More...
 
void set (const float *mat)
 Sets the values of this matrix to those in the specified column-major array. More...
 
void set (const Mat4 &mat)
 Sets the values of this matrix to those of the specified matrix. More...
 
void setIdentity ()
 Sets this matrix to the identity matrix.
 
void setZero ()
 Sets all elements of the current matrix to zero.
 
void subtract (const Mat4 &mat)
 Subtracts the specified matrix from the current matrix. More...
 
void transformPoint (Vec3 *point) const
 Transforms the specified point by this matrix. More...
 
void transformPoint (const Vec3 &point, Vec3 *dst) const
 Transforms the specified point by this matrix, and stores the result in dst. More...
 
void transformVector (Vec3 *vector) const
 Transforms the specified vector by this matrix by treating the fourth (w) coordinate as zero. More...
 
void transformVector (const Vec3 &vector, Vec3 *dst) const
 Transforms the specified vector by this matrix by treating the fourth (w) coordinate as zero, and stores the result in dst. More...
 
void transformVector (float x, float y, float z, float w, Vec3 *dst) const
 Transforms the specified vector by this matrix. More...
 
void transformVector (Vec4 *vector) const
 Transforms the specified vector by this matrix. More...
 
void transformVector (const Vec4 &vector, Vec4 *dst) const
 Transforms the specified vector by this matrix. More...
 
void translate (float x, float y, float z)
 Post-multiplies this matrix by the matrix corresponding to the specified translation. More...
 
void translate (float x, float y, float z, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified translation and stores the result in dst. More...
 
void translate (const Vec3 &t)
 Post-multiplies this matrix by the matrix corresponding to the specified translation. More...
 
void translate (const Vec3 &t, Mat4 *dst) const
 Post-multiplies this matrix by the matrix corresponding to the specified translation and stores the result in dst. More...
 
void transpose ()
 Transposes this matrix.
 
Mat4 getTransposed () const
 Get the Transposed matrix.
 
const Mat4 operator+ (const Mat4 &mat) const
 Calculates the sum of this matrix with the given matrix. More...
 
Mat4operator+= (const Mat4 &mat)
 Adds the given matrix to this matrix. More...
 
const Mat4 operator- (const Mat4 &mat) const
 Calculates the difference of this matrix with the given matrix. More...
 
Mat4operator-= (const Mat4 &mat)
 Subtracts the given matrix from this matrix. More...
 
const Mat4 operator- () const
 Calculates the negation of this matrix. More...
 
const Mat4 operator* (const Mat4 &mat) const
 Calculates the matrix product of this matrix with the given matrix. More...
 
Mat4operator*= (const Mat4 &mat)
 Right-multiplies this matrix by the given matrix. More...
 

Static Public Member Functions

static void createLookAt (const Vec3 &eyePosition, const Vec3 &targetPosition, const Vec3 &up, Mat4 *dst)
 Creates a view matrix based on the specified input parameters. More...
 
static void createLookAt (float eyePositionX, float eyePositionY, float eyePositionZ, float targetCenterX, float targetCenterY, float targetCenterZ, float upX, float upY, float upZ, Mat4 *dst)
 Creates a view matrix based on the specified input parameters. More...
 
static void createPerspective (float fieldOfView, float aspectRatio, float zNearPlane, float zFarPlane, Mat4 *dst)
 Builds a perspective projection matrix based on a field of view and returns by value. More...
 
static void createOrthographic (float width, float height, float zNearPlane, float zFarPlane, Mat4 *dst)
 Creates an orthographic projection matrix. More...
 
static void createOrthographicOffCenter (float left, float right, float bottom, float top, float zNearPlane, float zFarPlane, Mat4 *dst)
 Creates an orthographic projection matrix. More...
 
static void createBillboard (const Vec3 &objectPosition, const Vec3 &cameraPosition, const Vec3 &cameraUpVector, Mat4 *dst)
 Creates a spherical billboard that rotates around a specified object position. More...
 
static void createBillboard (const Vec3 &objectPosition, const Vec3 &cameraPosition, const Vec3 &cameraUpVector, const Vec3 &cameraForwardVector, Mat4 *dst)
 Creates a spherical billboard that rotates around a specified object position with provision for a safe default orientation. More...
 
static void createScale (const Vec3 &scale, Mat4 *dst)
 Creates a scale matrix. More...
 
static void createScale (float xScale, float yScale, float zScale, Mat4 *dst)
 Creates a scale matrix. More...
 
static void createRotation (const Quaternion &quat, Mat4 *dst)
 Creates a rotation matrix from the specified quaternion. More...
 
static void createRotation (const Vec3 &axis, float angle, Mat4 *dst)
 Creates a rotation matrix from the specified axis and angle. More...
 
static void createRotationX (float angle, Mat4 *dst)
 Creates a matrix describing a rotation around the x-axis. More...
 
static void createRotationY (float angle, Mat4 *dst)
 Creates a matrix describing a rotation around the y-axis. More...
 
static void createRotationZ (float angle, Mat4 *dst)
 Creates a matrix describing a rotation around the z-axis. More...
 
static void createTranslation (const Vec3 &translation, Mat4 *dst)
 Creates a translation matrix. More...
 
static void createTranslation (float xTranslation, float yTranslation, float zTranslation, Mat4 *dst)
 Creates a translation matrix. More...
 
static void add (const Mat4 &m1, const Mat4 &m2, Mat4 *dst)
 Adds the specified matrices and stores the result in dst. More...
 
static void multiply (const Mat4 &mat, float scalar, Mat4 *dst)
 Multiplies the components of the specified matrix by a scalar and stores the result in dst. More...
 
static void multiply (const Mat4 &m1, const Mat4 &m2, Mat4 *dst)
 Multiplies m1 by m2 and stores the result in dst. More...
 
static void subtract (const Mat4 &m1, const Mat4 &m2, Mat4 *dst)
 Subtracts the specified matrix from the current matrix. More...
 

Public Attributes

float m [16]
 Stores the columns of this 4x4 matrix.
 

Static Public Attributes

static const Mat4 ZERO
 equals to a matrix full of zeros.
 
static const Mat4 IDENTITY
 equals to the identity matrix.
 

Detailed Description

Defines a 4 x 4 floating point matrix representing a 3D transformation.

Vectors are treated as columns, resulting in a matrix that is represented as follows, where x, y and z are the translation components of the matrix:

1  0  0  x
0  1  0  y
0  0  1  z
0  0  0  1

This matrix class is directly compatible with OpenGL since its elements are laid out in memory exactly as they are expected by OpenGL. The matrix uses column-major format such that array indices increase down column first. Since matrix multiplication is not commutative, multiplication must be done in the correct order when combining transformations. Suppose we have a translation matrix T and a rotation matrix R. To first rotate an object around the origin and then translate it, you would multiply the two matrices as TR.

Likewise, to first translate the object and then rotate it, you would do RT. So generally, matrices must be multiplied in the reverse order in which you want the transformations to take place (this also applies to the scale, rotate, and translate methods below; these methods are convenience methods for post-multiplying by a matrix representing a scale, rotation, or translation).

Constructor & Destructor Documentation

Mat4 ( )

Default constructor.

Constructs a matrix initialized to the identity matrix:

1  0  0  0
0  1  0  0
0  0  1  0
0  0  0  1
Mat4 ( float  m11,
float  m12,
float  m13,
float  m14,
float  m21,
float  m22,
float  m23,
float  m24,
float  m31,
float  m32,
float  m33,
float  m34,
float  m41,
float  m42,
float  m43,
float  m44 
)

Constructs a matrix initialized to the specified value.

The first element of the first row. The second element of the first row. The third element of the first row. The fourth element of the first row. The first element of the second row. The second element of the second row. The third element of the second row. The fourth element of the second row. The first element of the third row. The second element of the third row. The third element of the third row. The fourth element of the third row. The first element of the fourth row. The second element of the fourth row. The third element of the fourth row. The fourth element of the fourth row.

Mat4 ( const float *  mat)

Creates a matrix initialized to the specified column-major array.

The passed-in array is in column-major order, so the memory layout of the array is as follows:

0   4   8   12
1   5   9   13
2   6   10  14
3   7   11  15

An array containing 16 elements in column-major order.

Mat4 ( const Mat4 copy)

Constructs a new matrix by copying the values from the specified matrix.

The matrix to copy.

Member Function Documentation

static void createLookAt ( const Vec3 eyePosition,
const Vec3 targetPosition,
const Vec3 up,
Mat4 dst 
)
static

Creates a view matrix based on the specified input parameters.

The eye position. The target's center position. The up vector. A matrix to store the result in.

static void createLookAt ( float  eyePositionX,
float  eyePositionY,
float  eyePositionZ,
float  targetCenterX,
float  targetCenterY,
float  targetCenterZ,
float  upX,
float  upY,
float  upZ,
Mat4 dst 
)
static

Creates a view matrix based on the specified input parameters.

The eye x-coordinate position. The eye y-coordinate position. The eye z-coordinate position. The target's center x-coordinate position. The target's center y-coordinate position. The target's center z-coordinate position. The up vector x-coordinate value. The up vector y-coordinate value. The up vector z-coordinate value. A matrix to store the result in.

static void createPerspective ( float  fieldOfView,
float  aspectRatio,
float  zNearPlane,
float  zFarPlane,
Mat4 dst 
)
static

Builds a perspective projection matrix based on a field of view and returns by value.

Projection space refers to the space after applying projection transformation from view space. After the projection transformation, visible content has x- and y-coordinates ranging from -1 to 1, and a z-coordinate ranging from 0 to 1. The field of view in the y direction (in degrees). The aspect ratio, defined as view space width divided by height. The distance to the near view plane. The distance to the far view plane. A matrix to store the result in.

static void createOrthographic ( float  width,
float  height,
float  zNearPlane,
float  zFarPlane,
Mat4 dst 
)
static

Creates an orthographic projection matrix.

The width of the view. The height of the view. The minimum z-value of the view volume. The maximum z-value of the view volume. A matrix to store the result in.

static void
createOrthographicOffCenter
( float  left,
float  right,
float  bottom,
float  top,
float  zNearPlane,
float  zFarPlane,
Mat4 dst 
)
static

Creates an orthographic projection matrix.

The minimum x-value of the view volume. The maximum x-value of the view volume. The minimum y-value of the view volume. The maximum y-value of the view volume. The minimum z-value of the view volume. The maximum z-value of the view volume. A matrix to store the result in.

static void createBillboard ( const Vec3 objectPosition,
const Vec3 cameraPosition,
const Vec3 cameraUpVector,
Mat4 dst 
)
static

Creates a spherical billboard that rotates around a specified object position.

This method computes the facing direction of the billboard from the object position and camera position. When the object and camera positions are too close, the matrix will not be accurate. To avoid this problem, this method defaults to the identity rotation if the positions are too close. (See the other overload of createBillboard for an alternative approach).

The position of the object the billboard will rotate around. The position of the camera. The up vector of the camera. A matrix to store the result in.

static void createBillboard ( const Vec3 objectPosition,
const Vec3 cameraPosition,
const Vec3 cameraUpVector,
const Vec3 cameraForwardVector,
Mat4 dst 
)
static

Creates a spherical billboard that rotates around a specified object position with provision for a safe default orientation.

This method computes the facing direction of the billboard from the object position and camera position. When the object and camera positions are too close, the matrix will not be accurate. To avoid this problem, this method uses the specified camera forward vector if the positions are too close. (See the other overload of createBillboard for an alternative approach).

The position of the object the billboard will rotate around. The position of the camera. The up vector of the camera. The forward vector of the camera, used if the positions are too close. A matrix to store the result in.

static void createScale ( const Vec3 scale,
Mat4 dst 
)
static

Creates a scale matrix.

The amount to scale. A matrix to store the result in.

static void createScale ( float  xScale,
float  yScale,
float  zScale,
Mat4 dst 
)
static

Creates a scale matrix.

The amount to scale along the x-axis. The amount to scale along the y-axis. The amount to scale along the z-axis. A matrix to store the result in.

static void createRotation ( const Quaternion quat,
Mat4 dst 
)
static

Creates a rotation matrix from the specified quaternion.

A quaternion describing a 3D orientation. A matrix to store the result in.

static void createRotation ( const Vec3 axis,
float  angle,
Mat4 dst 
)
static

Creates a rotation matrix from the specified axis and angle.

A vector describing the axis to rotate about. The angle (in radians). A matrix to store the result in.

static void createRotationX ( float  angle,
Mat4 dst 
)
static

Creates a matrix describing a rotation around the x-axis.

The angle of rotation (in radians). A matrix to store the result in.

static void createRotationY ( float  angle,
Mat4 dst 
)
static

Creates a matrix describing a rotation around the y-axis.

The angle of rotation (in radians). A matrix to store the result in.

static void createRotationZ ( float  angle,
Mat4 dst 
)
static

Creates a matrix describing a rotation around the z-axis.

The angle of rotation (in radians). A matrix to store the result in.

static void createTranslation ( const Vec3 translation,
Mat4 dst 
)
static

Creates a translation matrix.

The translation. A matrix to store the result in.

static void createTranslation ( float  xTranslation,
float  yTranslation,
float  zTranslation,
Mat4 dst 
)
static

Creates a translation matrix.

The translation on the x-axis. The translation on the y-axis. The translation on the z-axis. A matrix to store the result in.

void add ( float  scalar)

Adds a scalar value to each component of this matrix.

The scalar to add.

void add ( float  scalar,
Mat4 dst 
)

Adds a scalar value to each component of this matrix and stores the result in dst.

The scalar value to add. A matrix to store the result in.

void add ( const Mat4 mat)

Adds the specified matrix to this matrix.

The matrix to add.

static void add ( const Mat4 m1,
const Mat4 m2,
Mat4 dst 
)
static

Adds the specified matrices and stores the result in dst.

The first matrix. The second matrix. The destination matrix to add to.

bool decompose ( Vec3 scale,
Quaternion rotation,
Vec3 translation 
) const

Decomposes the scale, rotation and translation components of this matrix.

The scale. The rotation. The translation.

float determinant ( ) const

Computes the determinant of this matrix.

The determinant.

void getScale ( Vec3 scale) const

Gets the scalar component of this matrix in the specified vector.

If the scalar component of this matrix has negative parts, it is not possible to always extract the exact scalar component; instead, a scale vector that is mathematically equivalent to the original scale vector is extracted and returned.

A vector to receive the scale.

bool getRotation ( Quaternion rotation) const

Gets the rotational component of this matrix in the specified quaternion.

A quaternion to receive the rotation.

true if the rotation is successfully extracted, false otherwise.

void getTranslation ( Vec3 translation) const

Gets the translational component of this matrix in the specified vector.

A vector to receive the translation.

void getUpVector ( Vec3 dst) const

Gets the up vector of this matrix.

The destination vector.

void getDownVector ( Vec3 dst) const

Gets the down vector of this matrix.

The destination vector.

void getLeftVector ( Vec3 dst) const

Gets the left vector of this matrix.

The destination vector.

void getRightVector ( Vec3 dst) const

Gets the right vector of this matrix.

The destination vector.

void getForwardVector ( Vec3 dst) const

Gets the forward vector of this matrix.

The destination vector.

void getBackVector ( Vec3 dst) const

Gets the backward vector of this matrix.

The destination vector.

bool inverse ( )

Inverts this matrix.

true if the the matrix can be inverted, false otherwise.

bool isIdentity ( ) const

Determines if this matrix is equal to the identity matrix.

true if the matrix is an identity matrix, false otherwise.

void multiply ( float  scalar)

Multiplies the components of this matrix by the specified scalar.

The scalar value.

void multiply ( float  scalar,
Mat4 dst 
) const

Multiplies the components of this matrix by a scalar and stores the result in dst.

The scalar value. A matrix to store the result in.

static void multiply ( const Mat4 mat,
float  scalar,
Mat4 dst 
)
static

Multiplies the components of the specified matrix by a scalar and stores the result in dst.

The matrix. The scalar value. A matrix to store the result in.

void multiply ( const Mat4 mat)

Multiplies this matrix by the specified one.

The matrix to multiply.

static void multiply ( const Mat4 m1,
const Mat4 m2,
Mat4 dst 
)
static

Multiplies m1 by m2 and stores the result in dst.

The first matrix to multiply. The second matrix to multiply. A matrix to store the result in.

void rotate ( const Quaternion q)

Post-multiplies this matrix by the matrix corresponding to the specified quaternion rotation.

The quaternion to rotate by.

void rotate ( const Quaternion q,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified quaternion rotation and stores the result in dst.

The quaternion to rotate by. A matrix to store the result in.

void rotate ( const Vec3 axis,
float  angle 
)

Post-multiplies this matrix by the matrix corresponding to the specified rotation about the specified axis.

The axis to rotate about. The angle (in radians).

void rotate ( const Vec3 axis,
float  angle,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified rotation about the specified axis and stores the result in dst.

The axis to rotate about. The angle (in radians). A matrix to store the result in.

void rotateX ( float  angle)

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the x-axis.

The angle (in radians).

void rotateX ( float  angle,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the x-axis and stores the result in dst.

The angle (in radians). A matrix to store the result in.

void rotateY ( float  angle)

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the y-axis.

The angle (in radians).

void rotateY ( float  angle,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the y-axis and stores the result in dst.

The angle (in radians). A matrix to store the result in.

void rotateZ ( float  angle)

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the z-axis.

The angle (in radians).

void rotateZ ( float  angle,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified rotation around the z-axis and stores the result in dst.

The angle (in radians). A matrix to store the result in.

void scale ( float  value)

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation.

The amount to scale along all axes.

void scale ( float  value,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst.

The amount to scale along all axes. A matrix to store the result in.

void scale ( float  xScale,
float  yScale,
float  zScale 
)

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation.

The amount to scale along the x-axis. The amount to scale along the y-axis. The amount to scale along the z-axis.

void scale ( float  xScale,
float  yScale,
float  zScale,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst.

The amount to scale along the x-axis. The amount to scale along the y-axis. The amount to scale along the z-axis. A matrix to store the result in.

void scale ( const Vec3 s)

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation.

The scale values along the x, y and z axes.

void scale ( const Vec3 s,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified scale transformation and stores the result in dst.

The scale values along the x, y and z axes. A matrix to store the result in.

void set ( float  m11,
float  m12,
float  m13,
float  m14,
float  m21,
float  m22,
float  m23,
float  m24,
float  m31,
float  m32,
float  m33,
float  m34,
float  m41,
float  m42,
float  m43,
float  m44 
)

Sets the values of this matrix.

The first element of the first row. The second element of the first row. The third element of the first row. The fourth element of the first row. The first element of the second row. The second element of the second row. The third element of the second row. The fourth element of the second row. The first element of the third row. The second element of the third row. The third element of the third row. The fourth element of the third row. The first element of the fourth row. The second element of the fourth row. The third element of the fourth row. The fourth element of the fourth row.

void set ( const float *  mat)

Sets the values of this matrix to those in the specified column-major array.

An array containing 16 elements in column-major format.

void set ( const Mat4 mat)

Sets the values of this matrix to those of the specified matrix.

The source matrix.

void subtract ( const Mat4 mat)

Subtracts the specified matrix from the current matrix.

The matrix to subtract.

static void subtract ( const Mat4 m1,
const Mat4 m2,
Mat4 dst 
)
static

Subtracts the specified matrix from the current matrix.

The first matrix. The second matrix. A matrix to store the result in.

void transformPoint ( Vec3 point) const
inline

Transforms the specified point by this matrix.

The result of the transformation is stored directly into point.

The point to transform and also a vector to hold the result in.

void transformPoint ( const Vec3 point,
Vec3 dst 
) const
inline

Transforms the specified point by this matrix, and stores the result in dst.

The point to transform. A vector to store the transformed point in.

void transformVector ( Vec3 vector) const

Transforms the specified vector by this matrix by treating the fourth (w) coordinate as zero.

The result of the transformation is stored directly into vector.

The vector to transform and also a vector to hold the result in.

void transformVector ( const Vec3 vector,
Vec3 dst 
) const

Transforms the specified vector by this matrix by treating the fourth (w) coordinate as zero, and stores the result in dst.

The vector to transform. A vector to store the transformed vector in.

void transformVector ( float  x,
float  y,
float  z,
float  w,
Vec3 dst 
) const

Transforms the specified vector by this matrix.

The vector x-coordinate to transform by. The vector y-coordinate to transform by. The vector z-coordinate to transform by. The vector w-coordinate to transform by. A vector to store the transformed point in.

void transformVector ( Vec4 vector) const

Transforms the specified vector by this matrix.

The result of the transformation is stored directly into vector.

The vector to transform.

void transformVector ( const Vec4 vector,
Vec4 dst 
) const

Transforms the specified vector by this matrix.

The vector to transform. A vector to store the transformed point in.

void translate ( float  x,
float  y,
float  z 
)

Post-multiplies this matrix by the matrix corresponding to the specified translation.

The amount to translate along the x-axis. The amount to translate along the y-axis. The amount to translate along the z-axis.

void translate ( float  x,
float  y,
float  z,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified translation and stores the result in dst.

The amount to translate along the x-axis. The amount to translate along the y-axis. The amount to translate along the z-axis. A matrix to store the result in.

void translate ( const Vec3 t)

Post-multiplies this matrix by the matrix corresponding to the specified translation.

The translation values along the x, y and z axes.

void translate ( const Vec3 t,
Mat4 dst 
) const

Post-multiplies this matrix by the matrix corresponding to the specified translation and stores the result in dst.

The translation values along the x, y and z axes. A matrix to store the result in.

const Mat4 operator+ ( const Mat4 mat) const
inline

Calculates the sum of this matrix with the given matrix.

Note: this does not modify this matrix.

The matrix to add. The matrix sum.

Mat4& operator+= ( const Mat4 mat)
inline

Adds the given matrix to this matrix.

The matrix to add. This matrix, after the addition occurs.

const Mat4 operator- ( const Mat4 mat) const
inline

Calculates the difference of this matrix with the given matrix.

Note: this does not modify this matrix.

The matrix to subtract. The matrix difference.

Mat4& operator-= ( const Mat4 mat)
inline

Subtracts the given matrix from this matrix.

The matrix to subtract. This matrix, after the subtraction occurs.

const Mat4 operator- ( ) const
inline

Calculates the negation of this matrix.

Note: this does not modify this matrix.

The negation of this matrix.

const Mat4 operator* ( const Mat4 mat) const
inline

Calculates the matrix product of this matrix with the given matrix.

Note: this does not modify this matrix.

The matrix to multiply by. The matrix product.

Mat4& operator*= ( const Mat4 mat)
inline

Right-multiplies this matrix by the given matrix.

The matrix to multiply by. This matrix, after the multiplication occurs.


The documentation for this class was generated from the following file: