ilog.views.maps.defense.terrain3d.util

Class Ilv3DFloatMatrix

java.lang.Object

ilog.views.maps.defense.terrain3d.util.Ilv3DFloatMatrix

public class Ilv3DFloatMatrix
extends Object

A 4 by 4 matrix utility class to perform 3D space operations

Since:

JViews 8.1

Constructor Summary

Constructors

Constructor and Description
Ilv3DFloatMatrix() Creates a new 4 by 4 matrix filled with zeros.

Method Summary

Modifier and Type	Method and Description
float	get(int i, int j) Gets the (i,j) element of this matrix, where i is the row index and j is the column index
void	getColumnMajorData(float[] out) Copies data in column-major (OpenGL format) order into passed float array, which must have length 16 or greater.
void	getRotation(Ilv3DRotation rot) Gets the upper left 3x3 of this matrix as a rotation.Ignores translation component.
void	invertRigid() Inverts this matrix assuming that it represents a rigid transform (i.e., some combination of rotations and translations).
void	makeIdent() Makes this matrix the identity
Ilv3DFloatMatrix	mul(Ilv3DFloatMatrix b) Returns this matrix multiplied by matrix b; Creates new matrix
void	mul(Ilv3DFloatMatrix a, Ilv3DFloatMatrix b) Set this matrix equal to the product of a and b
void	set(int i, int j, float val) Sets the (i,j) element of this matrix, where i is the row index and j is the column index
void	setRotation(Ilv3DFloatVector x, Ilv3DFloatVector y, Ilv3DFloatVector z) Sets the upper-left 3x3 of this matrix assuming that the given x, y, and z vectors form an orthonormal basis
void	setRotation(Ilv3DRotation rot) Sets the rotation component of this matrix (the upper left 3 by 3 submatrix).
void	setTranslation(Ilv3DFloatVector trans) Sets the translation component of this matrix (i.e., the three top elements of the third column)
String	toString() Prints this matrix
void	xformDir(Ilv3DFloatVector src, Ilv3DFloatVector dest) Transforms src using only the upper left 3x3.
void	xformPt(Ilv3DFloatVector src, Ilv3DFloatVector dest) Transforms a 3D vector as though it had a homogeneous coordinate and assuming that this matrix represents only rigid transformations; that is, it is not a full transformation.

Methods inherited from class java.lang.Object

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

Constructor Detail

Ilv3DFloatMatrix

public Ilv3DFloatMatrix()

Creates a new 4 by 4 matrix filled with zeros.

Method Detail

makeIdent

public void makeIdent()

Makes this matrix the identity

get

public final float get(int i,
                       int j)

Gets the (i,j) element of this matrix, where i is the row index and j is the column index

Parameters:

i - row index

j - column index

Returns:

the matrix element

set

public final void set(int i,
                      int j,
                      float val)

Sets the (i,j) element of this matrix, where i is the row index and j is the column index

Parameters:

i - row index

j - column index

val - the matrix element

setTranslation

public final void setTranslation(Ilv3DFloatVector trans)

Sets the translation component of this matrix (i.e., the three top elements of the third column)

Parameters:

trans - The vector containing the translation coordinates.

setRotation

public final void setRotation(Ilv3DRotation rot)

Sets the rotation component of this matrix (the upper left 3 by 3 submatrix).

Parameters:

rot - The rotation to set.

setRotation

public final void setRotation(Ilv3DFloatVector x,
                              Ilv3DFloatVector y,
                              Ilv3DFloatVector z)

Sets the upper-left 3x3 of this matrix assuming that the given x, y, and z vectors form an orthonormal basis

Parameters:

x - X Vector.

y - Y Vector.

z - Z Vector.

getRotation

public void getRotation(Ilv3DRotation rot)

Gets the upper left 3x3 of this matrix as a rotation.Ignores translation component.

Parameters:

rot - The Rotf instance to hold the result.

invertRigid

public void invertRigid()

Inverts this matrix assuming that it represents a rigid transform (i.e., some combination of rotations and translations). Assumes column vectors.

mul

public Ilv3DFloatMatrix mul(Ilv3DFloatMatrix b)

Returns this matrix multiplied by matrix b; Creates new matrix

Parameters:

b - The matrix to multiply.

Returns:

a The new multiplied matrix.

mul

public void mul(Ilv3DFloatMatrix a,
                Ilv3DFloatMatrix b)

Set this matrix equal to the product of a and b

Parameters:

a - The first matrix.

b - The second matrix.

xformPt

public void xformPt(Ilv3DFloatVector src,
                    Ilv3DFloatVector dest)

Transforms a 3D vector as though it had a homogeneous coordinate and assuming that this matrix represents only rigid transformations; that is, it is not a full transformation. NOTE: src and dest must be different vectors.

Parameters:

src - The vector to multiply.

dest - The vector to store the result.

xformDir

public void xformDir(Ilv3DFloatVector src,
                     Ilv3DFloatVector dest)

Transforms src using only the upper left 3x3. NOTE: src and dest must be different vectors.

Parameters:

src - The vector to multiply.

dest - The vector to store the result.

getColumnMajorData

public void getColumnMajorData(float[] out)

Copies data in column-major (OpenGL format) order into passed float array, which must have length 16 or greater.

Parameters:

out - The float array containing the matrix elements

toString

public String toString()

Prints this matrix

Overrides:

toString in class Object