pymel.core.animation.shotRipple

static animation.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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Specify whether this ripple edit is due to a shot deletion Flag can have multiple arguments, passed either as a tuple or a list.

endDelta (ed) time ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specify the change in the end time in frames
endTime (et) time ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specify the initial shot end time in the sequence timeline.
startDelta (sd) time ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specify the change in the start time in frames
startTime (st) time ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specify the initial shot start time in the sequence timeline.

Derived from mel command maya.cmds.shotRipple

Example:

import pymel.core as pm

// 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)

Previous topic

pymel.core.animation.shot

Next topic

pymel.core.animation.simplify

Core

Core Modules

Other Modules

This Page