pymel.core.windows.headsUpMessage

headsUpMessage(*args, **kwargs)

This command draws a message in the 3d view. The message is automatically erased at the next screen refresh.

Flags:
Long name (short name) Argument Types Properties
horizontalOffset (ho) int ../../../_images/create.gif
 

If this flag is specified, the message will appear the specified distance (in pixels) to the right of the point. Otherwise, a default horizontal offset of 0 pixels is used. Flag can have multiple arguments, passed either as a tuple or a list.

object (o) unicode ../../../_images/create.gif
 

If an object is specified, then the message is drawn just above the object’s bounding-box centre point. If this flag is not specified, or the object is not found, then the message is centred in the current view.

selection (s) bool ../../../_images/create.gif
 
If this flag is specified, the message will be centred among the currently selected objects. This flag does nothing if the object flag is also specified.
time (t) float ../../../_images/create.gif
 
If this flag is specified, the message will be displayed for a minimum of the given amount of time (in seconds). Otherwise a default time of 1.0 seconds is used.
verticalOffset (vo) int ../../../_images/create.gif
 
If this flag is specified, the message will appear the specified distance (in pixels) above the point. Otherwise, a default vertical offset of 0 pixels is used.

Derived from mel command maya.cmds.headsUpMessage

Example:

import pymel.core as pm

pm.headsUpMessage( 'Ouch!' )
pm.headsUpMessage( 'This is Circle 1', object='circle1' )
pm.headsUpMessage( 'These objects are selected', selection=True )
pm.headsUpMessage( 'Text appears for minimum of 5 seconds.', time=5.0 )
pm.headsUpMessage( 'Text appears 0 pixels above point.', verticalOffset=20 )
pm.headsUpMessage( 'Text appears 20 pixels to the left of the point.', horizontalOffset=-20 )

Previous topic

pymel.core.windows.headsUpDisplay

Next topic

pymel.core.windows.helpLine

Core

Core Modules

Other Modules

This Page