ActionConstraint(Constraint)

base classes — bpy_struct, Constraint

class bpy.types.ActionConstraint(Constraint)

Map an action to the transform axes of a bone

action

The constraining action

Type:

Action

action_slot

The slot identifies which sub-set of the Action is considered to be for this strip, and its name is used to find the right slot when assigning another Action

Type:

ActionSlot

action_slot_handle

A number that identifies which sub-set of the Action is considered to be for this Action Constraint (in [-inf, inf], default 0)

Type:

int

action_suitable_slots

The list of action slots suitable for this NLA strip (default None, readonly)

Type:

bpy_prop_collection[ActionSlot]

eval_time

Interpolates between Action Start and End frames (in [0, 1], default 0.0)

Type:

float

frame_end

Last frame of the Action to use (in [-1048574, 1048574], default 0)

Type:

int

frame_start

First frame of the Action to use (in [-1048574, 1048574], default 0)

Type:

int

last_slot_identifier

The identifier of the most recently assigned action slot. The slot identifies which sub-set of the Action is considered to be for this constraint, and its identifier is used to find the right slot when assigning an Action. (default “”, never None)

Type:

str

max

Maximum value for target channel range (in [-1000, 1000], default 0.0)

Type:

float

min

Minimum value for target channel range (in [-1000, 1000], default 0.0)

Type:

float

mix_mode

Specify how existing transformations and the action channels are combined (default 'AFTER_FULL')

  • REPLACE Replace – Replace the original transformation with the action channels.

  • BEFORE_FULL Before Original (Full) – Apply the action channels before the original transformation, as if applied to an imaginary parent in Full Inherit Scale mode. Will create shear when combining rotation and non-uniform scale..

  • BEFORE Before Original (Aligned) – Apply the action channels before the original transformation, as if applied to an imaginary parent in Aligned Inherit Scale mode. This effectively uses Full for location and Split Channels for rotation and scale..

  • BEFORE_SPLIT Before Original (Split Channels) – Apply the action channels before the original transformation, handling location, rotation and scale separately.

  • AFTER_FULL After Original (Full) – Apply the action channels after the original transformation, as if applied to an imaginary child in Full Inherit Scale mode. Will create shear when combining rotation and non-uniform scale..

  • AFTER After Original (Aligned) – Apply the action channels after the original transformation, as if applied to an imaginary child in Aligned Inherit Scale mode. This effectively uses Full for location and Split Channels for rotation and scale..

  • AFTER_SPLIT After Original (Split Channels) – Apply the action channels after the original transformation, handling location, rotation and scale separately.

Type:

Literal[‘REPLACE’, ‘BEFORE_FULL’, ‘BEFORE’, ‘BEFORE_SPLIT’, ‘AFTER_FULL’, ‘AFTER’, ‘AFTER_SPLIT’]

subtarget

Armature bone, mesh or lattice vertex group, … (default “”, never None)

Type:

str

target

Target object

Type:

Object

transform_channel

Transformation channel from the target that is used to key the Action (default 'ROTATION_X')

Type:

Literal[‘LOCATION_X’, ‘LOCATION_Y’, ‘LOCATION_Z’, ‘ROTATION_X’, ‘ROTATION_Y’, ‘ROTATION_Z’, ‘SCALE_X’, ‘SCALE_Y’, ‘SCALE_Z’]

use_bone_object_action

Bones only: apply the object’s transformation channels of the action to the constrained bone, instead of bone’s channels (default False)

Type:

bool

use_eval_time

Interpolate between Action Start and End frames, with the Evaluation Time slider instead of the Target object/bone (default False)

Type:

bool

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions