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

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

bpy_struct.id_data

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly bpy_struct.is_property_set

bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values

References

bpy.context.active_nla_strip bpy.context.selected_nla_strips NlaStrip.strips

NlaStrips.new NlaStrips.remove NlaTrack.strips