## net.rim.device.api.math Class Matrix4f

```java.lang.Object
net.rim.device.api.math.Matrix4f
```

`public class Matrix4fextends Object`

A 4 by 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, martices must be multiplied in the reverse order in which you want the transformations to take place.

Passing a matrix to OpenGL is a simple and efficient operation since the underlying array for the matrix is stored in a format that is directly compatible with OpenGL.

```   `// Create a matrix to translate by (10, 2, -20)`
Matrix translation = `new` Matrix();
translation.set(1, 0, 0, 10,
0, 1, 0, 2,
0, 0, 1, -20,
0, 0, 0, 1 );

`// Pass our matrix to OpenGL`

Since:
BlackBerry API 5.0.0

Constructor Summary
`Matrix4f()`
Constructs a matrix initialized to the identity matrix.
```Matrix4f(float m00, float m01, float m02, float m03, float m10, float m11, float m12, float m13, float m20, float m21, float m22, float m23, float m30, float m31, float m32, float m33)```
Constructs a matrix initialized to the specified values.
`Matrix4f(float[] m)`
Constructs a matrix initialized to the specified column-major array.
`Matrix4f(Matrix4f m)`
Constructs a new matrix by copying the values from the specified matrix.

Method Summary
` void` `add(float scalar)`
Adds a scalar value to each component of this matrix.
` void` ```add(float scalar, Matrix4f dst)```
Adds a scalar value to this matrix and stores the result in dst.
` void` `add(Matrix4f m)`
Adds the specified matrix to this matrix.
`static void` ```add(Matrix4f m1, Matrix4f m2, Matrix4f dst)```
Adds the specified matrices and stores the result in `dst`.
`static void` ```createLookAt(Vector3f cameraPos, Vector3f cameraTarget, Vector3f cameraUpVector, Matrix4f dst)```
Creates a view matrix based on the specified input parameters.
`static void` ```createRotation(Quaternion4f quat, Matrix4f dst)```
Creates a rotation matrix from the specified quaternion.
`static void` ```createRotation(Vector3f axis, float angle, Matrix4f dst)```
Creates a rotation matrix from the specified axis and angle.
`static void` ```createRotationX(float angle, Matrix4f dst)```
Creates a matrix describing a rotation around the x-axis.
`static void` ```createRotationY(float angle, Matrix4f dst)```
Creates a matrix describing a rotation around the y-axis.
`static void` ```createRotationZ(float angle, Matrix4f dst)```
Creates a matrix describing a rotation around the z-axis.
`static void` ```createScale(float xScale, float yScale, float zScale, Matrix4f dst)```
Creates a scale matrix.
`static void` ```createTranslation(float xTrans, float yTrans, float zTrans, Matrix4f dst)```
Creates a translation matrix.
` boolean` ```decompose(Vector3f scale, Quaternion4f rotation, Vector3f translation)```
Decomposes the scale, rotation and translation components of this matrix.
` float` `determinant()`
Computes the determinant of this matrix.
` boolean` `equals(Object obj)`
Determines if this matrix is equal to the specified object.
` boolean` `equals(Matrix4f m)`
Determines if this matrix is equal to the specified one.
` void` `get(float[] m)`
Copies the values of this matrix into the given array in column-major order.
` float` `get(int index)`
Gets the matrix element at the specified position.
` float` ```get(int row, int column)```
Gets the matrix element at the specified row and column.
` float[]` `getArray()`
Returns the underlying array for this matrix in column-major order.
` void` ```getColumn(int column, float[] v)```
Stores the four elements of the specified column into `v`.
` void` ```getColumn(int column, Vector3f v)```
Stores the first three elements of the specified column into `v`.
` boolean` `getRotation(Quaternion4f rotation)`
Stores the rotational component of this matrix in the specified quaternion.
` void` ```getRow(int row, float[] v)```
Stores the four elements of the specified row into `v`.
` void` ```getRow(int row, Vector3f v)```
Stores the first three elements of the specified row into `v`.
` void` `getScale(Vector3f scale)`
Stores the scalar component of this matrix in the specified vector.
` void` `getTranslation(Vector3f translation)`
Stores the translational component of this matrix in the specified vector.
` int` `hashCode()`
Returns the hash code of the matrix, based on the values stored in it.
` boolean` `invert()`
Inverts this matrix.
` boolean` `invert(Matrix4f dst)`
Inverts this matrix and stores the result in dst.
` boolean` `isIdentity()`
Determines if this matrix is equal to the identity matrix.
` void` `multiply(float scalar)`
Multiplies the components of this matrix by the specified scalar.
` void` ```multiply(float scalar, Matrix4f dst)```
Multiplies the components of this matrix by a scalar and stores the result in dst.
` void` `multiply(Matrix4f m)`
Multiplies this matrix by the specified one.
`static void` ```multiply(Matrix4f m1, Matrix4f m2, Matrix4f dst)```
Multiplies m1 by m2 and stores the result in dst.
` void` `negate()`
Negates this matrix.
` void` `negate(Matrix4f dst)`
Stores the negate of this matrix in dst.
` void` `rotate(Quaternion4f q)`
Rotates this matrix by the specified quaternon.
` void` ```rotate(Quaternion4f q, Matrix4f dst)```
Rotates this matrix by the specified quaternion and stores the result in `dst`.
` void` ```rotate(Vector3f axis, float angle)```
Rotates this matrix about the specified axis.
` void` ```rotate(Vector3f axis, float angle, Matrix4f dst)```
Rotates this matrix about the specified axis and stores the result in `dst`.
` void` `rotateX(float angle)`
Rotates this matrix by the specified amount around the x-axis.
` void` ```rotateX(float angle, Matrix4f dst)```
Rotates this matrix by the specified amount around the x-axis and stores the result in `dst`.
` void` `rotateY(float angle)`
Rotates this matrix by the specified amount around the y-axis.
` void` ```rotateY(float angle, Matrix4f dst)```
Rotates this matrix by the specified amount around the y-axis and stores the result in `dst`.
` void` `rotateZ(float angle)`
Rotates this matrix by the specified amount around the z-axis.
` void` ```rotateZ(float angle, Matrix4f dst)```
Rotates this matrix by the specified amount around the z-axis and stores the result in `dst`.
` void` `scale(float value)`
Scales this matrix by the specified amount along all axes.
` void` ```scale(float xScale, float yScale, float zScale)```
Scales this matrix by the specified amounts along each axis.
` void` ```scale(float xScale, float yScale, float zScale, Matrix4f dst)```
Scales this matrix by the specified amounts along each axis and stores the result in `dst`.
` void` ```scale(float value, Matrix4f dst)```
Scales this matrix by the specified amount along all axes and stores the result in `dst`.
` void` ```set(float m00, float m01, float m02, float m03, float m10, float m11, float m12, float m13, float m20, float m21, float m22, float m23, float m30, float m31, float m32, float m33)```
Sets the values of this matrix.
` void` `set(float[] m)`
Sets the values of this matrix to those in the specified column-major array.
` void` ```set(int index, float value)```
Sets the specified element of this matrix to the specified value.
` void` ```set(int row, int column, float value)```
Sets the specified element of this matrix to the specified value.
` void` `set(Matrix4f m)`
Sets the values of this matrix to those of the specified matrix.
` void` `setIdentity()`
Sets this matrix to the identity matrix.
` void` `setZero()`
Sets all elements of the current matrix to zero.
` void` `subtract(Matrix4f m)`
Subtracts the specified matrix from the current matrix.
`static void` ```subtract(Matrix4f m1, Matrix4f m2, Matrix4f dst)```
Subtracts the specified matrices and stores the result in `dst`.
` String` `toString()`
Returns a string representation of this matrix.
` void` `transformNormal(Vector3f normal)`
Transforms the specified normal vector by this matrix by treating the fourth (w) coordinate as zero.
` void` ```transformNormal(Vector3f normal, Vector3f dst)```
Transforms the specified normal vector by this matrix by treating the fourth (w) coordinate as zero, and stores the result in `dst`.
` void` `transformPoint(Vector3f point)`
Transforms the specified vector that represents a point by this matrix by treating the fourth (w) coordinate as one.
` void` ```transformPoint(Vector3f point, Vector3f dst)```
Transforms the specified vector that represents a point by this matrix by treating the fourth (w) coordinate as one, and stores the result in `dst`.
` void` ```translate(float x, float y, float z)```
Translates this matrix by the specified values.
` void` ```translate(float x, float y, float z, Matrix4f dst)```
Translates this matrix by the specified values and stores the result in `dst`.
` void` `transpose()`
Transposes this matrix.
` void` `transpose(Matrix4f dst)`
Stores the transpose of this matrix in `dst`.

