aim_matrix

Orients a transform matrix so that its specified primary and secondary axes points toward specified primary and secondary targets.

Inputs

transform

The double4x4 transform matrix to solve.

enable

Process this node if enabled. Else, skip any computation and outputs the input transforms as it is.

weight

The weight to control this node's influence on the transform.

A value of 0.0 pass the transform unchanged, 1.0 fully applies the node's effect, and any value between 0.0 and 1.0 blends between the input and modified transform.

primary_mode

The method to handle the aiming of the input transform's primary_input_axis.

• None uses axis as-is, unaffected by the target.
• Aim orients axis using the target's position.
• Align orients axis using only the target's orientation. This requires the primary_target_vector to be set in order to define the target's axis on which to align.

primary_input_axis

The axis of the input transform to aim toward the primary target.

primary_target_vector

The primary target vector, in the space of primary_target_matrix, used to direct the primary_input_axis of the input transform toward the primary target. The interpretation of this vector depends on the selected primary_mode:

• Aim applies a position offset over the primary_target_matrix. Together, they define the final position toward which the primary_input_axis should aim.
• Align specifies the local vector of the primary_target_matrix to which the primary_input_axis should be aligned.

primary_target_matrix

The transform matrix representing the position of the primary target. Only the translation part of the matrix is used to deduce the aim vector.

secondary_mode

The method to handle the aiming of the input transform's secondary_input_axis.

• None uses axis as-is, unaffected by the target.
• Aim orients axis using the target's position.
• Align orients axis using the target's orientation. This requires the secondary_target_vector to be set in order to define the target's axis on which to align.

secondary_input_axis

The axis of the input transform to aim toward the secondary target.

secondary_target_vector

The secondary target vector, in the space of secondary_target_matrix, used to direct the secondary_input_axis of the input transform toward the secondary target. The interpretation of this vector depends on the selected primary_mode:

• Aim applies a position offset over the secondary_target_matrix. Together, they define the final position toward which the secondary_input_axis should aim.
• Align specifies the local vector of the secondary_target_matrix to which the secondary_input_axis should be aligned.

secondary_target_matrix

The transform matrix representing the position of the secondary target. Only the translation part of the matrix is used to deduce the aim vector.

Outputs

out_transform

The solved transform.