Nla Operators

bpy.ops.nla.action_pushdown(channel_index=-1)

Push action down onto the top of the NLA stack as a new strip

Parameters:channel_index (int in [-1, inf], (optional)) – Channel Index, Index of NLA action channel to perform pushdown operation on

bpy.ops.nla.action_sync_length(active=True)

Synchronize the length of the referenced Action with the length used in the strip

Parameters:active (boolean, (optional)) – Active Strip Only, Only sync the active length for the active strip

bpy.ops.nla.action_unlink(force_delete=False)

Unlink this action from the active action slot (and/or exit Tweak Mode)

Parameters:force_delete (boolean, (optional)) – Force Delete, Clear Fake User and remove copy stashed in this datablock’s NLA stack

bpy.ops.nla.actionclip_add(action='')

Add an Action-Clip strip (i.e. an NLA Strip referencing an Action) to the active track

Parameters:action (enum in [], (optional)) – Action

bpy.ops.nla.apply_scale()

Apply scaling of selected strips to their referenced Actions

bpy.ops.nla.bake(frame_start=1, frame_end=250, step=1, only_selected=True, visual_keying=False, clear_constraints=False, clear_parents=False, use_current_action=False, bake_types={'POSE'})

Bake object/pose loc/scale/rotation animation to a new action

Parameters:

• frame_start (int in [0, 300000], (optional)) – Start Frame, Start frame for baking
• frame_end (int in [1, 300000], (optional)) – End Frame, End frame for baking
• step (int in [1, 120], (optional)) – Frame Step, Frame Step
• only_selected (boolean, (optional)) – Only Selected, Only key selected bones (Pose baking only)
• visual_keying (boolean, (optional)) – Visual Keying, Keyframe from the final transformations (with constraints applied)
• clear_constraints (boolean, (optional)) – Clear Constraints, Remove all constraints from keyed object/bones, and do ‘visual’ keying
• clear_parents (boolean, (optional)) – Clear Parents, Bake animation onto the object then clear parents (objects only)
• use_current_action (boolean, (optional)) – Overwrite Current Action, Bake animation into current action, instead of creating a new one (useful for baking only part of bones in an armature)
• bake_types (enum set in {'POSE', 'OBJECT'}, (optional)) –

  Bake Data, Which data’s transformations to bake

  • POSE Pose, Bake bones transformations.
  • OBJECT Object, Bake object transformations.

File:

startup/bl_operators/anim.py:260

bpy.ops.nla.channels_click(extend=False)

Handle clicks to select NLA channels

Parameters:extend (boolean, (optional)) – Extend Select

bpy.ops.nla.clear_scale()

Reset scaling of selected strips

bpy.ops.nla.click_select(extend=False)

Handle clicks to select NLA Strips

Parameters:extend (boolean, (optional)) – Extend Select

bpy.ops.nla.delete()

Delete selected strips

bpy.ops.nla.duplicate(linked=False, mode='TRANSLATION')

Duplicate selected NLA-Strips, adding the new strips in new tracks above the originals

Parameters:

• linked (boolean, (optional)) – Linked, When duplicating strips, assign new copies of the actions they use
• mode (enum in ['INIT', 'DUMMY', 'TRANSLATION', 'ROTATION', 'RESIZE', 'SKIN_RESIZE', 'TOSPHERE', 'SHEAR', 'BEND', 'SHRINKFATTEN', 'TILT', 'TRACKBALL', 'PUSHPULL', 'CREASE', 'MIRROR', 'BONE_SIZE', 'BONE_ENVELOPE', 'BONE_ENVELOPE_DIST', 'CURVE_SHRINKFATTEN', 'MASK_SHRINKFATTEN', 'GPENCIL_SHRINKFATTEN', 'BONE_ROLL', 'TIME_TRANSLATE', 'TIME_SLIDE', 'TIME_SCALE', 'TIME_EXTEND', 'BAKE_TIME', 'BWEIGHT', 'ALIGN', 'EDGESLIDE', 'SEQSLIDE'], (optional)) – Mode

bpy.ops.nla.fmodifier_add(type='NULL', only_active=True)

Add F-Modifier to the active/selected NLA-Strips

Parameters:

