Orientation
Converts between different representations of orientation, stored as primitive variables on an object. Supported representations include euler angles, quaternions, axis-angle form, aim vectors and matrices.
Typically used to prepare points for instancing, as the Instancer node requires orientation to be provided as a quaternion, but it is often more convenient to prepare orientations in another representation.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
out
The processed output scene.
enabled
The on/off state of the node. When it is off, the node outputs the input scene unchanged.
in
The input scene
filter
The filter used to control which parts of the scene are processed. A Filter node should be connected here.
inMode
The method used to define the input orientations.
deleteInputs
Deletes the input primitive variables, so that they are not present on the output object.
inEuler
Name of the primitive variable that defines the input orientation as euler angles, measured in degrees. This variable should contain V3fVectorData.
inOrder
The rotation order of the input euler angles.
inQuaternion
Name of the primitive variable that defines the input orientation as quaternions. This variable should contain QuatfVectorData.
inAxis
Name of the primitive variable that defines the axis component of the input orientations. This variable should contain V3fVectorData.
inAngle
Name of the primitive variable that defines the angle component of the input orientations. This variable should contain FloatVectorData.
inXAxis
Name of the primitive variable that defines the direction in which the X axis will be aimed. This variable should contain V3fVectorData.
inYAxis
Name of the primitive variable that defines the direction in which the Y axis will be aimed. This variable should contain V3fVectorData.
inZAxis
Name of the primitive variable that defines the direction in which the Z axis will be aimed. This variable should contain V3fVectorData.
inMatrix
Name of the primitive variable that defines the input orientations as a matrix. This variable should contain M33fVectorData.
randomEnabled
Enables randomisation of the orientations. Randomisation is applied as a pre-transform of the input orientation.
randomAxis
A reference axis which the randomisation is specified relative to. Typically this would be the primary axis of the model being instanced.
randomSpread
Applies a random rotation away from the axis, specified in degrees. The maximum spread of 180 degrees gives a uniform randomisation over all possible directions.
randomTwist
Applies a random rotation around the axis, specified in degrees.
randomSpace
The space in which the randomisation is specified. This defines how it is combined with the input orientations.
Local : The randomisation is specified in local space and is therefore post-multiplied onto the input orientations. When using the Instancer, this is equivalent to randomising the prototypes before they are instanced.
Parent : The transformation is specified in parent space and is therefore pre-multiplied onto the input orientations. When using the Instancer, this is equivalent to randomising the instances after they are positioned.
outMode
The method used to define the output orientations. When creating orientations for the Instancer, the Quaternion mode should be used.
outEuler
Name of the primitive variable that will be created to store the output orientations as euler angles, measured in degrees.
outOrder
The rotation order of the output euler angles.
outQuaternion
Name of the primitive variable that will be created to store the output orientations as quaternions.
outAxis
Name of the primitive variable that will be created to store the axis component of the output orientation.
outAngle
Name of the primitive variable that will be created to store the angle component of the output orientation.
outXAxis
Name of the primitive variable that will be created to store the x-axis aim vector of the output orientation.
outYAxis
Name of the primitive variable that will be created to store the y-axis aim vector of the output orientation.
outZAxis
Name of the primitive variable that will be created to store the z-axis aim vector of the output orientation.
outMatrix
Name of the primitive variable that will be created to store the output orientations as matrices. The matrices will be stored as M33fVectorData.