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

flonum

Display and output a number

Description

flonum is a number-box used to display, input, and output floating-point numbers.

Note: The way floating-point numbers are stored on your computer means that not all numbers can be represented. This means that you will often see values such as 2.3 displayed as 2.29999. Clicking in the Float Display Correction checkbox in the Interface pane of the Max Preferences Window will make the Max application round numbers and truncates them at what it guesses is the least significant digit.

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
Toggles the ability to disallow changes with the mouse or the computer keyboard. The default is 0 (mouse/keyboard output active).
hbgcolor float Sets the RGBA values for the background of the number box when it is highlighted or being updated.
htextcolor float Sets the RGBA values for the number values displayed by the number box when it is highlighted or being updated.
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 the ability to send a number only when the mouse button is released, rather than continuously. The default is 0 (continuous display).
numdecimalplaces int
def.:0
Specifies the number of decimal places used when displaying a value.
outputonclick int
def.:0
Toggles outputting a value on mouse click.
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