Methods inherited from class java.lang.Object
`getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### Matrix4f

`public Matrix4f()`
Constructs a matrix initialized to the identity matrix.

Since:
BlackBerry API 5.0.0

### Matrix4f

`public Matrix4f(float[] m)`
Constructs 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
```

Parameters:
`m` - a 16-element array, stored in column-major order
Since:
BlackBerry API 5.0.0

### Matrix4f

```public Matrix4f(float m00,
float m01,
float m02,
float m03,
float m10,
float m11,
float m12,
float m13,
float m20,
float m21,
float m22,
float m23,
float m30,
float m31,
float m32,
float m33)```
Constructs a matrix initialized to the specified values.

Parameters:
`m00` - the first element of the first row
`m01` - the second element of the first row
`m02` - the third element of the first row
`m03` - the fourth element of the first row
`m10` - the first element of the second row
`m11` - the second element of the second row
`m12` - the third element of the second row
`m13` - the fourth element of the second row
`m20` - the first element of the third row
`m21` - the second element of the third row
`m22` - the third element of the third row
`m23` - the fourth element of the third row
`m30` - the first element of the fourth row
`m31` - the second element of the fourth row
`m32` - the third element of the fourth row
`m33` - the fourth element of the fourth row
Since:
BlackBerry API 5.0.0

### Matrix4f

`public Matrix4f(Matrix4f m)`
Constructs a new matrix by copying the values from the specified matrix.

Parameters:
`m` - the source matrix
Since:
BlackBerry API 5.0.0

Method Detail

`public final void add(float scalar)`
Adds a scalar value to each component of this matrix.

Parameters:
`scalar` - the scalar to add
Since:
BlackBerry API 5.0.0

```public final void add(float scalar,
Matrix4f dst)```
Adds a scalar value to this matrix and stores the result in dst.

Parameters:
`scalar` - the scalar value to add
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

`public final void add(Matrix4f m)`
Adds the specified matrix to this matrix.

Parameters:
`m` - the matrix to add
Since:
BlackBerry API 5.0.0

```public static void add(Matrix4f m1,
Matrix4f m2,
Matrix4f dst)```
Adds the specified matrices and stores the result in `dst`.

Parameters:
`m1` - the first matrix
`m2` - the second matrix
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### decompose

```public final boolean decompose(Vector3f scale,
Quaternion4f rotation,
Vector3f translation)```
Decomposes the scale, rotation and translation components of this matrix.

Parameters:
`scale` - a vector to store the decomposed scale values in
`rotation` - a quaternion to store the decomposed rotation in
`translation` - a vector to store the decomposed translation in
Returns:
true if the the matrix can be decomposed, false otherwise
Since:
BlackBerry API 5.0.0

### determinant

`public final float determinant()`
Computes the determinant of this matrix.

Returns:
the determinant
Since:
BlackBerry API 5.0.0

### equals

