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

number Reference

Display and output a number

number

Description

Displays, inputs, and outputs integer numbers.

Examples

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

Arguments

None.

Attributes

bgcolor [4 floats]

Sets the color for the number box object's displayed/unclicked background.

cantchange [int] (default: 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] (default: 0)

Sets characteristics of the appearance and behavior of the number box. The options are:
Decimal: (the default) Shows numbers in decimal form.
Hex: Shows numbers in hexadecimal, useful for MIDI-related applications.
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.
Binary: Shows numbers as ones and zeroes.
MIDI Note Names: Shows numbers according to their MIDI pitch value, with 60 displayed as C3.
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.

Possible values:

0 = 'Decimal (Integer)'
1 = 'Hex'
2 = 'Roland Octal'
3 = 'Binary'
4 = 'MIDI'
5 = 'MIDI (C4)'
6 = 'Decimal (Floating-Point)'

htricolor [4 floats]

Sets the highlight color for the triangle inside the number box object that indicates that the contents are editable in RGBA format. The htricolor attribute is mapped to the selectioncolor style color.

maximum [atom] (default: <none>)

Sets the maximum value that can be displayed or sent out by the number box.

minimum [atom] (default: <none>)

Sets the minimum value that can be displayed or sent out by the number box.

mousefilter [int] (default: 0)7.2.0

Send Value on Mouse Up

numdecimalplaces [int] (default: 0)

Number of Decimal Places

outputonclick [int] (default: 0)

Toggles sending the current value when you click on the number box.

parameter_enable [int]

Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment.

parameter_mappable [int] (default: 1)

When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature.

style [symbol] (default: )7.0.0

Sets the style to be applied to the object. Styles can be set using the Format palette.

textcolor [4 floats]

Sets the color for the number box object's displayed/unclicked number values. The textcolor attribute is mapped to the textcolor_inverse style color.

triangle [int] (default: 1)

Toggles the drawing of a triangular arrow pointing to the number in the number box. The default is 1 (draw the triangle).

tricolor [4 floats]

Sets the color for the triangle inside the number box object that indicates that the contents are editable. The tricolor attribute is mapped to the accentcolor style color.

triscale [float] (default: 1.)

Scales the size of the triangle drawn in the number box.

Common Box Attributes

Parameter Attributes

Messages

bang

Sends the currently displayed number out the outlet.

int

Arguments

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

Arguments

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

Arguments

maximum [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

Arguments

minimum [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. You can also click on the number box and use the up or down arrows on your keyboard to increase or decrease the number by one. Shift+arrow jumps by tens. For the float number box, alt/option+arrow jumps by tenths.

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

Arguments

input [int]
The word set, followed by a number, sets the stored and displayed value to that number without triggering output.

Output

bang

When the object has focus and the tab key is pressed, a bang will be sent out the right outlet.

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.

See Also

Name Description
float
int
Max Basic Tutorial 3: Numbers and Lists Max Basic Tutorial 3: Numbers and Lists