A newer version of Max is available. Click here to access the latest version of this document.

live.tab

A user interface tab/multiple button object

Description

The live.tab object is used to create multiple-button and multi-column displays and interfaces.

Arguments

None.

Messages

bang Sends the current item out the outlets.
int input [int]
The number specifies a tab item to be sent out, and causes live.tab to display that item. The items are numbered starting at 0.
float input [float]
The number specifies a tab item to be sent out, and causes live.tab to display that item. The items are numbered starting at 0.
assign assign-input [float]
The word assign, followed by a floating point value, causes that value to be stored and displayed and sent out the live.tab object's outlet. If the Parameter Visibility attribute is set to Stored Only, the assign message will not add the new value to the Live application’s undo chain.
init Restore and output the initial value.
(mouse) Clicking on a tab button will highlight and set the selection and send the tab text out the second outlet and the index out the first outlet.
outputvalue Sends the current value out the outlet.
set tab index [float]
The word set, followed by a number, specifies a menu item to be displayed by live.tab without triggering any output.
setsymbol tab item [list]
The word setsymbol, followed by a symbol that specifies a tab item, causes live.tab to display that item, but does not cause any output.
symbol tab item [list]
The word symbol, followed by a symbol that specifies a tab item, causes live.tab to display that item and send the tab text out the second outlet and the index out the first outlet.
rawfloat input [float]
A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, stored, displayed by live.tab object, and the current value is sent out the outlet.

Attributes

Name Type g/s Description
active int
def.:1
Toggles the object's active state. When active is set to 0, the mouse action does not cause output and the inactive colors are used.
activebgcolor float Sets the background color off displayed when the active attribute is set to 1.
activebgoncolor float Sets the background color on displayed when the active attribute is set to 1.
bgcolor float Sets the background color off displayed when the active attribute is set to 0.
bgoncolor float Sets the background color on displayed when the active attribute is set to 0.
blinktime int
def.:150
Sets the blink time in milliseconds.
bordercolor float Sets the display color for the live.tab object's border in RGBA format.
button int
def.:0
Toggles button mode for the live.tab object.
focusbordercolor float Sets the border color in RGBA format to be used when the live.tab object has the focus.
mode int
def.:0
Sets the text tab layout mode. The modes are:

0 separate tab entries are equally spaced. This is the default.
1 separate tab entries are proportionally spaced according to the text.
Note: to add multiple words, use the backslash before a space (e.g. "one\ down")
multiline int
def.:1
Toggles allowing multiple lines of text in a tab. When set, you can resize the object to create multicoloum displays.
pictures symbol Sets the paths for pictures used when the usepicture attribute is set to 1. Bitmap images such as PNG or vectorized images (SVG) can be used.
spacing_x float
def.:6.
Sets the horizontal spacing for the live.tab object in pixels.
spacing_y float
def.:6.
Sets the vertical spacing for the live.tab object in pixels.
textcolor float Sets the display color for the live.tab object's text in RGBA format.
textoncolor float Sets the display color for the live.tab object's text when the tab is on in RGBA format.
usepicture int
def.:0
Toggles the use of the pictures instead of text display. Note that you need to provide enough pictures by setting the pictures attribute properly.

Information about attributes available for Parameter-aware objects

Information for box attributes common to all objects

Examples

See Also

Name Description
live.text A user interface button/toggle
live.toggle Switch between off and on (0 and 1)
tab A user interface tab/multiple button object