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

Inherited Functions

References