Quaternion In

“Quaternion In” node constructs quaternions based on various input components provided for a selected mode.

Modes

The available Modes are: WXYZ, SCALAR-VECTOR, EULER, AXIS-ANGLE & MATRIX.

Mode	Description
WXYZ	Converts W, X, Y, Z components into a quaternion. [1]
SCALAR-VECTOR	Converts Scalar & Vector components into a quaternion. [1]
EULER	Converts X, Y, Z Euler angles and an order of rotation into a quaternion. [2,3]
AXIS-ANGLE	Converts an Axis & an Angle of rotation into a quaternion. [2]
MATRIX	Converts an orthogonal 4x4 rotation matrix into a quaternion.

Notes:

• [1] : For WXYZ and SCALAR-VECTOR modes the node provides a “Normalize” option to generate a normalized quaternion. All the other modes automatically generate a normalized quaternion.

• [2] : For EULER and AXIS-ANGLE modes (which take angle input) the node provides an angle unit conversion to let the angle values be converted to Radians (0.0-2pi), Degrees (0.0-360.0) or Unities (0.0-1.0 range).

• [3] : For EULER mode the node provides the option to select the Euler rotation order:

  • XYZ

  • XZY

  • YXZ

  • YZX

  • ZXY

  • ZYX

The modes WXYZ and SCALAR-VECTOR are the same except the WXYZ provides 4 floats (W, X, Y and Z) to generate the quaternion, while SCALAR-VECTOR provides a scalar (W) and a vector (X, Y, Z).

Inputs

The node takes a list of various components, based on the selected mode, and it constructs the corresponding quaternions. The node is vectorized so the inputs take a value or a list of values. When multiple lists are connected the node will extend the length of the connected input lists to match the longest one before computing the list of output quaternions.

Based on the selected Mode the node makes available the corresponding input sockets:

Mode	Input Sockets (types)
WXYZ	W, X, Y, Z (floats)
SCALAR-VECTOR	Scalar (float) & Vector (vector)
EULER	X, Y, Z angles (floats) [1]
AXIS-ANGLE	Axis (vector) & Angle (float) [1]
MATRIX	Matrix (4x4 matrix)

Notes:

• [1] : The angles are by default in DEGREES. The Property Panel has option to set angle units as: RADIANS, DEGREES or UNITIES.

Extra Parameters

A set of extra parameters are available on the property panel. These parameters do not receive external input.

Extra Param	Type	Default	Description
Angle Units	Enum RADIANS DEGREES UNITIES	DEGREES	Interprets the angle values based on the selected angle units: Radians = 0.0 - 2pi Degrees = 0.0 - 360.0 Unities = 0.0 - 1.0

Outputs

Quaternions

The node outputs a list of one or more quaternions based on the given input.

The node only generates the quaternions when the output socket is connected.