pymel.core.animation.shotRipple

shotRipple(*args, **kwargs)

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. In query mode, return type is based on queried flag.

Flags:

Long name (short name)		Argument Types	Properties
deleted (d)		bool
	Specify whether this ripple edit is due to a shot deletionFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.
endDelta (ed)		time
	Specify the change in the end time in frames
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
startTime (st)		time
	Specify the initial shot start time in the sequence timeline.

Derived from mel command maya.cmds.shotRipple

Example:

import pymel.core as pm

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
pm.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
pm.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)
pm.shotRipple(shotName, delete=1,startTime=10,endTime=20)