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


refresh [-currentView] [-force] [-suspend boolean]

refresh is undoable, NOT queryable, and NOT editable.

This command is used to force a redraw during script execution. Normally, redraw is suspended while scripts are executing but sometimes it is useful to show intermediate results for purposes such as capturing images from the screen.

If the -cv flag is specified, then only the current active view is redrawn.

Return value



currentUnit, displayAffected, displayColor, displayCull, displayLevelOfDetail, displayPref, displayRGBColor, displaySmoothness, displayStats, displaySurface, hide, showHidden, toggle


currentView, force, suspend
Long name (short name) Argument types Properties
-currentView(-cv) create
Redraw only the current view (default redraws all views).
-force(-f) create
Force the refresh regardless of the state of the model.
-suspend(-su) boolean create
Suspends or resumes Maya's handling of refresh events. Specify "on" to suspend refreshing, and "off" to resume refreshing. Note that resuming refresh does not itself cause a refresh -- the next natural refresh event in Maya after "refresh -suspend off" is issued will cause the refresh to occur. Use this flag with caution: although it provides opportunities to enhance performance, much of Maya's dependency graph evaluation in interactive mode is refresh driven, thus use of this flag may lead to slight solve differences when you have a complex dependency graph with interrelations.

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