Go to: Synopsis. Return value. Keywords. Flags. Python examples.
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.
None
In query mode, return type is based on queried flag.
reference, sequencer, node, shot, ripple
deleted, endDelta, endTime, startDelta, startTime
| Long name (short name) |
Argument types |
Properties |
startTime(st)
|
time
|
  
|
|
Specify the initial shot start time in the sequence timeline.
|
|
endTime(et)
|
time
|
|
|
Specify the initial shot end time in the sequence timeline.
|
|
startDelta(sd)
|
time
|
|
|
Specify the change in the start time in frames
|
|
endDelta(ed)
|
time
|
|
|
Specify the change in the end time in frames
|
|
deleted(d)
|
boolean
|
|
|
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.
|
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)