`unreal.RigUnit_SetTransformItemArray`¶

class unreal.RigUnit_SetTransformItemArray(execute_context: ControlRigExecuteContext = [], items: None = [], space: RigVMTransformSpace = Ellipsis, initial: bool = False, transforms: None = [], weight: float = 0.0, propagate_to_children: bool = False)¶

Bases: RigUnitMutable

SetTransformArray is used to set an array of transforms on the hierarchy.

Note: For Controls when setting the initial transform this node actually sets the Control’s offset transform and resets the local values to (0, 0, 0).

C++ Source:

Plugin: ControlRig
Module: ControlRig
File: RigUnit_SetTransform.h

Editor Properties: (see get_editor_property/set_editor_property)

execute_context (ControlRigExecuteContext): [Read-Write] * This property is used to chain multiple mutable units together
initial (bool): [Read-Write] Defines if the transform should be set as current (false) or initial (true). Initial transforms for bones and other elements in the hierarchy represent the reference pose’s value.
items (Array[RigElementKey]): [Read-Write] The item to set the transform for
propagate_to_children (bool): [Read-Write] If set to true children of affected items in the hierarchy will follow the transform change - otherwise only the parent will move.
space (RigVMTransformSpace): [Read-Write] Defines if the transform should be set in local or global space
transforms (Array[Transform]): [Read-Write] The new transform of the given item
weight (float): [Read-Write] Defines how much the change will be applied

property initial: bool¶

[Read-Write] Defines if the transform should be set as current (false) or initial (true). Initial transforms for bones and other elements in the hierarchy represent the reference pose’s value.