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

Synopsis

saveInitialState [-attribute string] [-saveall] selectionList

saveInitialState is undoable, NOT queryable, and NOT editable.

saveInitialState saves the current state of dynamics objects as the initial state. A dynamic object is a particle shape, rigid body, rigid constraint or rigid solver. If no objects are specified, it saves the initial state for any selected objects. It returns the names of the objects for which initial state was saved.

Return value

string

Flags

attribute, saveall
Long name (short name) Argument types Properties
-attribute(-atr) string createmultiuse
Save the initial state of the specified attribute only. This is a multi-use flag.
-saveall(-all) create
Save the initial state for all dynamics objects in the scene.
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

saveInitialState particle1;
// Saves current state as initial state for particle1.

saveInitialState -all;
// Saves current state as initial state for all dynamics objects.