Pose(bpy_struct)#
base class — bpy_struct
- class bpy.types.Pose(bpy_struct)#
A collection of pose channels, including settings for animating bones
- bones#
Individual pose bones for the armature
- Type:
bpy_prop_collection
ofPoseBone
, (readonly)
- ik_solver#
Selection of IK solver for IK chain
LEGACY
Standard – Original IK solver.ITASC
iTaSC – Multi constraint, stateful IK solver.
- Type:
enum in [‘LEGACY’, ‘ITASC’], default ‘LEGACY’
- use_auto_ik#
Add temporary IK constraints while grabbing bones in Pose Mode
- Type:
boolean, default False
- use_mirror_relative#
Apply relative transformations in X-mirror mode (not supported with Auto IK)
- Type:
boolean, default False
- use_mirror_x#
Apply changes to matching bone on opposite side of X-Axis
- Type:
boolean, default False
- classmethod apply_pose_from_action(action, evaluation_time=0.0)#
Apply the given action to this pose by evaluating it at a specific time. Only updates the pose of selected bones, or all bones if none are selected.
- Parameters:
action (
Action
) – Action, The Action containing the poseevaluation_time (float in [-inf, inf], (optional)) – Evaluation Time, Time at which the given action is evaluated to obtain the pose
- classmethod blend_pose_from_action(action, blend_factor=1.0, evaluation_time=0.0)#
Blend the given action into this pose by evaluating it at a specific time. Only updates the pose of selected bones, or all bones if none are selected.
- Parameters:
action (
Action
) – Action, The Action containing the poseblend_factor (float in [0, 1], (optional)) – Blend Factor, How much the given Action affects the final pose
evaluation_time (float in [-inf, inf], (optional)) – Evaluation Time, Time at which the given action is evaluated to obtain the pose
- classmethod backup_create(action)#
Create a backup of the current pose. Only those bones that are animated in the Action are backed up. The object owns the backup, and each object can have only one backup at a time. When you no longer need it, it must be freed use backup_clear().
- Parameters:
action (
Action
) – Action, An Action with animation data for the bones. Only the animated bones will be included in the backup.
- classmethod backup_restore()#
Restore the previously made pose backup. This can be called multiple times. See Pose.backup_create() for more info.
- Returns:
True when the backup was restored, False if there was no backup to restore
- Return type:
boolean
- classmethod backup_clear()#
Free a previously made pose backup. See Pose.backup_create() for more info.
- classmethod bl_rna_get_subclass(id, default=None)#
- Parameters:
id (string) – The RNA type identifier.
- Returns:
The RNA type or default when not found.
- Return type:
bpy.types.Struct
subclass
- classmethod bl_rna_get_subclass_py(id, default=None)#
- Parameters:
id (string) – The RNA type identifier.
- Returns:
The class or default when not found.
- Return type:
type