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

live.tab Reference

A user interface tab/multiple button object

live.tab

Description

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

Examples

Arguments

None.

Attributes

active [int] (default: 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 [4 floats]

Sets the background color off displayed when the active attribute is set to 1.

activebgoncolor [4 floats]

Sets the background color on displayed when the active attribute is set to 1.

annotation_name [symbol] (default: )

The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.

appearance [int] (default: 0)

Display Style

Possible values:

0 = 'Default' ( Default appearance )
1 = 'LCD' ( LCD display style )

bgcolor [4 floats]

Sets the background color off displayed when the active attribute is set to 0.

bgoncolor [4 floats]

Sets the background color on displayed when the active attribute is set to 0.

blinktime [int] (default: 150)

Sets the blink time in milliseconds.

bordercolor [4 floats]

Sets the display color for the live.tab object's border in RGBA format.

button [int] (default: 0)

Toggles button mode for the live.tab object.

focusbordercolor [4 floats]

Sets the border color in RGBA format to be used when the live.tab object has the focus.

inactivelcdcolor [4 floats]8.0.0

Sets the background color on displayed when the active attribute is set to 0, and the appearance attribute is set to 1 (LCD).

inactivetextoffcolor [4 floats]8.0.0

Sets the text color off displayed when the active attribute is set to 0.

inactivetextoncolor [4 floats]8.0.0

Sets the text color on displayed when the active attribute is set to 0.

lcdbgcolor [4 floats]8.0.0

Sets the background color off displayed when the appearance attribute is set to 1 (LCD).

lcdcolor [4 floats]8.0.0

Sets the background color on displayed when the appearance attribute is set to 1 (LCD).

livemode [int]8.0.0

Adjusted margins and padding to match Live 10

mode [int] (default: 0)

Sets the text tab layout mode.

Possible values:

0 = 'Equal Spaced'
1 = 'Proportional' ( Proportional spacing )
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] (default: 1)

Toggles allowing multiple lines of text in a tab. When set, you can resize the object to create multi-column displays.

parameter_mappable [int] (default: 1)

When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature. (default = 1).

pictures [64 symbols]

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.

remapsvgcolors [int] (default: 0)8.0.0

Remap SVG Colors to use textcolor value

rounded [float]

Set the roundness of the border

spacing_x [float] (default: 6.)

Sets the horizontal spacing for the live.tab object in pixels.

spacing_y [float] (default: 6.)

Sets the vertical spacing for the live.tab object in pixels.

textcolor [4 floats]

Sets the display color for the live.tab object's text in RGBA format.

textoncolor [4 floats]

Sets the display color for the live.tab object's text when the tab is on in RGBA format.

usepicture [int] (default: 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.

usesvgviewbox [int] (default: 0)8.0.0

Use ViewBox attribute from the SVG file for formatting

Common Box Attributes

Parameter Attributes

Messages

bang

Sends the current item out the outlets.

int

Arguments

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

Arguments

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

Arguments

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.

rawfloat

Arguments

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, and the current value is sent out the outlet.

set

Arguments

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

Arguments

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

Arguments

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.

See Also

Name Description
Max For Live Max For Live
live.text
live.toggle
tab