• type (enum in ['NULL', 'GENERATOR', 'FNGENERATOR', 'ENVELOPE', 'CYCLES', 'NOISE', 'LIMITS', 'STEPPED'], (optional)) –

  Type

  • NULL Invalid.
  • GENERATOR Generator, Generate a curve using a factorized or expanded polynomial.
  • FNGENERATOR Built-In Function, Generate a curve using standard math functions such as sin and cos.
  • ENVELOPE Envelope, Reshape F-Curve values - e.g. change amplitude of movements.
  • CYCLES Cycles, Cyclic extend/repeat keyframe sequence.
  • NOISE Noise, Add pseudo-random noise on top of F-Curves.
  • LIMITS Limits, Restrict maximum and minimum values of F-Curve.
  • STEPPED Stepped Interpolation, Snap values to nearest grid-step - e.g. for a stop-motion look.
• only_active (boolean, (optional)) – Only Active, Only add a F-Modifier of the specified type to the active strip

bpy.ops.nla.fmodifier_copy()

Copy the F-Modifier(s) of the active NLA-Strip

bpy.ops.nla.fmodifier_paste(only_active=True, replace=False)

Add copied F-Modifiers to the selected NLA-Strips

Parameters:

• only_active (boolean, (optional)) – Only Active, Only paste F-Modifiers on active strip
• replace (boolean, (optional)) – Replace Existing, Replace existing F-Modifiers, instead of just appending to the end of the existing list

bpy.ops.nla.make_single_user()

Ensure that each action is only used once in the set of strips selected

bpy.ops.nla.meta_add()

Add new meta-strips incorporating the selected strips

bpy.ops.nla.meta_remove()

Separate out the strips held by the selected meta-strips

bpy.ops.nla.move_down()

Move selected strips down a track if there’s room

bpy.ops.nla.move_up()

Move selected strips up a track if there’s room

bpy.ops.nla.mute_toggle()

Mute or un-mute selected strips

bpy.ops.nla.previewrange_set()

Automatically set Preview Range based on range of keyframes

bpy.ops.nla.properties()

Toggle the properties region visibility

bpy.ops.nla.select_all_toggle(invert=False)

Select or deselect all NLA-Strips

Parameters:invert (boolean, (optional)) – Invert

bpy.ops.nla.select_border(gesture_mode=0, xmin=0, xmax=0, ymin=0, ymax=0, extend=True, axis_range=False)

Use box selection to grab NLA-Strips

Parameters:

• gesture_mode (int in [-inf, inf], (optional)) – Gesture Mode
• xmin (int in [-inf, inf], (optional)) – X Min
• xmax (int in [-inf, inf], (optional)) – X Max
• ymin (int in [-inf, inf], (optional)) – Y Min
• ymax (int in [-inf, inf], (optional)) – Y Max
• extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first
• axis_range (boolean, (optional)) – Axis Range

bpy.ops.nla.select_leftright(mode='CHECK', extend=False)

Select strips to the left or the right of the current frame

Parameters:

• mode (enum in ['CHECK', 'LEFT', 'RIGHT'], (optional)) – Mode
• extend (boolean, (optional)) – Extend Select

bpy.ops.nla.selected_objects_add()

Make selected objects appear in NLA Editor by adding Animation Data

bpy.ops.nla.snap(type='CFRA')

Move start of strips to specified time

Parameters:type (enum in ['CFRA', 'NEAREST_FRAME', 'NEAREST_SECOND', 'NEAREST_MARKER'], (optional)) – Type

bpy.ops.nla.soundclip_add()

Add a strip for controlling when speaker plays its sound clip

bpy.ops.nla.split()

Split selected strips at their midpoints

bpy.ops.nla.swap()

Swap order of selected strips within tracks

bpy.ops.nla.tracks_add(above_selected=False)

Add NLA-Tracks above/after the selected tracks

Parameters:above_selected (boolean, (optional)) – Above Selected, Add a new NLA Track above every existing selected one

bpy.ops.nla.tracks_delete()

Delete selected NLA-Tracks and the strips they contain

bpy.ops.nla.transition_add()

Add a transition strip between two adjacent selected strips

bpy.ops.nla.tweakmode_enter(isolate_action=False)

Enter tweaking mode for the action referenced by the active strip to edit its keyframes

Parameters:isolate_action (boolean, (optional)) – Isolate Action, Enable ‘solo’ on the NLA Track containing the active strip, to edit it without seeing the effects of the NLA stack

bpy.ops.nla.tweakmode_exit(isolate_action=False)

Exit tweaking mode for the action referenced by the active strip

Parameters:isolate_action (boolean, (optional)) – Isolate Action, Disable ‘solo’ on any of the NLA Tracks after exiting tweak mode to get things back to normal

bpy.ops.nla.view_all()

Reset viewable area to show full strips range

bpy.ops.nla.view_frame()

Reset viewable area to show range around current frame

bpy.ops.nla.view_selected()

Reset viewable area to show selected strips range