nova.core.util.math

Class MatrixStack

java.lang.Object

nova.core.util.math.MatrixStack

All Implemented Interfaces:

Transformer

public class MatrixStack
extends java.lang.Object
implements Transformer

Constructor Summary

Constructors

Constructor and Description
MatrixStack() Creates new MatrixStack.
MatrixStack(MatrixStack clone) Clone construcotr of MatrixStack
MatrixStack(org.apache.commons.math3.linear.RealMatrix current) Creates new MatrixStack with starting matrix.

Method Summary

Modifier and Type	Method and Description
org.apache.commons.math3.geometry.euclidean.threed.Vector3D	apply(org.apache.commons.math3.geometry.euclidean.threed.Vector3D vec) Called to transform a vector.
org.apache.commons.math3.linear.RealMatrix	getMatrix() Exposes current transformation matrix.
void	loadIdentity() Replaces current transformation matrix by an identity matrix.
MatrixStack	loadMatrix(org.apache.commons.math3.linear.RealMatrix matrix) Replaces current transformation matrix by an identity current.
MatrixStack	popMatrix() Pops matrix from stack.
MatrixStack	pushMatrix() Pushes matrix onto the stack.
MatrixStack	rotate(org.apache.commons.math3.geometry.euclidean.threed.Rotation rotation) Rotates the current matrix
MatrixStack	rotate(org.apache.commons.math3.geometry.euclidean.threed.Vector3D rotateVector, double angle) Rotates transformation matrix around rotateVector axis by angle radians.
MatrixStack	scale(double x, double y, double z) Scales current transformation matrix.
MatrixStack	scale(org.apache.commons.math3.geometry.euclidean.threed.Vector3D scaleVector) Scales current transformation matrix.
MatrixStack	transform(org.apache.commons.math3.linear.RealMatrix matrix) Transforms current matrix with give matrix.
MatrixStack	translate(double x, double y, double z) Translates current transformation matrix.
MatrixStack	translate(org.apache.commons.math3.geometry.euclidean.threed.Vector3D translateVector) Translates current transformation matrix.

Methods inherited from class java.lang.Object

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

Constructor Detail

MatrixStack

public MatrixStack()

Creates new MatrixStack. Constains no transfomation base matrix.

MatrixStack

public MatrixStack(MatrixStack clone)

Clone construcotr of MatrixStack

Parameters:

clone - instance to be cloned

MatrixStack

public MatrixStack(org.apache.commons.math3.linear.RealMatrix current)

Creates new MatrixStack with starting matrix.

Parameters:

current - Transforation matrix to start from.

Method Detail

loadIdentity

public void loadIdentity()

Replaces current transformation matrix by an identity matrix.

loadMatrix

public MatrixStack loadMatrix(org.apache.commons.math3.linear.RealMatrix matrix)

Replaces current transformation matrix by an identity current.

Parameters:

matrix - The new matrix to use.

Returns:

this for chaining.

getMatrix

public org.apache.commons.math3.linear.RealMatrix getMatrix()

Exposes current transformation matrix.

Returns:

current transformation matrix.

transform

public MatrixStack transform(org.apache.commons.math3.linear.RealMatrix matrix)

Transforms current matrix with give matrix.

Parameters:

matrix - to transform current matrix.

Returns:

The transformed matrix

translate

public MatrixStack translate(double x,
                             double y,
                             double z)

Translates current transformation matrix.

Parameters:

x - translation.

y - translation.

z - translation.

Returns:

The tranlated matrix

translate

public MatrixStack translate(org.apache.commons.math3.geometry.euclidean.threed.Vector3D translateVector)

Translates current transformation matrix.

Parameters:

translateVector - vector of translation.

Returns:

The tranformed matrix

rotate

public MatrixStack rotate(org.apache.commons.math3.geometry.euclidean.threed.Rotation rotation)

Rotates the current matrix

Parameters:

rotation - The rotation to aply

Returns:

The rorated matrix

rotate

public MatrixStack rotate(org.apache.commons.math3.geometry.euclidean.threed.Vector3D rotateVector,
                          double angle)

Rotates transformation matrix around rotateVector axis by angle radians.

Parameters:

rotateVector - Vector serving as rotation axis.

angle - in radians.

Returns:

The rotated matrix

scale

public MatrixStack scale(double x,
                         double y,
                         double z)

Scales current transformation matrix.

Parameters:

x - scale.

y - scale.

z - scale.

Returns:

this for chaining.

scale

public MatrixStack scale(org.apache.commons.math3.geometry.euclidean.threed.Vector3D scaleVector)

Scales current transformation matrix.

Parameters:

scaleVector - scale vector.

Returns:

The current matrix

pushMatrix

public MatrixStack pushMatrix()

Pushes matrix onto the stack. Use it to save current state of MatrixStack in case of branching transformations.

Returns:

this for chaining.

popMatrix

public MatrixStack popMatrix()

Pops matrix from stack. Use it to restore saved transformation.

Returns:

this for chaining.

apply

public org.apache.commons.math3.geometry.euclidean.threed.Vector3D apply(org.apache.commons.math3.geometry.euclidean.threed.Vector3D vec)

Called to transform a vector.

Specified by:

apply in interface Transformer

Parameters:

vec - - The vector being transformed

Returns:

The transformed vector by current matrix.