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

dial Reference

Output numbers using an onscreen dial

dial

Description

Outputs numbers according to its degree of rotation. dial can be set with a certain range, offset, multiplier, as well as numerous visual settings.

Examples

Produce output by dragging onscreen... or use to display numbers passing through

Arguments

None.

Attributes

bgcolor [4 floats]

Sets the background color of the dial object in RGBA format.

clip [int] (default: 1)

Causes the dial object's vertical mouse tracking to operate with or without clipping within the specified output range. Clipping is enabled with a non-zero (the default) or disabled with a zero.

degrees [int] (default: 270)

Sets the limits of dial object's rotation.

floatoutput [atom_long] (default: 0)

Toggles floating-point output from the dial object. The default is 0 (off).

min [float] (default: 0.)

Sets a value that will be added to the dial object's value before it is sent out the outlet. The default is 0.

mode [int] (default: 0)7.0.0

Drawing Style

Possible values:

0 = 'Arc'
1 = 'Indicator'
2 = 'Pie Slice'
3 = 'Classic'
4 = 'Needle'
5 = 'Live'
6 = 'Pan'

mult [float] (default: 1.)

Sets a multiplier value for the dial object. The object's value will be multiplied by this number before it is sent out the outlet. The multiplication happens before the addition of the Offset value.

needlecolor [4 floats]

Sets the indicator color of the dial in RGBA format.

outlinecolor [4 floats]

Sets the outline color of the dial in RGBA format.

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.

size [float] (default: 128.)

Sets the range of the dial object. The default value is 128. Setting the size to 1 disables the dial visually (since it can only display one value). Any specified size less than 1 will be set to 2.

style [symbol] (default: )7.0.0

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

thickness [float] (default: 50.)7.0.0

Sets the thickness of the dial object.

vtracking [int] (default: 1)

Selects the mouse tracking mode.
circular: Causes the dial to use circular tracking. Moving the mouse clockwise in a circular arc relative to the control's center increases the control’s value, and moving it counterclockwise decreases its value.
vertical: (the default) Causes the dial to use vertical tracking. Moving the mouse up increases the object’s value, and moving it down decreases the value.

Possible values:

0 = 'Circular'
1 = 'Vertical'

Common Box Attributes

Parameter Attributes

Messages

bang

Sends out the number currently stored in dial.

int

Arguments

input [int]
The number received in the inlet is displayed graphically by dial, and is passed out its outlet. Optionally, dial can multiply the number by some amount and add an offset to it before sending it out the outlet.

The dial will also send out numbers in response to clicking or dragging on it directly with the mouse.

float

Arguments

input [float]
Converted to int.

(mouse)

The dial object will send out numbers in response to clicking or dragging on it directly with the mouse.

resize

Arguments

input [int]
The word resize, followed by a number, changes the size of the dial dial object in pixels.

set

Arguments

input [int]
The word set, followed by a number, changes the displayed value of the dial, without triggering output.

setminmax

Arguments

min-max-values [list]
The word setminmax, followed by two numbers, sets the low and high range values for the dial object. If the number list consists of floating point values, the floatoutput attribute will automatically be set.

Output

int

Numbers received in the inlet, or produced by clicking or dragging on dial with the mouse, are first multiplied by the multiplier, then have the offset added to them, then are sent out the outlet.

See Also

Name Description
Max For Live Max For Live
pictctrl
pictslider
rslider
slider
Max Basic Tutorial 7: Numerical User Interfaces Max Basic Tutorial 7: Numerical User Interfaces