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.