Pivot Messages

Action Messages

• PIVOT_MOVE_WORLDSPACE - Moves the pivot of the given objects by x, y, z (given in worldspace). If no objects are specified, then the currently selected objects are modified. This message is undoable and broadcastable.

  Parameters:

  • x (float) - Amount to move pivot by in the x direction.

  • y (float) - Amount to move pivot by in the y direction.

  • z (float) - Amount to move pivot by in the z direction.

  • relative (bool) - True to move the target pivots relatively, False to move them absolutely.

  • target1, ..., targetN (tuple) - The IDs of objects to move pivots.

• PIVOT_RESET_TO_ORIGINAL - Resets the pivot to its original value (as it came from the file). This message is undoable and broadcastable.

  Parameters:

  • target1, ..., targetN (tuple) - The IDs of objects that will be reset.

• PIVOT_ROTATE_AXIS - Rotate the given pivot axis by a given rotation angle. This message is undoable and broadcastable.

  Parameters:

  • angle (float) - Rotation angle.

  • axis (unicode) - Which axis: X, Y or Z.

  • target1, ..., targetN (tuple) - Tuple of node ids to be modified.

• PIVOT_SET_AXIS - Set the pivot axis. This message is undoable and broadcastable.

  Parameters:

  • target1, ..., targetN (tuple) - Tuple of node ids to be modified.

  • x (tuple) - x-axis.

  • y (tuple) - y-axis.

  • z (tuple) - z-axis.

Information Messages

• PIVOT_MOVE_WORLDSPACE_DONE - Indicates which object's pivots have been translated by the PIVOT_MOVE_WORLDSPACE message.

  Parameters:

  • target1, ..., targetN (tuple) - The IDs of objects that had pivots translated.

• PIVOT_ROTATE_AXIS_DONE - Indicates that the pivot rotate axis has been completed.

  Parameters:

  • angle (float) - Rotation angle.

  • axis (unicode) - Which axis: X, Y or Z.

  • target1, ..., targetN (tuple) - Tuple of node ids to be modified.

• PIVOT_SET_AXIS_DONE - Indicates that the pivot axis has been changed.

  Parameters:

  • target1, ..., targetN (tuple) - Tuple of node ids that were modified.

  • x (tuple) - x-axis.

  • y (tuple) - y-axis.

  • z (tuple) - z-axis.