A user interface button/toggle
bang | A bang message will toggle the state of the object. If it is off, it will switch on and output a 1. If it is on, it will switch off and output a 0. | |
int | input [int] |
In the | mode, any non-zero number will toggle the button to the "on" position, send the button text out the middle outlet and send a 1 out the left outlet. A zero sets the toggle to the "off" position, sends the button text out the middle outlet and sends a 0 out the left outlet.
float | input [float] |
Converted to | .
assign | assign-input [float] |
The word live.text object's outlet. If the Parameter Visibility attribute is set to Stored Only, the message will not add the new value to the Live application’s undo chain. | , followed by a floating point value, causes that value to be stored and displayed and sent out the
init | Restore and output the initial value. | |
(mouse) | In live.text highlights it for as long as the mouse is held down, sending the text out the second outlet and a message out the left outlet. In mode, a mouse click behaves the same as a live.toggle. When the mouse is clicked, the live.text object will send a 1 out the left outlet if the cursor is inside of the live.text object's rectangle, and a 0 if it is not. The button text is also sent out the second outlet on mouse click. |
mode, a mouse click on |
outputvalue | Sends the current value out the outlet. | |
set | set-input [float] |
In the | mode, the messages toggles the "on" or "off" state without sending anything out the outlets. The word , followed by any non-zero number, sets toggle to on. The message sets it to "off".
setsymbol | button-text-item [list] |
In the live.text to display that symbol and act as though the object were toggled to that state. | mode, the word , followed by a symbol that specifies a button text item, causes
symbol | button-text-item [list] |
In the live.text to display that symbol and act as though the object were toggled to that state. | mode, the word , followed by a symbol that specifies a button text item, causes
rawfloat | input-value [float] |
A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, and then functions like any other received int value in toggle mode. |
Name | Type | g/s | Description |
---|---|---|---|
active | int def.:1 |
Toggles the object's active mode. When | 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 | attribute is set to 1.|
activebgoncolor | float | Sets the background color on displayed when the | attribute is set to 1.|
activetextcolor | float | Sets the display color for the live.text object's text in RGBA format. | |
activetextoncolor | float | Sets the display color for the live.text object's text when it is on. | |
appearance | int def.:0 |
Defines the display style. The options are: 0: Default. The text appears with the boundaries of the text box. 1: Label. The text box appears as a square button, with the text appearing to the right. |
|
automation | symbol def.:val1 |
Sets the automation "off" label that will appear in Live. | |
automationon | symbol def.:val2 |
Sets the automation on label that will appear in Live. | |
bgcolor | float | Sets the background color "off" displayed when the | attribute is set to 0.|
bgoncolor | float | Sets the background color on displayed when the | attribute is set to 0.|
bordercolor | float | Sets the display color for the live.text object's border in RGBA format. | |
focusbordercolor | float | Sets the display color for the live.text object's border in RGBA format. | |
mode | int def.:1 |
Sets the button mode. Button modes are: 0: Button mode 1: Toggle (switch) mode |
|
pictures | symbol def.:<none> <none> |
Sets the paths for pictures used when the | attribute is set to 1. Bitmap images such as PNG or vectorized images (SVG) can be used.|
text | symbol def.:A |
Sets the button label when the button is in the off state. | |
textcolor | float | Sets the display color for the live.text object's text when the attribute is set to 0. | |
texton | symbol def.:B |
Sets the button label when the button is in the "on" state. | |
transition | int def.:0 |
The parameter automation of live.text stores 0 and 1 values. The attribute specifies when a will be sent to the outlet. : output a when the parameter value changes from 0. to 1. : output a when the parameter value changes from 1. to 0. : output a when the parameter value changes from 0. to 1. and when it changes from 1. to 0. |
|
usepicture | int def.:0 |
Toggles the use of pictures instead of text for display. Note that you need to provide enough pictures by setting the | attribute properly.
Name | Description |
---|---|
live.button | Flash on any message, send a bang |
live.tab | A user interface tab/multiple button object |
live.toggle | Switch between off and on (0 and 1) |
textbutton | A user interface button/toggle |