com.aspose.threed

Class TransformBuilder

java.lang.Object

com.aspose.threed.TransformBuilder

public class TransformBuilder
extends java.lang.Object

The TransformBuilder is used to build transform matrix by a chain of transformations. Example: The following code shows how to create a matrix by a set of operation

     TransformBuilder tb = new TransformBuilder();
     tb.translate(10, 20, 0);
     tb.scale(10, 10, 10);
     tb.rotateEulerDegree(90, 0, 0);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

Constructor Summary

Constructors

Constructor and Description
TransformBuilder() Construct a TransformBuilder with initial identity transform matrix and specified compose order
TransformBuilder(ComposeOrder order) Construct a TransformBuilder with initial identity transform matrix and specified compose order
TransformBuilder(Matrix4 initial, ComposeOrder order) Construct a TransformBuilder with initial transform matrix and specified compose order

Method Summary

Modifier and Type	Method and Description
TransformBuilder	append(Matrix4 m) Append the new transform matrix to the transform chain.
void	compose(Matrix4 m) Append or prepend the argument to internal matrix.
ComposeOrder	getComposeOrder() Gets the chain compose order.
Matrix4	getMatrix() Gets the current matrix value
TransformBuilder	prepend(Matrix4 m) Prepend the new transform matrix to the transform chain.
TransformBuilder	rearrange(Axis newX, Axis newY, Axis newZ) Rearrange the layout of the axis.
void	reset() Reset the transform to identity matrix
TransformBuilder	rotate(Quaternion q) Chain a rotation by a quaternion Example:
TransformBuilder	rotateDegree(double angle, Vector3 axis) Chain a rotation transform in degree
void	rotateDegree(Vector3 rot, RotationOrder order) Append rotation with specified order
TransformBuilder	rotateEulerDegree(double degX, double degY, double degZ) Chain a rotation by Euler angles in degree Example:
TransformBuilder	rotateEulerRadian(double x, double y, double z) Chain a rotation by Euler angles in radian Example:
TransformBuilder	rotateEulerRadian(Vector3 r) Chain a rotation by Euler angles in radian Example:
TransformBuilder	rotateRadian(double angle, Vector3 axis) Chain a rotation transform in radian
void	rotateRadian(Vector3 rot, RotationOrder order) Append rotation with specified order
TransformBuilder	scale(double s) Chain a scaling transform matrix with a component scaled by s Example:
TransformBuilder	scale(double x, double y, double z) Chain a scaling transform matrix Example:
TransformBuilder	scale(Vector3 s) Chain a scale transform Example:
void	setComposeOrder(ComposeOrder value) Sets the chain compose order.
void	setMatrix(Matrix4 value) Sets the current matrix value
TransformBuilder	translate(double tx, double ty, double tz) Chain a translation transform Example:
TransformBuilder	translate(Vector3 v) Chain a translation transform Example:

Methods inherited from class java.lang.Object

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

Constructor Detail

TransformBuilder

public TransformBuilder(Matrix4 initial,
                        ComposeOrder order)

Construct a TransformBuilder with initial transform matrix and specified compose order

TransformBuilder

public TransformBuilder(ComposeOrder order)

Construct a TransformBuilder with initial identity transform matrix and specified compose order

TransformBuilder

public TransformBuilder()

Construct a TransformBuilder with initial identity transform matrix and specified compose order

Method Detail

getMatrix

public Matrix4 getMatrix()

Gets the current matrix value

Returns:

the current matrix value

setMatrix

public void setMatrix(Matrix4 value)

Sets the current matrix value

Parameters:

value - New value

getComposeOrder

public ComposeOrder getComposeOrder()

Gets the chain compose order.

Returns:

the chain compose order.

setComposeOrder

public void setComposeOrder(ComposeOrder value)

Sets the chain compose order.

Parameters:

value - New value

compose

public void compose(Matrix4 m)

Append or prepend the argument to internal matrix.

append

public TransformBuilder append(Matrix4 m)

Append the new transform matrix to the transform chain.

prepend

public TransformBuilder prepend(Matrix4 m)

Prepend the new transform matrix to the transform chain.

rearrange

public TransformBuilder rearrange(Axis newX,
                                  Axis newY,
                                  Axis newZ)

Rearrange the layout of the axis.

Parameters:

newX - The new x component source

newY - The new y component source

newZ - The new z component source

scale

public TransformBuilder scale(double s)

Chain a scaling transform matrix with a component scaled by s Example:

     TransformBuilder tb = new TransformBuilder();
     tb.scale(10);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

scale

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

Chain a scaling transform matrix Example:

     TransformBuilder tb = new TransformBuilder();
     tb.scale(10, 10, 10);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

scale

public TransformBuilder scale(Vector3 s)

Chain a scale transform Example:

     TransformBuilder tb = new TransformBuilder();
     tb.scale(new Vector3(10, 10, 10));
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotateDegree

public TransformBuilder rotateDegree(double angle,
                                     Vector3 axis)

Chain a rotation transform in degree

Parameters:

angle - The angle to rotate in degree

axis - The axis to rotate Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateDegree(90, Vector3.getUnitY());
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotateRadian

public TransformBuilder rotateRadian(double angle,
                                     Vector3 axis)

Chain a rotation transform in radian

Parameters:

angle - The angle to rotate in radian

axis - The axis to rotate Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateRadian(Math.PI, Vector3.getUnitY());
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotate

public TransformBuilder rotate(Quaternion q)

Chain a rotation by a quaternion Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotate(Quaternion.fromEulerAngle(0, Math.PI, 0));
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotateEulerDegree

public TransformBuilder rotateEulerDegree(double degX,
                                          double degY,
                                          double degZ)

Chain a rotation by Euler angles in degree Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateEulerDegree(0, 90, 0);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotateEulerRadian

public TransformBuilder rotateEulerRadian(double x,
                                          double y,
                                          double z)

Chain a rotation by Euler angles in radian Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateEulerRadian(0, Math.PI, 0);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

rotateEulerRadian

public TransformBuilder rotateEulerRadian(Vector3 r)

Chain a rotation by Euler angles in radian Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateEulerRadian(new Vector3(0, Math.PI, 0));
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

translate

public TransformBuilder translate(double tx,
                                  double ty,
                                  double tz)

Chain a translation transform Example:

     TransformBuilder tb = new TransformBuilder();
     tb.translate(0, 10, 0);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

translate

public TransformBuilder translate(Vector3 v)

Chain a translation transform Example:

     TransformBuilder tb = new TransformBuilder();
     tb.translate(new Vector3(0, 10, 0));
     System.out.printf("Transform Matrix: %s", tb.getMatrix());
 

reset

public void reset()

Reset the transform to identity matrix

rotateDegree

public void rotateDegree(Vector3 rot,
                         RotationOrder order)

Append rotation with specified order

Parameters:

rot - Rotation in degrees

rotateRadian

public void rotateRadian(Vector3 rot,
                         RotationOrder order)

Append rotation with specified order

Parameters:

rot - Rotation in radian Example:

     TransformBuilder tb = new TransformBuilder();
     tb.rotateRadian(new Vector3(0.3, 0.4, 0.1), RotationOrder.YZX);
     System.out.printf("Transform Matrix: %s", tb.getMatrix());