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

live.colors

Get the colors of the Live Skin

Description

Gets the color used in the current Live application color scheme (Skin).

Examples

Arguments

None.

Attributes

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic

Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points).

Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [float]

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

textjustification [int]

Text Justification

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

Messages

active_automation

Sends the active automation color out the outlet (in RGBA format).

assignment_text_bg

Sends the assignment text bg color out the outlet (in RGBA format).

contrast_frame

Sends the contrast frame color out the outlet (in RGBA format).

control_bg

Sends the control bg color out the outlet (in RGBA format).

control_fg

Sends the control fg color out the live.colors object's left outlet in RGBA format.

control_fg_off

Sends the control fg off color out the live.colors object's left outlet in RGBA format.

control_fg_on

Sends the control fg on color out the live.colors object's left outlet in RGBA format.

control_fg_zombie

Sends the control fg zombie color out the live.colors object's left outlet in RGBA format.

control_text_bg

Sends the control text bg color out the live.colors object's left outlet in RGBA format.

control_selection

Sends the control selection color out the live.colors object's left outlet in RGBA format.

control_zombie

Sends the control zombie color out the live.colors object's left outlet in RGBA format.

everything

Sends all the available colors out the outlet as a series of messages. Each message consists of the color scheme name followed by four floating-point values that describe the color scheme color in RGBA format.

inactive_automation

Sends the inactive automation color out the live.colors object's left outlet in RGBA format.

key_assignment

Sends the key assignment color out the live.colors object's left outlet in RGBA format.

macro_assigned

Sends the macro assigned color out the live.colors object's left outlet in RGBA format.

macro_assignment

Sends the macro assignment color out the live.colors object's left outlet in RGBA format.

midi_assignment

Sends the midi assignment color out the live.colors object's left outlet in RGBA format.

led_bg

Sends the led bg color out the live.colors object's left outlet in RGBA format.

numbox_triangle

Sends the numbox triangle color out the live.colors object's left outlet in RGBA format.

macro_title

Sends the macro title color out the live.colors object's left outlet in RGBA format.

selection

Sends the selection color out the live.colors object's left outlet in RGBA format.

surface_bg

Sends the surface bg color out the live.colors object's left outlet in RGBA format.

value_arc

Sends the value arc color out the live.colors object's left outlet in RGBA format.

value_bar

Sends the value bar color out the live.colors object's left outlet in RGBA format.

value_arc_zombie

Sends the value arc zombie color out the live.colors object's left outlet in RGBA format.

Output

bang

Out right outlet: A bang messages is sent out the right outlet if the Live colors are changed.

color

Out right outlet: The live.colors object sends a message composed of a color name followed by four floating point values that specify the RBGA value of the color out the left outlet in response to a query.

See Also

Name Description
Max For Live Max For Live
panel Colored background area
colorpicker Select and output a color
suckah Get a pixel from the display