AnimData(bpy_struct)

base class — bpy_struct

class bpy.types.AnimData(bpy_struct)

Animation data for data-block

action

Active Action for this data-block

Type:

Action

action_blend_type

Method used for combining Active Action’s result with result of NLA stack (default 'REPLACE')

  • REPLACE Replace – The strip values replace the accumulated results by amount specified by influence.

  • COMBINE Combine – The strip values are combined with accumulated results by appropriately using addition, multiplication, or quaternion math, based on channel type.

  • ADD Add – Weighted result of strip is added to the accumulated results.

  • SUBTRACT Subtract – Weighted result of strip is removed from the accumulated results.

  • MULTIPLY Multiply – Weighted result of strip is multiplied with the accumulated results.

Type:

Literal[‘REPLACE’, ‘COMBINE’, ‘ADD’, ‘SUBTRACT’, ‘MULTIPLY’]

action_extrapolation

Action to take for gaps past the Active Action’s range (when evaluating with NLA) (default 'HOLD')

  • NOTHING Nothing – Strip has no influence past its extents.

  • HOLD Hold – Hold the first frame if no previous strips in track, and always hold last frame.

  • HOLD_FORWARD Hold Forward – Only hold last frame.

Type:

Literal[‘NOTHING’, ‘HOLD’, ‘HOLD_FORWARD’]

action_influence

Amount the Active Action contributes to the result of the NLA stack (in [0, 1], default 1.0)

Type:

float

action_slot

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

Type:

ActionSlot

action_slot_handle

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

Type:

int

action_slot_handle_tweak_storage

Storage to temporarily hold the main action slot while in tweak mode (in [-inf, inf], default 0)

Type:

int

action_suitable_slots

The list of slots in this animation data-block (default None, readonly)

Type:

bpy_prop_collection[ActionSlot]

action_tweak_storage

Storage to temporarily hold the main action while in tweak mode

Type:

Action

drivers

The Drivers/Expressions for this data-block (default None, readonly)

Type:

AnimDataDrivers[FCurve]

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 data-block, and its identifier is used to find the right slot when assigning an Action. (default “”, never None)

Type:

str

nla_tracks

NLA Tracks (i.e. Animation Layers) (default None, readonly)

Type:

NlaTracks[NlaTrack]

use_nla

NLA stack is evaluated when evaluating this block (default True)

Type:

bool

use_pin

(default False)

Type:

bool

use_tweak_mode

Whether to enable or disable tweak mode in NLA (default False)

Type:

bool

nla_tweak_strip_time_to_scene(frame, *, invert=False)

Convert a time value from the local time of the tweaked strip to scene time, exactly as done by built-in key editing tools. Returns the input time unchanged if not tweaking.

Parameters:

  • frame (float) – Input time (in [-1.04857e+06, 1.04857e+06])

  • invert (bool) – Invert, Convert scene time to action time (optional)

Returns:

Converted time (in [-1.04857e+06, 1.04857e+06])

Return type:

float

fix_paths_rename_all(*, prefix='', old_name='', new_name='')

Rename the property paths in the animation system, since properties are animated via string paths, it’s needed to keep them valid after properties has been renamed

Parameters:

  • prefix (str) – Prefix, Name prefix (optional, never None)

  • old_name (str) – Old Name, Old name (optional, never None)

  • new_name (str) – New Name, New name (optional, never None)

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

References