`public boolean equals(Object obj)`
Determines if this matrix is equal to the specified object.

Overrides:
`equals` in class `Object`
Parameters:
`obj` - the matrix to compare
Returns:
true if the specified object is of type Matrix4f and if all members of it are equal those of this matrix
`Boolean.hashCode()`, `Hashtable`
Since:
BlackBerry API 5.0.0

### equals

`public boolean equals(Matrix4f m)`
Determines if this matrix is equal to the specified one.

Parameters:
`m` - the matrix to compare
Returns:
true if all components of the specified matrix are equal to those of this matrix
Since:
BlackBerry API 5.0.0

### get

`public final void get(float[] m)`
Copies the values of this matrix into the given array in column-major order.

Parameters:
`m` - a 16-element array to populate with the values from this matrix
Since:
BlackBerry API 5.0.0

### get

`public final float get(int index)`
Gets the matrix element at the specified position.

This method indexes the internal array in column-major order. See the description of this class for more information on this topic.

Parameters:
`index` - the zero-based index of the element to retrieve
Returns:
the value of the specified element.
Since:
BlackBerry API 5.0.0

### get

```public final float get(int row,
int column)```
Gets the matrix element at the specified row and column.

Parameters:
`row` - the zero-based row of the element to retrieve
`column` - the zero-based column of the element to retrieve
Returns:
the value of the specified element.
Since:
BlackBerry API 5.0.0

### getArray

`public final float[] getArray()`
Returns the underlying array for this matrix in column-major order.

The returned array is in column-major order and therefore compatible with systems such as OpenGL that expect data in this order. The memory layout of the array is therefore as follows:

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

Note that modifying the elements of the returned array will modify the matrix itself.

Returns:
the internal array in column-major order
Since:
BlackBerry API 5.0.0

### getColumn

```public final void getColumn(int column,
float[] v)```
Stores the four elements of the specified column into `v`.

Parameters:
`column` - the index of the column to retrieve (zero-based)
`v` - a four-element array to store the column in
Since:
BlackBerry API 5.0.0

### getColumn

```public final void getColumn(int column,
Vector3f v)```
Stores the first three elements of the specified column into `v`.

Parameters:
`column` - the index of the column to retrieve (zero-based)
`v` - a vector to store the column in
Since:
BlackBerry API 5.0.0

### getRotation

`public final boolean getRotation(Quaternion4f rotation)`
Stores the rotational component of this matrix in the specified quaternion.

Parameters:
`rotation` - a quaternion to receive the rotation
Returns:
true if the rotation is successfully extracted, false otherwise
Since:
BlackBerry API 5.0.0

### getRow

```public final void getRow(int row,
float[] v)```
Stores the four elements of the specified row into `v`.

Parameters:
`row` - the index of the row to retrieve (zero-based)
`v` - a four-element array to store the row in
Since:
BlackBerry API 5.0.0

### getRow

```public final void getRow(int row,
Vector3f v)```
Stores the first three elements of the specified row into `v`.

Parameters:
`row` - the index of the row to retrieve (zero-based)
`v` - a vector to store the row in
Since:
BlackBerry API 5.0.0

### getScale

`public final void getScale(Vector3f scale)`
Stores the scalar component of this matrix in the specified vector.

Parameters:
`scale` - a vector to receive the scale
Since:
BlackBerry API 5.0.0

### getTranslation

`public final void getTranslation(Vector3f translation)`
Stores the translational component of this matrix in the specified vector.

Parameters:
`translation` - a vector to receive the translation
Since:
BlackBerry API 5.0.0

### hashCode

`public int hashCode()`
Returns the hash code of the matrix, based on the values stored in it.

Overrides:
`hashCode` in class `Object`
Returns:
the hash code
`Object.equals(java.lang.Object)`, `Hashtable`
Since:
BlackBerry API 5.0.0

### invert

`public final boolean invert()`
Inverts this matrix.

