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

Synopsis

shotRipple [-deleted] [-endDelta time] [-endTime time] [-startDelta time] [-startTime time]

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) 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 be used more than once in a command.

MEL examples

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