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


refresh([currentView=boolean], [force=boolean], [suspend=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

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) boolean create
Redraw only the current view (default redraws all views).
force(f) boolean 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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds