Go to: Synopsis. Return value. Flags. MEL examples.
runup [-cache] [-fromPreviousFrame] [-fromStartFrame] [-maxFrame time] [-state boolean]
runup is undoable, NOT queryable, and NOT editable.
runup plays the scene through a frame of frames, forcing
dynamic objects to evaluate as it does so. If no max frame
is specified, runup runs up to the current time.
cache, fromPreviousFrame, fromStartFrame, maxFrame, state
| Long name (short name) |
Argument types |
Properties |
-maxFrame(-mxf)
|
time
|
|
|
Ending time for runup, in current user time units.
The runup will always start at the
minimum start frame for all dynamic objects.
|
|
-cache(-cch)
|
|
|
|
Cache the state after the runup.
|
|
-fromStartFrame(-fsf)
|
|
|
|
Run up the animation from the start frame.
If no flag is supplied -fromPreviousFrame is the default.
|
|
-fromPreviousFrame(-fpf)
|
|
|
|
Run up the animation from the previously evaluated frame.
If no flag is supplied this is the default.
|
|
-state(-st)
|
boolean
|
|
|
Turns runup and cache on/off.
|
|
|
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.
|
runup -mxf 10 -cache;
// Starts at the minimum start frame of all dynamic objects
// and plays through to frame 10. This guarantees that the system
// is in the same state it would be as if you had rewound and played
// forward from frame 0. The state of the dynamic object(s) will be
// cached after the runup.