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

live.numbox

Display and output a number

Description

The live.numbox object is a number box used to display, input, and output numbers.

Arguments

None.

Messages

bang Sends the current value out the outlet.
int input [int]
 The number received in the inlet is stored and displayed by the live.numbox object and sent out the outlet.
float input [float]
 The number received in the inlet is stored and displayed by the live.numbox object and 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.numbox 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 Restores and outputs the initial value.
(mouse) Click and drag the live.numbox display to change the value. Hold down the Command key (Macintosh) or the Control key (Windows) for more precise mouse control.
If the live.numbox object is set to store an initial value (set by checking the Initial Enable option in the object's Inspector), double-clicking in the triangle region will restore that value.
outputvalue Sends the current value out the outlet.
set set-input [float]
 Sets the current value without causing any output.
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.numbox 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 mode. When the active attribute 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.
activeslidercolor float Sets the slider color displayed when the active attribute is set to 1.
activetricolor float Sets the triangle color displayed when the actual value is equal to the initial value.
activetricolor2 float Sets the triangle color displayed when the actual value is different from the initial value and the active attribute is set to 1.
appearance int
def.:0 		Select different display modes:
mode 0 (default): Standard display
mode 1: Triangle display
mode 2: Slider display
bordercolor float Sets the display color for the live.numbox object's border in RGBA format.
focusbordercolor float Sets the border color in RGBA format to be used when the live.numbox has the focus.
textcolor float Sets the display color for the live.numbox object's text in RGBA format.
tricolor float Sets the triangle color displayed when the actual value is different from the initial value and the active attribute is set to 0.
tricolor2 float Sets the triangle color displayed when the actual value is different from the initial value and the active attribute is set to 0.

Information about attributes available for Parameter-aware objects

Information for box attributes common to all objects

Output

float: Out right outlet: when an output is triggered, a raw normalized value (between 0. and 1.) is sent out this outlet.
int/float: Out left outlet: Numbers received in the inlet, or produced by clicking or dragging on live.numbox with the mouse, are sent out the outlet. The value sent is an integer if the Parameter Type is set to INT or ENUM.

Examples

See Also

Name Description
live.dial Output numbers by moving a dial onscreen
live.slider Output numbers by moving a slider onscreen
number Display and output a number
flonum Display and output a number