Go to: Synopsis. Return value. MEL examples.

Synopsis

advanceToNextDrivenKey (string $advanceFlag, string $attribute)

Script for going to the next, previous, first or last driven keyframe. Driven keyframes are set using Set Driven Key.

Return value

None

Arguments
Variable Name Variable Type Description
$advanceFlagstringif true, go to next key, else go to previous key
$attributestringthe driven attribute or "" to use selected item

MEL examples

 // Say you have a lattice point keyed against a joint's rotation.
 // Select the lattice point and to go to the previous key enter:
 advanceNextDrivenKey -previous "";

 // To go to the next driven key enter:
 advanceToNextDrivenKey -next "";

 // To go to the first driven key enter:
 advanceToNextDrivenKey -first "";

 // To go to the last driven key enter:
 advanceToNextDrivenKey -last "";

 // If the object has more than one driven-key relationship defined, and
 // the "" argument is used, we advance ALL the drivers that
 // affect that object.

 // Therefore, if you have many driven attributes on a node, you may want
 // to specify the attribute directly, for example:
 advanceToNextDrivenKey -previous nurbSphere1.tx;

 // Via the UI, you can specify an attribute to be advanced using the
 // setDrivenKey window menu item: Key->Go To Next, Key->Go To Previous.