Action(ID)#

base classes — bpy_struct, ID

class bpy.types.Action(ID)#

A collection of F-Curves for animation

curve_frame_range#

The combined frame range of all F-Curves within this action

Type:

mathutils.Vector of 2 items in [-inf, inf], default (0.0, 0.0), (readonly)

fcurves#

The individual F-Curves that make up the action

Type:

ActionFCurves bpy_prop_collection of FCurve, (readonly)

frame_end#

The end frame of the manually set intended playback range

Type:

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

frame_range#

The intended playback frame range of this action, using the manually set range if available, or the combined frame range of all F-Curves within this action if not (assigning sets the manual frame range)

Type:

mathutils.Vector of 2 items in [-inf, inf], default (0.0, 0.0)

frame_start#

The start frame of the manually set intended playback range

Type:

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

groups#

Convenient groupings of F-Curves

Type:

ActionGroups bpy_prop_collection of ActionGroup, (readonly)

id_root#

Type of ID block that action can be used on - DO NOT CHANGE UNLESS YOU KNOW WHAT YOU ARE DOING

  • ACTION Action.

  • ARMATURE Armature.

  • BRUSH Brush.

  • CACHEFILE Cache File.

  • CAMERA Camera.

  • COLLECTION Collection.

  • CURVE Curve.

  • CURVES Curves.

  • FONT Font.

  • GREASEPENCIL Grease Pencil.

  • GREASEPENCIL_V3 Grease Pencil v3.

  • IMAGE Image.

  • KEY Key.

  • LATTICE Lattice.

  • LIBRARY Library.

  • LIGHT Light.

  • LIGHT_PROBE Light Probe.

  • LINESTYLE Line Style.

  • MASK Mask.

  • MATERIAL Material.

  • MESH Mesh.

  • META Metaball.

  • MOVIECLIP Movie Clip.

  • NODETREE Node Tree.

  • OBJECT Object.

  • PAINTCURVE Paint Curve.

  • PALETTE Palette.

  • PARTICLE Particle.

  • POINTCLOUD Point Cloud.

  • SCENE Scene.

  • SCREEN Screen.

  • SOUND Sound.

  • SPEAKER Speaker.

  • TEXT Text.

  • TEXTURE Texture.

  • VOLUME Volume.

  • WINDOWMANAGER Window Manager.

  • WORKSPACE Workspace.

  • WORLD World.

  • UNSPECIFIED Unspecified – Not yet specified. When this slot is first assigned to a data-block, this will be set to the type of that data-block.

Type:

enum in [‘ACTION’, ‘ARMATURE’, ‘BRUSH’, ‘CACHEFILE’, ‘CAMERA’, ‘COLLECTION’, ‘CURVE’, ‘CURVES’, ‘FONT’, ‘GREASEPENCIL’, ‘GREASEPENCIL_V3’, ‘IMAGE’, ‘KEY’, ‘LATTICE’, ‘LIBRARY’, ‘LIGHT’, ‘LIGHT_PROBE’, ‘LINESTYLE’, ‘MASK’, ‘MATERIAL’, ‘MESH’, ‘META’, ‘MOVIECLIP’, ‘NODETREE’, ‘OBJECT’, ‘PAINTCURVE’, ‘PALETTE’, ‘PARTICLE’, ‘POINTCLOUD’, ‘SCENE’, ‘SCREEN’, ‘SOUND’, ‘SPEAKER’, ‘TEXT’, ‘TEXTURE’, ‘VOLUME’, ‘WINDOWMANAGER’, ‘WORKSPACE’, ‘WORLD’, ‘UNSPECIFIED’], default ‘UNSPECIFIED’

is_action_layered#

Return whether this is a layered Action. An empty Action considered as both a ‘layered’ and a ‘layered’ Action.

Type:

boolean, default False, (readonly)

is_action_legacy#

Return whether this is a legacy Action. Legacy Actions have no layers or slots. An empty Action considered as both a ‘legacy’ and a ‘layered’ Action.

Type:

boolean, default False, (readonly)

is_empty#

False when there is any Layer, Slot, or legacy F-Curve

Type:

boolean, default False, (readonly)

layers#

The list of layers that make up this Action

Type:

ActionLayers bpy_prop_collection of ActionLayer, (readonly)

pose_markers#

Markers specific to this action, for labeling poses

Type:

ActionPoseMarkers bpy_prop_collection of TimelineMarker, (readonly)

slots#

The list of slots in this Action

Type:

ActionSlots bpy_prop_collection of ActionSlot, (readonly)

use_cyclic#

The action is intended to be used as a cycle looping over its manually set playback frame range (enabling this doesn’t automatically make it loop)

Type:

boolean, default False

use_frame_range#

Manually specify the intended playback frame range for the action (this range is used by some tools, but does not affect animation evaluation)

Type:

boolean, default False

deselect_keys()#

Deselects all keys of the Action. The selection status of F-Curves is unchanged.

flip_with_pose(object)#

Flip the action around the X axis using a pose

Parameters:

object (Object, (never None)) – The reference armature object to use when flipping

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#