com.jme.math
Class TransformMatrixQuat

java.lang.Object
  com.jme.math.TransformMatrixQuat

public class TransformMatrixQuat

extends java.lang.Object

Started Date: Jul 16, 2004

Same as TransformMatrix, but stores rotations as quats, not Matrix3f. This is faster for interpolation, but slower than a matrix using Matrix3f for rotation when doing point translation.

Author:

Jack Lindamood

Constructor Summary

TransformMatrixQuat()

Method Summary

void	applyToSpatial(Spatial spatial) Applies the values of this matrix to the given Spatial.
TransformMatrixQuat	combineWithParent(TransformMatrixQuat parent) Changes the values of this matrix acording to it's parent.
Quaternion	getRotation() Return the rotation quaternion in this matrix.
Quaternion	getRotation(Quaternion quat) Stores this rotation value into the given Quaternion.
Vector3f	getScale() Return the scale vector in this matrix.
Vector3f	getScale(Vector3f scale) Stores this scale value into the given vector3f.
Vector3f	getTranslation() Return the translation vector in this matrix.
Vector3f	getTranslation(Vector3f trans) Stores this translation value into the given vector3f.
void	interpolateTransforms(TransformMatrixQuat t1, TransformMatrixQuat t2, float delta) Sets this matrix to the interpolation between the first matrix and the second by delta amount.
void	loadIdentity() Loads the identity.
void	set(TransformMatrixQuat matrixQuat) Sets this matrix to be equal to the given matrix.
void	setRotationQuaternion(Quaternion rot) Sets this rotation to the given Quaternion value.
void	setScale(float x, float y, float z) Sets this matrix's scale to the given x,y,z values.
void	setScale(Vector3f scale) Sets this scale to the given value.
void	setTranslation(float x, float y, float z) Sets this matrix's translation to the given x,y,z values.
void	setTranslation(Vector3f trans) Sets this translation to the given value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransformMatrixQuat

public TransformMatrixQuat()

Method Detail

setRotationQuaternion

public void setRotationQuaternion(Quaternion rot)

Sets this rotation to the given Quaternion value.

Parameters:

rot - The new rotation for this matrix.

setTranslation

public void setTranslation(Vector3f trans)

Sets this translation to the given value.

Parameters:

trans - The new translation for this matrix.

getTranslation

public Vector3f getTranslation()

Return the translation vector in this matrix.

Returns:

translation vector.

setScale

public void setScale(Vector3f scale)

Sets this scale to the given value.

Parameters:

scale - The new scale for this matrix.

getScale

public Vector3f getScale()

Return the scale vector in this matrix.

Returns:

scale vector.

getTranslation

public Vector3f getTranslation(Vector3f trans)

Stores this translation value into the given vector3f. If trans is null, a new vector3f is created to hold the value. The value, once stored, is returned.

Parameters:

trans - The store location for this matrix's translation.

Returns:

The value of this matrix's translation.

getRotation

public Quaternion getRotation(Quaternion quat)

Stores this rotation value into the given Quaternion. If quat is null, a new Quaternion is created to hold the value. The value, once stored, is returned.

Parameters:

quat - The store location for this matrix's rotation.

Returns:

The value of this matrix's rotation.

getRotation

public Quaternion getRotation()

Return the rotation quaternion in this matrix.

Returns:

rotation quaternion.

getScale

public Vector3f getScale(Vector3f scale)

Stores this scale value into the given vector3f. If scale is null, a new vector3f is created to hold the value. The value, once stored, is returned.

Parameters:

scale - The store location for this matrix's scale.

Returns:

The value of this matrix's scale.

interpolateTransforms

public void interpolateTransforms(TransformMatrixQuat t1,
                                  TransformMatrixQuat t2,
                                  float delta)

Sets this matrix to the interpolation between the first matrix and the second by delta amount.

Parameters:

t1 - The begining transform.

t2 - The ending transform.

delta - An amount between 0 and 1 representing how far to interpolate from t1 to t2.

combineWithParent

public TransformMatrixQuat combineWithParent(TransformMatrixQuat parent)

Changes the values of this matrix acording to it's parent. Very similar to the concept of Node/Spatial transforms.

Parameters:

parent - The parent matrix.

Returns:

This matrix, after combining.

applyToSpatial

public void applyToSpatial(Spatial spatial)

Applies the values of this matrix to the given Spatial.

Parameters:

spatial - The spatial to be affected by this matrix.

setTranslation

public void setTranslation(float x,
                           float y,
                           float z)

Sets this matrix's translation to the given x,y,z values.

Parameters:

x - This matrix's new x translation.

y - This matrix's new y translation.

z - This matrix's new z translation.

setScale

public void setScale(float x,
                     float y,
                     float z)

Sets this matrix's scale to the given x,y,z values.

Parameters:

x - This matrix's new x scale.

y - This matrix's new y scale.

z - This matrix's new z scale.

loadIdentity

public void loadIdentity()

Loads the identity. Equal to translation=1,1,1 scale=0,0,0 rot=0,0,0,1.

set

public void set(TransformMatrixQuat matrixQuat)

Sets this matrix to be equal to the given matrix.

Parameters:

matrixQuat - The matrix to be equal to.