live.dial
Description
live.dial works like a circular slider that outputs numbers according to its degree of rotation.
Examples

Arguments
None.
Attributes
active [int] (default: 1)
Toggles the object's active mode. When the
attribute is set to 0, the mouse action does not cause output and the inactive colors are used.activedialcolor [4 floats]
Sets the dial color in RGBA format to be used when the
attribute is set to 1.activefgdialcolor [4 floats]8.0.0
Sets the foreground dial color in RGBA format to be used when the
attribute is set to 1.activeneedlecolor [4 floats]
Sets the needle color in RGBA format to be used when the
attribute is set to 1.annotation_name [symbol] (default: )
The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.
appearance [int] (default: 0)
The word live.dial object.
Possible values:
0 = 'Vertical'
( Vertical dial display )
Sets a vertical display (the default).
1 = 'Tiny'
( Tiny dial display )
Sets a very tiny dial display.
2 = 'Panel'
( Panel dial display )
Sets a dial display that includes a labeled panel.
3 = 'Large'
( Large dial display )
Sets a large dial display.
bordercolor [4 floats]
Sets the display color for the live.dial object's border in RGBA format.
dialcolor [4 floats]
Sets the dial color in RGBA format displayed when the
attribute is set to 0.fgdialcolor [4 floats]8.0.0
Sets the foreground dial color in RGBA format displayed when the
attribute is set to 0.focusbordercolor [4 floats]
Sets the display color for the focused live.dial object's border in RGBA format.
needlecolor [4 floats]
Sets the needle color in RGBA format. This is only used when the
attribute is set to 0.panelcolor [4 floats]
Sets the panel color in RGBA format. This is only used when the
attribute is set to mode.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.
showname [int] (default: 1)
Toggles the display of the parameter name. The default is 1 (displayed).
shownumber [int] (default: 1)
Toggles the display of the parameter value. The default is 1 (displayed).
textcolor [4 floats]
Sets the display color for the live.dial object's text in RGBA format.
triangle [int] (default: 0)
Toggles the display of a triangle in the dial display. When the
attribute is set to 1 and the triangle is displayed, clicking on it will restore the dial's initial value.tricolor [4 floats]
Sets the display color for the live.dial object's triangle in RGBA format when the dial is in the default position.
Common Box Attributes
Parameter Attributes
Messages
bang
int
Arguments
float
Arguments
assign
Arguments
init
(mouse)
outputvalue
rawfloat
Arguments
set
Arguments
Output
float
Out right outlet: When an output is triggered, a raw normalized value (between 0. and 1.) is sent out this outlet.
int/float
Out left outlet: Numbers received in the object's inlet or produced by clicking or dragging on the live.dial object with the mouse are sent out the outlet. The value sent is an integer if the is set to or .
See Also
Name | Description |
---|---|
Max For Live | Max For Live |
live.numbox | |
live.slider | |
dial | |
Max Basic Tutorial 7: Numerical User Interfaces | Max Basic Tutorial 7: Numerical User Interfaces |