Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

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.

Return value

string

Flags

cache, fromPreviousFrame, fromStartFrame, maxFrame, state
Long name (short name) Argument types Properties
-maxFrame(-mxf) time create
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) create
Cache the state after the runup.
-fromStartFrame(-fsf) create
Run up the animation from the start frame. If no flag is supplied -fromPreviousFrame is the default.
-fromPreviousFrame(-fpf) create
Run up the animation from the previously evaluated frame. If no flag is supplied this is the default.
-state(-st) boolean create
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.

MEL examples

    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.