TransformBuilder allows for the creation of complex transformations by combining translation and rotation operations. These operations can be chained together to create composite transformations.

It is important to note that chaining transformations makes it so that the subsequent transformations are applied as if looking from the rotation of the previous transformation, not from the world graph. For example, if you rotate 180 degrees around the y-axis, then move +1 meter along the z-axis, the resulting world position will be (0, 0, -1) instead of (0, 0, 1).

Example usage:

val pose = TransformBuilder().move(1f, 2f, 3f).then(TransformBuilder().rotateX(90f)).build()

Signature

class TransformBuilder

Constructors

TransformBuilder ()

Signature

constructor()

Returns

TransformBuilder

Methods

build ()	Builds the final Transform from the configured transformation steps. Signature fun build(): Transform Returns `Transform` A Transform object representing the composite transformation Throws `NullPointerException` if no transformation steps have been added
cosDegrees ( angleInDegrees )	Helper function that calculates the cosine of an angle specified in degrees. Signature fun cosDegrees(angleInDegrees: Float): Float Parameters `angleInDegrees: Float` The angle in degrees Returns `Float` The cosine value of the angle
degreesToRadians ( angleInDegrees )	Helper function that converts an angle from degrees to radians. Signature fun degreesToRadians(angleInDegrees: Float): Float Parameters `angleInDegrees: Float` The angle in degrees Returns `Float` The equivalent angle in radians
move ( x , y , z )	Creates a translation transformation. It is important to note that the translation is applied as if looking from the rotation of the previous TransformBuilder transformation, not from the world graph. For example, if you had rotated 180 degrees around the y-axis, the applied this transformation to move with z=1, the resulting world position will be (0, 0, -1) instead of (0, 0, 1). Signature fun move(x: Float = 0.0f, y: Float = 0.0f, z: Float = 0.0f): TransformBuilder.TransformStepBuilder Parameters `x: Float` The translation distance along the X axis `y: Float` The translation distance along the Y axis `z: Float` The translation distance along the Z axis Returns `TransformBuilder.TransformStepBuilder` A TransformStepBuilder that can be used to chain additional transformations
rotate_x ( angleInDegrees )	Helper function that creates a quaternion representing a rotation around the X axis. Signature fun rotate_x(angleInDegrees: Float): Quaternion Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `Quaternion` A Quaternion representing the rotation
rotate_y ( angleInDegrees )	Helper function that creates a quaternion representing a rotation around the Y axis. Signature fun rotate_y(angleInDegrees: Float): Quaternion Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `Quaternion` A Quaternion representing the rotation
rotate_z ( angleInDegrees )	Helper function that creates a quaternion representing a rotation around the Z axis. Signature fun rotate_z(angleInDegrees: Float): Quaternion Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `Quaternion` A Quaternion representing the rotation
rotateX ( angleInDegrees )	Creates a rotation transformation around the X axis. Note that the rotation is applied as if looking from the rotation of the previous transformation, so if you rotated 180 degrees around the x-axis, then applied this transformation to rotate 90 degrees around the x-axis, the resulting world rotation will be 270 degrees around the x-axis Signature fun rotateX(angleInDegrees: Float): TransformBuilder.TransformStepBuilder Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `TransformBuilder.TransformStepBuilder` A TransformStepBuilder that can be used to chain additional transformations
rotateY ( angleInDegrees )	Creates a rotation transformation around the Y axis. Note that the rotation is applied as if looking from the rotation of the previous transformation, so if you rotated 180 degrees around the y-axis, then applied this transformation to rotate 90 degrees around the y-axis, the resulting world rotation will be 270 degrees around the y-axis Signature fun rotateY(angleInDegrees: Float): TransformBuilder.TransformStepBuilder Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `TransformBuilder.TransformStepBuilder` A TransformStepBuilder that can be used to chain additional transformations
rotateZ ( angleInDegrees )	Creates a rotation transformation around the Z axis. Note that the rotation is applied as if looking from the rotation of the previous transformation, so if you rotated 180 degrees around the z-axis, then applied this transformation to rotate 90 degrees around the z-axis, the resulting world rotation will be 270 degrees around the z-axis Signature fun rotateZ(angleInDegrees: Float): TransformBuilder.TransformStepBuilder Parameters `angleInDegrees: Float` The rotation angle in degrees Returns `TransformBuilder.TransformStepBuilder` A TransformStepBuilder that can be used to chain additional transformations
sinDegrees ( angleInDegrees )	Helper function that calculates the sine of an angle specified in degrees. Signature fun sinDegrees(angleInDegrees: Float): Float Parameters `angleInDegrees: Float` The angle in degrees Returns `Float` The sine value of the angle

Inner Class

TransformStepBuilder Class

Modifiers: final

A builder class for chaining transformation steps. This is as a helper class for TransformBuilder. Use the TransformBuilder to create your transforms

This class allows for the composition of multiple transformations through chaining.

Signature

class TransformStepBuilder(var value: Pose? = null, var root: TransformBuilder, var left: TransformBuilder.TransformStepBuilder? = null, var right: TransformBuilder.TransformStepBuilder? = null)

Constructors

TransformStepBuilder ( value , root , left , right )

Signature

constructor(value: Pose? = null, root: TransformBuilder, left: TransformBuilder.TransformStepBuilder? = null, right: TransformBuilder.TransformStepBuilder? = null)

Parameters

value: Pose?

root: TransformBuilder

left: TransformBuilder.TransformStepBuilder?

right: TransformBuilder.TransformStepBuilder?

Returns

TransformBuilder.TransformStepBuilder

Properties

left : TransformBuilder.TransformStepBuilder? [Get][Set]	Signature var left: TransformBuilder.TransformStepBuilder?
right : TransformBuilder.TransformStepBuilder? [Get][Set]	Signature var right: TransformBuilder.TransformStepBuilder?
root : TransformBuilder [Get][Set]	Signature var root: TransformBuilder
value : Pose? [Get][Set]	Signature var value: Pose?

Methods

build ()	Builds the final Pose from the transformation steps. Signature fun build(): Pose Returns `Pose` A Pose object representing the composite transformation
then ( nextStep )	Chains this transformation step with another transformation step. Signature infix fun then(nextStep: TransformBuilder.TransformStepBuilder): TransformBuilder.TransformStepBuilder Parameters `nextStep: TransformBuilder.TransformStepBuilder` The next transformation step to apply Returns `TransformBuilder.TransformStepBuilder` A new TransformStepBuilder representing the combined transformation