hotBox

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

Synopsis

hotBox [-PaneOnlyMenus] [-PaneToggleMenus boolean] [-animationOnlyMenus] [-animationToggleMenus boolean] [-clothOnlyMenus] [-clothToggleMenus boolean] [-commonOnlyMenus] [-commonToggleMenus boolean] [-customMenuSetsToggleMenus boolean] [-displayCenterOnly] [-displayHotbox] [-displayStyle] [-displayZonesOnly] [-dynamicsOnlyMenus] [-dynamicsToggleMenus boolean] [-liveOnlyMenus] [-liveToggleMenus boolean] [-noClickCommand string] [-noClickDelay float] [-noKeyPress] [-polygonsOnlyMenus] [-polygonsToggleMenus boolean] [-release] [-renderingOnlyMenus] [-renderingToggleMenus boolean] [-rmbPopups boolean] [-showAllToggleMenus boolean] [-surfacesOnlyMenus] [-surfacesToggleMenus boolean] [-transparenyLevel int] [-updateMenus]

hotBox is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
-updateMenus(-um)
Reloads the hotBox menus from the main menubar. This flag is used when the menus in the main menubar are modified, and the hotBox menus need to be refreshed.
-transparenyLevel(-tr)	int
The percentage of transparency, from 0 to 100. Currently, only the values 0, 25, 50, 75 and 100 are supported. Any other values will be rounded off to the nearest supported value. In query mode, this flag needs a value.
-showAllToggleMenus(-a)	boolean
Sets the visibility of all menus to on or off. When queried, will only return true if all menu rows are visible. In query mode, this flag needs a value.
-polygonsToggleMenus(-plt)	boolean
-surfacesToggleMenus(-st)	boolean
-animationToggleMenus(-at)	boolean
-dynamicsToggleMenus(-dt)	boolean
-renderingToggleMenus(-rt)	boolean
-clothToggleMenus(-clt)	boolean
-liveToggleMenus(-lt)	boolean
-commonToggleMenus(-ct)	boolean
-customMenuSetsToggleMenus(-cst)	boolean
-PaneToggleMenus(-pt)	boolean
Sets the visibilty of a row of menus to on or off. In query mode, this flag needs a value.
-rmbPopups(-rmb)	boolean
Enables/Disables a popup menu of the current function set. This popup menu appear when the right mouse button is pressed in the center zone of the hotbox. In query mode, this flag needs a value.
-polygonsOnlyMenus(-plo)
-surfacesOnlyMenus(-so)
-animationOnlyMenus(-ao)
-dynamicsOnlyMenus(-do)
-renderingOnlyMenus(-ro)
-clothOnlyMenus(-clo)
-liveOnlyMenus(-lo)
-commonOnlyMenus(-co)
-PaneOnlyMenus(-po)
Sets a row of menus to be the only visible row.
-noClickCommand(-ncc)	string
The command to be executed if the hotBox is engaged and then disengaged within noClickDelay time units.
-noClickDelay(-ncd)	float
If the hotBox is engaged and then disengaged within this time interval, then the noClickCommand is executed. The time interval is in seconds. The default value is 0.1.
-displayHotbox(-dh)
-displayZonesOnly(-dzo)
-displayCenterOnly(-dco)
Three different display styles are defined for the hotBox. It can be fully displayed (dh), display only the marking menu zones (dzo) or no display (dco) which means that the entire screen can be used to access the marking menus defined in the center zone.
-displayStyle(-ds)
Returns a string that identifies the flag used to set the current display style. The results can be dh, dzo, or dco, depending on which style the hotBox is using at the moment. In query mode, this flag needs a value.
-release(-rl)
Action to be called on the release of the key which invoked the hotbox
-noKeyPress(-nkp)
Normally the hotbox is popped by a pressing a keyboard key. Use the nkp flag to pop the hotbox from a device other than the keyboard (still use the rl flag to unpop the hotbox).

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

Return value

MEL examples

// Bind the hotBox to the spacebar.
//
nameCommand -annotation "Pop Hotbox" -command "hotBox" "NameComPop_hotBox";
hotkey -k " " -name "NameComPop_hotBox";