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_start
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 0.0
scale

Scaling factor for action

Type:float in [0.0001, 1000], default 0.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 & 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