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

number

Display and output a number

Description

number is a number-box used to display, input, and output integer numbers.

Arguments

None.

Messages

bang Sends the currently displayed number out the outlet.
int input [int]
The number received in the inlet is stored and displayed in the number box and sent out the outlet. A float is converted to int by an int number box, and vice versa.
float input [float]
The number received in the inlet is stored and displayed in the number box and sent out the outlet. A float is converted to int by an int number box, and vice versa.
max maximum-value [list]
The word max, followed by a number, sets the maximum value that can be displayed or sent out by the number box. The word max by itself sets the maximum to None (removes a prior maximum value constraint).
min minimum-value [list]
The word min, followed by a number, sets the minimum value that can be displayed or sent out by the number box. The word min by itself sets the minimum to None (removes a prior minimum value constraint).
(mouse) Clicking and dragging up and down on the number box with the mouse (when the patcher window is locked) moves the displayed value up and down, and outputs the new values continuously.
In the float number box, dragging to the left of the decimal point changes the value in increments of 1. Dragging to the right of the decimal point changes the fractional part of the number in increments of 0.01.
When the active patcher window is locked, numbers can be entered into a number box by clicking on it with the mouse and typing in a number on the computer keyboard. Typing the Return or Enter keys on Macintosh or the Enter key on Windows, or clicking outside the number box, sends the number out the outlet.
select The word select will make the number box active so that you can type numbers straight into it (click on any empty space in a locked patcher to deselect it).
set set-input [int]
The word set, followed by a number, sets the stored and displayed value to that number without triggering output.

Attributes

Name Type g/s Description
bgcolor float Sets the color for the number box object's displayed/unclicked background.
bordercolor float Sets the color for the number box object's outline.
cantchange int
def.:0
The word cantchange, followed by a zero or one, toggles the ability to disallow changes with the mouse or the computer keyboard. The default is 0 (mouse/keyboard output active).
format int
def.:0
Sets characteristics of the appearance and behavior of the number box. The options are:
0 Decimal: (the default) Shows numbers in decimal form.
1 Hex: Shows numbers in hexadecimal, useful for MIDI-related applications.
2 Roland Octal: Shows numbers in a format used by some hardware devices where each digit ranges from 1 to 8; 11 is 0 and 88 is 63.
3 Binary: Shows numbers as ones and zeroes.
4 MIDI Note Names: Shows numbers according to their MIDI pitch value, with 60 displayed as C3.
5 Note Names C4: Same as MIDI Note Names except that 60 is displayed as C4.
With all display modes, numbers must be typed in the format in which they are displayed.
hbgcolor float Sets the color for the number box object's clicked-on background.
htextcolor float Sets the color for the number box object's clicked-on number.
htricolor float Sets the highlight color for the triangle inside the number box object that indicates that the contents are editable.
maximum atom
def.:<none>
Sets the maximum value that can be displayed or sent out by the number box.
minimum atom
def.:<none>
Sets the minimum value that can be displayed or sent out by the number box.
mouseup int
def.:0
Toggles sending the current value on Mouse Up.
outputonclick int
def.:0
Toggles sending the current value when you click on the number box.
textcolor float Sets the color for the number box object's displayed/unclicked number values.
triangle int
def.:1
Toggles the drawing of a triangular arrow pointing to the number in the number box. The default is 1 (draw the triangle).
tricolor float Sets the color for the triangle inside the number box object that indicates that the contents are editable.
triscale float
def.:1.
Scales the size of the triangle drawn in the number box.

Legacy

brgba list (3 ints) brgba is a legacy RGB alias for the bgcolor RGBA attribute. See here for more information.
frgba list (3 ints) frgba is a legacy RGB alias for the textcolor RGBA attribute. See here for more information.
rgba2 list (3 ints) rgba2 is a legacy RGB alias for the htextcolor RGBA attribute. See here for more information.
rgba3 list (3 ints) rgba3 is a legacy RGB alias for the hbgcolor RGBA attribute. See here for more information.
rgba4 list (3 ints) rgba4 is a legacy RGB alias for the bordercolor RGBA attribute. See here for more information.

Information for box attributes common to all objects

Menu Items

Name Description
Color Choosing the Color... menu item from the Object menu when the object is selected opens a color picker, permitting adjustment to the appearance of the number box.

Output

float: The number displayed in the number box is sent out the outlet. Numbers received in the inlet or typed on the computer keyboard can exceed the limits of the number box, but the value that gets stored, displayed, and sent out will automatically be limited to the specified range.
int: The number displayed in the number box is sent out the outlet. Numbers received in the inlet or typed on the computer keyboard can exceed the limits of the number box, but the value that gets stored, displayed, and sent out will automatically be limited to the specified range.

Examples

Displays numbers passing through.... Can be used to output numbers

See Also

Name Description
float Store a decimal number
int Store an integer value
Max Basic Tutorial 3: Numbers and Lists Max Basic Tutorial 3: Numbers and Lists