com.simplifiedlogic.nitro.util

Class JLMatrixMaker

java.lang.Object

com.simplifiedlogic.nitro.util.JLMatrixMaker

public class JLMatrixMaker
extends java.lang.Object

Utility class for creating JLMatrix and JLTransform objects

Constructor Summary

Constructors

Constructor and Description
JLMatrixMaker()

Method Summary

Methods

Modifier and Type	Method and Description
static JLMatrix	create(CallMatrix3D matrix) Create a JLMatrix from a Creo Matrix3D object
static JLMatrix	create(CallTransform3D trans) Create a JLMatrix from a Creo Transform3D object
static JLMatrix	create(JLTransform xf) Create a JLMatrix from a JShell JLTransform object
static double	degreesToRadians(double degrees) Convert degrees to radians
static void	dot(JLMatrix m1, JLMatrix m2) Perform a dot-product of two matrices.
static CallMatrix3D	export(JLMatrix m) Create a Creo Matrix3D object from a JLMatrix
static void	init(JLMatrix m) Initialize a JLMatrix to an origin matrix
static void	print(JLMatrix m) Print out a matrix (for debugging)
static double	radiansToDegrees(double radians) Convert radians to degrees
static void	rotateX(JLMatrix old, double angle) Rotate a matrix on the X axis
static void	rotateY(JLMatrix old, double angle) Rotate a matrix on the Y axis
static void	rotateZ(JLMatrix old, double angle) Rotate a matrix on the Z axis
static void	setOrigin(JLMatrix m, double x, double y, double z) Set the Origin of a matrix
static void	setXVector(JLMatrix m, double x, double y, double z) Set the X-Vector of a matrix
static void	setYVector(JLMatrix m, double x, double y, double z) Set the Y-Vector of a matrix
static void	setZVector(JLMatrix m, double x, double y, double z) Set the Z-Vector of a matrix
static void	showTransform(CallTransform3D trans) Print out a Creo Transform3D object (for debugging)
static JLInertia	writeInertia(CallInertia inertia) Convert a Creo Inertia object to a JLInertia
static JLTransform	writeTransformTable(CallTransform3D featTrans) Convert a Creo Transform3D object to a JLTransform
static JLTransform	writeTransformTable(JLMatrix m) Convert a JLMatrix to a JLTransform

Methods inherited from class java.lang.Object

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

Constructor Detail

JLMatrixMaker

public JLMatrixMaker()

Method Detail

create

public static JLMatrix create(CallMatrix3D matrix)
                       throws JLIException

Create a JLMatrix from a Creo Matrix3D object

Parameters:

matrix - The Creo matrix

Returns:

The resulting JShell matrix

Throws:

JLIException

create

public static JLMatrix create(CallTransform3D trans)
                       throws JLIException

Create a JLMatrix from a Creo Transform3D object

Parameters:

trans - The Creo transform

Returns:

The resulting JShell matrix

Throws:

JLIException

create

public static JLMatrix create(JLTransform xf)
                       throws JLIException

Create a JLMatrix from a JShell JLTransform object

Parameters:

xf - The JShell transform object

Returns:

The resulting JShell matrix

Throws:

JLIException

init

public static void init(JLMatrix m)

Initialize a JLMatrix to an origin matrix

Parameters:

m - The matrix to initialize

export

public static CallMatrix3D export(JLMatrix m)
                           throws com.ptc.cipjava.jxthrowable

Create a Creo Matrix3D object from a JLMatrix

Parameters:

m - The JShell matrix to export

Returns:

The resulting Creo matrix

Throws:

com.ptc.cipjava.jxthrowable

setXVector

public static void setXVector(JLMatrix m,
              double x,
              double y,
              double z)

Set the X-Vector of a matrix

Parameters:

m - The JShell matrix to update

x - Vector's X coordinate

y - Vector's Y coordinate

z - Vector's Z coordinate

setYVector

public static void setYVector(JLMatrix m,
              double x,
              double y,
              double z)

Set the Y-Vector of a matrix

Parameters:

m - The JShell matrix to update

x - Vector's X coordinate

y - Vector's Y coordinate

z - Vector's Z coordinate

setZVector

public static void setZVector(JLMatrix m,
              double x,
              double y,
              double z)

Set the Z-Vector of a matrix

Parameters:

m - The JShell matrix to update

x - Vector's X coordinate

y - Vector's Y coordinate

z - Vector's Z coordinate

setOrigin

public static void setOrigin(JLMatrix m,
             double x,
             double y,
             double z)

Set the Origin of a matrix

Parameters:

m - The JShell matrix to update

x - Origin's X coordinate

y - Origin's Y coordinate

z - Origin's Z coordinate

dot

public static void dot(JLMatrix m1,
       JLMatrix m2)

Perform a dot-product of two matrices. The first matrix will be updated with the result

Parameters:

m1 - The first matrix. This one will be updated.

m2 - The second matrix. This one will NOT be updated.

rotateX

public static void rotateX(JLMatrix old,
           double angle)

Rotate a matrix on the X axis

 x-axis rotation:
 [  1       0       0     ]
 [  0       cos(a)  sin(a)]
 [  0      -sin(a)  cos(a)]
 

Parameters:

old - The matrix to update

angle - The angle to rotate, in radians

rotateY

public static void rotateY(JLMatrix old,
           double angle)

Rotate a matrix on the Y axis

 y-axis rotation:
 [  cos(a)  0      -sin(a)]
 [  0       1       0     ]
 [  sin(a)  0       cos(a)]
 

Parameters:

old - The matrix to update

angle - The angle to rotate, in radians

rotateZ

public static void rotateZ(JLMatrix old,
           double angle)

Rotate a matrix on the Z axis

 z-axis rotation:
 [  cos(a)  sin(a)  0     ]
 [ -sin(a)  cos(a)  0     ]
 [  0       0       1     ]
 

Parameters:

old - The matrix to update

angle - The angle to rotate, in radians

degreesToRadians

public static double degreesToRadians(double degrees)

Convert degrees to radians

Parameters:

degrees - An angle in degrees

Returns:

An angle in radians

radiansToDegrees

public static double radiansToDegrees(double radians)

Convert radians to degrees

Parameters:

radians - An angle in radians

Returns:

An angle in degrees

print

public static void print(JLMatrix m)

Print out a matrix (for debugging)

Parameters:

m - The matrix to print

writeTransformTable

public static JLTransform writeTransformTable(JLMatrix m)
                                       throws JLIException

Convert a JLMatrix to a JLTransform

Parameters:

m - The JShell matrix to convert

Returns:

The JShell transform created

Throws:

JLIException

writeTransformTable

public static JLTransform writeTransformTable(CallTransform3D featTrans)
                                       throws JLIException

Convert a Creo Transform3D object to a JLTransform

Parameters:

featTrans - The Creo transform

Returns:

The JShell transform created

Throws:

JLIException

writeInertia

public static JLInertia writeInertia(CallInertia inertia)
                              throws com.ptc.cipjava.jxthrowable

Convert a Creo Inertia object to a JLInertia

Parameters:

inertia - The Creo inertia object

Returns:

The JShell inertia object created

Throws:

com.ptc.cipjava.jxthrowable

showTransform

public static void showTransform(CallTransform3D trans)
                          throws com.ptc.cipjava.jxthrowable

Print out a Creo Transform3D object (for debugging)

Parameters:

trans - The Creo transform to print

Throws:

com.ptc.cipjava.jxthrowable