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

  • 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

enum in ['REPLACE', 'COMBINE', 'ADD', 'SUBTRACT', 'MULTIPLY'], default "'REPLACE'"

action_extrapolation

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

  • 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

enum in ['NOTHING', 'HOLD', 'HOLD_FORWARD'], default "'HOLD'"

action_influence

Amount the Active Action contributes to the result of the NLA stack

Type

float in [0, 1], default 1.0

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

Type

int in [-inf, inf], default 0

action_slot_handle_tweak_storage

Storage to temporarily hold the main action slot while in tweak mode

Type

int in [-inf, inf], default 0

action_suitable_slots

The list of slots in this animation data-block

Type

bpy_prop_collection of ActionSlot, (readonly)

action_tweak_storage

Storage to temporarily hold the main action while in tweak mode

Type

Action

drivers

The Drivers/Expressions for this data-block

Type

AnimDataDrivers bpy_prop_collection of FCurve, (readonly)

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.

Type

string, default “”, (never None)

nla_tracks

NLA Tracks (i.e. Animation Layers)

Type

NlaTracks bpy_prop_collection of NlaTrack, (readonly)

use_nla

NLA stack is evaluated when evaluating this block

Type

boolean, default False

use_pin
Type

boolean, default False

use_tweak_mode

Whether to enable or disable tweak mode in NLA

Type

boolean, default False

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 in [-1.04857e+06, 1.04857e+06]) – Input time

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

Returns

Converted time

Return type

float in [-1.04857e+06, 1.04857e+06]

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 (string, (optional, never None)) – Prefix, Name prefix

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

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

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

id (str) – 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 (str) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References