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

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 .
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.
: Causes the 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.
: (the default) Causes the 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
int
Arguments
The dial will also send out numbers in response to clicking or dragging on it directly with the mouse.
float
Arguments
(mouse)
resize
Arguments
set
Arguments
setminmax
Arguments
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 |