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

Synopsis

headsUpMessage [-horizontalOffset int] [-object string] [-selection] [-time float] [-verticalOffset int] [message string]

headsUpMessage is undoable, NOT queryable, and NOT editable.

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

Return value

None

Flags

horizontalOffset, object, selection, time, verticalOffset
Long name (short name) Argument types Properties
-object(-o) string create
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) create
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 create
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 create
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.
-horizontalOffset(-ho) int create
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 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

headsUpMessage "Ouch!";
headsUpMessage -object circle1 "This is Circle 1";
headsUpMessage -selection "These objects are selected";
headsUpMessage -time 5.0 "Text appears for minimum of 5 seconds.";
headsUpMessage -verticalOffset 20 "Text appears 20 pixels above point.";
headsUpMessage -horizontalOffset -20 "Text appears 20 pixels to the left of the point.";