Returns:
true if the the matrix can be inverted, false otherwise
Since:
BlackBerry API 5.0.0

### invert

`public final boolean invert(Matrix4f dst)`
Inverts this matrix and stores the result in dst.

Parameters:
`dst` - a matrix to store the invert of this matrix in
Returns:
true if the the matrix can be inverted, false otherwise
Since:
BlackBerry API 5.0.0

### isIdentity

`public final boolean isIdentity()`
Determines if this matrix is equal to the identity matrix.

Returns:
true or false
Since:
BlackBerry API 5.0.0

### multiply

`public final void multiply(float scalar)`
Multiplies the components of this matrix by the specified scalar.

Parameters:
`scalar` - the scalar value
Since:
BlackBerry API 5.0.0

### multiply

```public final void multiply(float scalar,
Matrix4f dst)```
Multiplies the components of this matrix by a scalar and stores the result in dst.

Parameters:
`scalar` - the scalar value
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### multiply

`public final void multiply(Matrix4f m)`
Multiplies this matrix by the specified one.

Parameters:
`m` - the matrix to multiply
Since:
BlackBerry API 5.0.0

### multiply

```public static void multiply(Matrix4f m1,
Matrix4f m2,
Matrix4f dst)```
Multiplies m1 by m2 and stores the result in dst.

Parameters:
`m1` - the first matrix to multiply
`m2` - the second matrix to multiply
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### negate

`public final void negate()`
Negates this matrix.

Since:
BlackBerry API 5.0.0

### negate

`public final void negate(Matrix4f dst)`
Stores the negate of this matrix in dst.

Parameters:
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### rotate

`public final void rotate(Quaternion4f q)`
Rotates this matrix by the specified quaternon.

Parameters:
`q` - the quaternion to rotate by
Since:
BlackBerry API 5.0.0

### rotate

```public final void rotate(Quaternion4f q,
Matrix4f dst)```
Rotates this matrix by the specified quaternion and stores the result in `dst`.

Parameters:
`q` - the quaternion to rotate by
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### rotate

```public final void rotate(Vector3f axis,
float angle)```
Rotates this matrix about the specified axis.

Parameters:
`axis` - the axis to rotate about
`angle` - the angle, in radians
Since:
BlackBerry API 5.0.0

### rotate

```public final void rotate(Vector3f axis,
float angle,
Matrix4f dst)```
Rotates this matrix about the specified axis and stores the result in `dst`.

Parameters:
`axis` - the axis to rotate about
`angle` - the angle, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### rotateX

`public final void rotateX(float angle)`
Rotates this matrix by the specified amount around the x-axis.

Parameters:
`angle` - the angle to rotate by, in radians
Since:
BlackBerry API 5.0.0

### rotateX

```public final void rotateX(float angle,
Matrix4f dst)```
Rotates this matrix by the specified amount around the x-axis and stores the result in `dst`.

Parameters:
`angle` - the angle to rotate by, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### rotateY

`public final void rotateY(float angle)`
Rotates this matrix by the specified amount around the y-axis.

Parameters:
`angle` - the angle to rotate by, in radians
Since:
BlackBerry API 5.0.0

### rotateY

```public final void rotateY(float angle,
Matrix4f dst)```
Rotates this matrix by the specified amount around the y-axis and stores the result in `dst`.

Parameters:
`angle` - the angle to rotate by, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### rotateZ

`public final void rotateZ(float angle)`
Rotates this matrix by the specified amount around the z-axis.

Parameters:
`angle` - the angle to rotate by, in radians
Since:
BlackBerry API 5.0.0

### rotateZ

```public final void rotateZ(float angle,
Matrix4f dst)```
Rotates this matrix by the specified amount around the z-axis and stores the result in `dst`.

Parameters:
`angle` - the angle to rotate by, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### scale

`public final void scale(float value)`
Scales this matrix by the specified amount along all axes.

