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

live.button

Flash on any message, send a bang

Description

The live.button object is used to trigger other messages and processes.

Arguments

None.

Messages

bang Performs the same function as anything.
int input [int]
 Performs the same function as anything.
float input [float]
 Performs the same function as anything.
anything input [list]
 When any message is received in the inlet, the button flashes briefly and a bang is sent out the outlet.
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.button 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.
(mouse) Clicking on the live.button object will cause it to flash briefly and send a bang message out the outlet.

Attributes

Name Type g/s Description
active int
def.:1 		Toggles the object's active mode. When active is set to 0, mouse action does not cause output and the inactive colors are used.
activebgcolor float When the active attribute is set to 1, this attribute sets the background color displayed when the button is off in RGBA format.
activebgoncolor float When the active attribute is set to 1, this attribute sets the background color displayed when the button is on in RGBA format.
bgcolor float When the active attribute is set to 0, this attribute sets the background color displayed when the button is off in RGBA format.
bgoncolor float When the active attribute is set to 0, this attribute sets the background color displayed when the button is on in RGBA format.
blinktime int
def.:100 		Sets the blink time in milliseconds.
bordercolor float Sets the border color of live.button object in RGBA format. Note that this color is only used in the assignment mode within Live.
focusbordercolor float Sets the display color for the focused live.button object's border in RGBA format. Note that this color is only used in assignment mode within Live.
transition int
def.:0 		The parameter automation of live.button stores 0 and 1 values. The transition attribute specifies when a bang message will be sent to the outlet.
0 Zero->One: output a bang when the parameter value changes from 0. to 1.
1 One->Zero: output a bang when the parameter value changes from 1. to 0.
2 Both: output a bang when the parameter value changes from 0. to 1. and when it changes from 1. to 0.

Information about attributes available for Parameter-aware objects

Information for box attributes common to all objects

Output

bang: A mouse click or any message in the inlet causes the live.button object to flash and send a bang message.

Examples

See Also

Name Description
button Flash on any message, send a bang
trigger Send input to many places, in order
Max Basic Tutorial 2: Bang! Max Basic Tutorial 2: Bang!