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 (in [-inf, inf], default 0.0)

Type:

float

action_frame_start

First frame from action to use (in [-inf, inf], default 0.0)

Type:

float

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 (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]

active

NLA Strip is active (default False, readonly)

Type:

bool

blend_in

Number of frames at start of strip to fade in influence (in [-inf, inf], default 0.0)

Type:

float

blend_out

(in [-inf, inf], default 0.0)

Type:

float

blend_type

Method used for combining strip’s result with accumulated result (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’]

extrapolation

Action to take for gaps past the strip extents (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’]

fcurves

F-Curves for controlling the strip’s influence and timing (default None, readonly)

Type:

NlaStripFCurves[FCurve]

frame_end

(in [-inf, inf], default 0.0)

Type:

float

frame_end_raw

Same as frame_end, except that any value can be set, including ones that create an invalid state (in [-inf, inf], default 0.0)

Type:

float

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. (in [-inf, inf], default 0.0)

Type:

float

frame_start

(in [-inf, inf], default 0.0)

Type:

float

frame_start_raw

Same as frame_start, except that any value can be set, including ones that create an invalid state (in [-inf, inf], default 0.0)

Type:

float

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. (in [-inf, inf], default 0.0)

Type:

float

influence

Amount the strip contributes to the current result (in [0, 1], default 0.0)

Type:

float

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

Type:

str

modifiers

Modifiers affecting all the F-Curves in the referenced Action (default None, readonly)

Type:

bpy_prop_collection[FModifier]

mute

Disable NLA Strip evaluation (default False)

Type:

bool

name

(default “”, never None)

Type:

str

repeat

Number of times to repeat the action range (in [0.1, 1000], default 1.0)

Type:

float

scale

Scaling factor for action (in [0.0001, 1000], default 1.0)

Type:

float

select

NLA Strip is selected (default False)

Type:

bool

strip_time

Frame of referenced Action to evaluate (in [-inf, inf], default 0.0)

Type:

float

strips

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

Type:

bpy_prop_collection[NlaStrip]

type

Type of NLA Strip (default 'CLIP', readonly)

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

Literal[‘CLIP’, ‘TRANSITION’, ‘META’, ‘SOUND’]

use_animated_influence

Influence setting is controlled by an F-Curve rather than automatically determined (default False)

Type:

bool

use_animated_time

Strip time is controlled by an F-Curve rather than automatically determined (default False)

Type:

bool

use_animated_time_cyclic

Cycle the animated time within the action start and end (default False)

Type:

bool

use_auto_blend

Number of frames for Blending In/Out is automatically determined from overlapping strips (default False)

Type:

bool

use_reverse

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

Type:

bool

use_sync_length

Update range of frames referenced from action after tweaking strip and its keyframes (default False)

Type:

bool

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

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

  • bpy.context.active_nla_strip

  • bpy.context.selected_nla_strips

  • NlaStrip.strips