Parameters:
`value` - the amount to scale this matrix by
Since:
BlackBerry API 5.0.0

### scale

```public final void scale(float value,
Matrix4f dst)```
Scales this matrix by the specified amount along all axes and stores the result in `dst`.

Parameters:
`value` - the amount to scale the matrix by
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### scale

```public final void scale(float xScale,
float yScale,
float zScale)```
Scales this matrix by the specified amounts along each axis.

Parameters:
`xScale` - the amount to scale along the x-axis
`yScale` - the amount to scale along the y-axis
`zScale` - the amount to scale along the z-axis
Since:
BlackBerry API 5.0.0

### scale

```public final void scale(float xScale,
float yScale,
float zScale,
Matrix4f dst)```
Scales this matrix by the specified amounts along each axis and stores the result in `dst`.

Parameters:
`xScale` - the amount to scale along the x-axis
`yScale` - the amount to scale along the y-axis
`zScale` - the amount to scale along the z-axis
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### set

`public final void set(float[] m)`
Sets the values of this matrix to those in the specified column-major array.

Parameters:
`m` - a 16-element array, stored in column-major format
Since:
BlackBerry API 5.0.0

### set

```public final void set(float m00,
float m01,
float m02,
float m03,
float m10,
float m11,
float m12,
float m13,
float m20,
float m21,
float m22,
float m23,
float m30,
float m31,
float m32,
float m33)```
Sets the values of this matrix.

Parameters:
`m00` - the first element of the first row
`m01` - the second element of the first row
`m02` - the third element of the first row
`m03` - the fourth element of the first row
`m10` - the first element of the second row
`m11` - the second element of the second row
`m12` - the third element of the second row
`m13` - the fourth element of the second row
`m20` - the first element of the third row
`m21` - the second element of the third row
`m22` - the third element of the third row
`m23` - the fourth element of the third row
`m30` - the first element of the fourth row
`m31` - the second element of the fourth row
`m32` - the third element of the fourth row
`m33` - the fourth element of the fourth row
Since:
BlackBerry API 5.0.0

### set

`public final void set(Matrix4f m)`
Sets the values of this matrix to those of the specified matrix.

Parameters:
`m` - the source matrix
Since:
BlackBerry API 5.0.0

### set

```public final void set(int index,
float value)```
Sets the specified element of this matrix to the specified value.

Parameters:
`index` - the index of the element to set (0-15)
`value` - the value to set
Since:
BlackBerry API 5.0.0

### set

```public final void set(int row,
int column,
float value)```
Sets the specified element of this matrix to the specified value.

Parameters:
`row` - the row of the element (0-3)
`column` - the column of the element (0-3)
`value` - the value to set
Since:
BlackBerry API 5.0.0

### setIdentity

`public final void setIdentity()`
Sets this matrix to the identity matrix.

Since:
BlackBerry API 5.0.0

### setZero

`public final void setZero()`
Sets all elements of the current matrix to zero.

Since:
BlackBerry API 5.0.0

### subtract

`public final void subtract(Matrix4f m)`
Subtracts the specified matrix from the current matrix.

Parameters:
`m` - the matrix to subtract
Since:
BlackBerry API 5.0.0

### subtract

```public static void subtract(Matrix4f m1,
Matrix4f m2,
Matrix4f dst)```
Subtracts the specified matrices and stores the result in `dst`.

Parameters:
`m1` - the first matrix
`m2` - the second matrix
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### transformNormal

`public final void transformNormal(Vector3f normal)`
Transforms the specified normal vector by this matrix by treating the fourth (w) coordinate as zero.

The result of the transformation is stored directly into `normal`.

Parameters:
`normal` - the normal vector to transform
Since:
BlackBerry API 5.0.0

### transformNormal

```public final void transformNormal(Vector3f normal,
Vector3f dst)```
Transforms the specified normal vector by this matrix by treating the fourth (w) coordinate as zero, and stores the result in `dst`.

