Go to: Synopsis. Return value. Keywords. Flags. Python examples.

Synopsis

shotRipple([deleted=boolean], [endDelta=time], [endTime=time], [startDelta=time], [startTime=time])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

shotRipple is undoable, queryable, and editable.

When Ripple Edit Mode is enabled, neighboring shots to the shot that gets manipulated are moved in sequence time to either make way or close up gaps corresponding to that node's editing. Given some parameters about the shot edit that just took place, this command will choose which other shots to move, and move them the appropriate amounts If no shot name is provided, the command will attempt to use the first selected shot.

Return value

None

In query mode, return type is based on queried flag.

Keywords

reference, sequencer, node, shot, ripple

Flags

deleted, endDelta, endTime, startDelta, startTime
Long name (short name) Argument types Properties
startTime(st) time createqueryedit
Specify the initial shot start time in the sequence timeline.
endTime(et) time createqueryedit
Specify the initial shot end time in the sequence timeline.
startDelta(sd) time createqueryedit
Specify the change in the start time in frames
endDelta(ed) time createqueryedit
Specify the change in the end time in frames
deleted(d) boolean createqueryedit
Specify whether this ripple edit is due to a shot deletion

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

// A shot initially starting at sequence time 0 was edited to start 10 frames later.
// adjust the rest of the shots accordingly
cmds.shotRipple(shotName, startTime=0, startDelta=10)
// A shot initially ending at frame 10 was edited to start 5 frames earlier.
// adjust the rest of the shots accordingly
cmds.shotRipple(shotName, endTime=10, endDelta=-5)
// A shot starting at frame 10 and ending at frame 20 was just deleted
// adjust the rest of the shots accordingly (if necessary)
cmds.shotRipple(shotName, delete=1,startTime=10,endTime=20)