NlaStrip(bpy_struct)#

base class — bpy_struct

class bpy.types.NlaStrip(bpy_struct)#

A container referencing an existing Action

action#

Action referenced by this strip

Type:

Action

action_frame_end#

Last frame from action to use

Type:

float in [-inf, inf], default 0.0

action_frame_start#

First frame from action to use

Type:

float in [-inf, inf], default 0.0

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 NLA strip

Type:

int in [-inf, inf], default 0

action_slot_name#

The name of the 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 an Action.

Type:

string, default “”, (never None)

action_slots#

The list of action slots suitable for this NLA strip

Type:

bpy_prop_collection of ActionSlot, (readonly)

active#

NLA Strip is active

Type:

boolean, default False, (readonly)

blend_in#

Number of frames at start of strip to fade in influence

Type:

float in [-inf, inf], default 0.0

blend_out#
Type:

float in [-inf, inf], default 0.0

blend_type#

Method used for combining strip’s result with accumulated result

  • 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’

extrapolation#

Action to take for gaps past the strip extents

  • 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’

fcurves#

F-Curves for controlling the strip’s influence and timing

Type:

NlaStripFCurves bpy_prop_collection of FCurve, (readonly)

frame_end#
Type:

float in [-inf, inf], default 0.0

frame_end_raw#

Same as frame_end, except that any value can be set, including ones that create an invalid state

Type:

float in [-inf, inf], default 0.0

frame_end_ui#

End frame of the NLA strip. Note: changing this value also updates the value of the strip’s repeats or its action’s end frame. If only the end frame should be changed, see the “frame_end” property instead.

Type:

float in [-inf, inf], default 0.0

frame_start#
Type:

float in [-inf, inf], default 0.0

frame_start_raw#

Same as frame_start, except that any value can be set, including ones that create an invalid state

Type:

float in [-inf, inf], default 0.0

frame_start_ui#

Start frame of the NLA strip. Note: changing this value also updates the value of the strip’s end frame. If only the start frame should be changed, see the “frame_start” property instead.

Type:

float in [-inf, inf], default 0.0

influence#

Amount the strip contributes to the current result

Type:

float in [0, 1], default 0.0

modifiers#

Modifiers affecting all the F-Curves in the referenced Action

Type:

bpy_prop_collection of FModifier, (readonly)

mute#

Disable NLA Strip evaluation

Type:

boolean, default False

name#
Type:

string, default “”, (never None)

repeat#

Number of times to repeat the action range

Type:

float in [0.1, 1000], default 1.0

scale#

Scaling factor for action

Type:

float in [0.0001, 1000], default 1.0

select#

NLA Strip is selected

Type:

boolean, default False

strip_time#

Frame of referenced Action to evaluate

Type:

float in [-inf, inf], default 0.0

strips#

NLA Strips that this strip acts as a container for (if it is of type Meta)

Type:

bpy_prop_collection of NlaStrip, (readonly)

type#

Type of NLA Strip

  • CLIP Action Clip – NLA Strip references some Action.

  • TRANSITION Transition – NLA Strip ‘transitions’ between adjacent strips.

  • META Meta – NLA Strip acts as a container for adjacent strips.

  • SOUND Sound Clip – NLA Strip representing a sound event for speakers.

Type:

enum in [‘CLIP’, ‘TRANSITION’, ‘META’, ‘SOUND’], default ‘CLIP’, (readonly)

use_animated_influence#

Influence setting is controlled by an F-Curve rather than automatically determined

Type:

boolean, default False

use_animated_time#

Strip time is controlled by an F-Curve rather than automatically determined

Type:

boolean, default False

use_animated_time_cyclic#

Cycle the animated time within the action start and end

Type:

boolean, default False

use_auto_blend#

Number of frames for Blending In/Out is automatically determined from overlapping strips

Type:

boolean, default False

use_reverse#

NLA Strip is played back in reverse order (only when timing is automatically determined)

Type:

boolean, default False

use_sync_length#

Update range of frames referenced from action after tweaking strip and its keyframes

Type:

boolean, default False

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

Inherited Properties#

Inherited Functions#

References#