Parameters:
`normal` - the normal vector to transform
`dst` - a vector to store the transformed normal in
Since:
BlackBerry API 5.0.0

### transformPoint

`public final void transformPoint(Vector3f point)`
Transforms the specified vector that represents a point by this matrix by treating the fourth (w) coordinate as one.

The result of the transformation is stored directly into `point`.

Parameters:
`point` - the point to transform
Since:
BlackBerry API 5.0.0

### transformPoint

```public final void transformPoint(Vector3f point,
Vector3f dst)```
Transforms the specified vector that represents a point by this matrix by treating the fourth (w) coordinate as one, and stores the result in `dst`.

Parameters:
`point` - the point to transform
`dst` - a vector to store the transformed point in
Since:
BlackBerry API 5.0.0

### translate

```public final void translate(float x,
float y,
float z)```
Translates this matrix by the specified values.

Parameters:
`x` - amount to translate along the x-axis
`y` - amount to translate along the y-axis
`z` - amount to translate along the z-axis
Since:
BlackBerry API 5.0.0

### translate

```public final void translate(float x,
float y,
float z,
Matrix4f dst)```
Translates this matrix by the specified values and stores the result in `dst`.

Parameters:
`x` - amount to translate along the x-axis
`y` - amount to translate along the y-axis
`z` - amount to translate along the z-axis
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### transpose

`public final void transpose()`
Transposes this matrix.

Since:
BlackBerry API 5.0.0

### transpose

`public final void transpose(Matrix4f dst)`
Stores the transpose of this matrix in `dst`.

Parameters:
`dst` - a matrix to store the transpose in
Since:
BlackBerry API 5.0.0

### toString

`public String toString()`
Returns a string representation of this matrix.

Overrides:
`toString` in class `Object`
Returns:
a string containing the elements of the matrix
Since:
BlackBerry API 5.0.0

### createScale

```public static void createScale(float xScale,
float yScale,
float zScale,
Matrix4f dst)```
Creates a scale matrix.

Parameters:
`xScale` - the scale on the x-axis
`yScale` - the scale on the y-axis
`zScale` - the scale on the z-axis
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createTranslation

```public static void createTranslation(float xTrans,
float yTrans,
float zTrans,
Matrix4f dst)```
Creates a translation matrix.

Parameters:
`xTrans` - the translation on the x-axis
`yTrans` - the translation on the y-axis
`zTrans` - the translation on the z-axis
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createRotation

```public static void createRotation(Quaternion4f quat,
Matrix4f dst)```
Creates a rotation matrix from the specified quaternion.

Parameters:
`quat` - a quaternion describing a 3D orientation
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createRotation

```public static void createRotation(Vector3f axis,
float angle,
Matrix4f dst)```
Creates a rotation matrix from the specified axis and angle.

Parameters:
`axis` - a vector describing the axis to rotate about
`angle` - the angle, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createRotationX

```public static void createRotationX(float angle,
Matrix4f dst)```
Creates a matrix describing a rotation around the x-axis.

Parameters:
`angle` - the angle of rotation, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createRotationY

```public static void createRotationY(float angle,
Matrix4f dst)```
Creates a matrix describing a rotation around the y-axis.

Parameters:
`angle` - the angle of rotation, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createRotationZ

```public static void createRotationZ(float angle,
Matrix4f dst)```
Creates a matrix describing a rotation around the z-axis.

Parameters:
`angle` - the angle of rotation, in radians
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0

### createLookAt

```public static void createLookAt(Vector3f cameraPos,
Vector3f cameraTarget,
Vector3f cameraUpVector,
Matrix4f dst)```
Creates a view matrix based on the specified input parameters.

Parameters:
`cameraPos` - the position of the camera
`cameraTarget` - the position of the target that the camera is pointing at
`cameraUpVector` - a vector describing the "up" direction of the camera
`dst` - a matrix to store the result in
Since:
BlackBerry API 5.0.0