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
	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.
object / o		unicode
	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
	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
	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.
uvTextureEditor / uve		bool
verticalOffset / vo		int
	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. Flag can have multiple arguments, passed either as a tuple or a list.
viewport / vp		bool

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 )