<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="dial" module="max" category="U/I">
	<digest>
		Output numbers using an onscreen dial
	</digest>
	<description>
		Outputs numbers according to its degree of rotation. <o>dial</o> can be set with a certain range, offset, multiplier, as well as numerous visual settings.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			U/I
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Dial Displays Value Received
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Outputs Value Received or Entered
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Sliders" action="dial" pic="dial.svg" />
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--parameter-->
	<parameter />
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Output the current value
			</digest>
			<description>
				Sends out the number currently stored in <o>dial</o>.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Display and cause output
			</digest>
			<description>
				The number received in the inlet is displayed graphically by <o>dial</o>, and is passed out its outlet. Optionally, <o>dial</o> can multiply the number by some amount and add an offset to it before sending it out the outlet.
				<br />
				<br />
				The <o>dial</o> will also send out numbers in response to clicking or dragging on it directly with the mouse.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Display and cause output
			</digest>
			<description>
				Converted to <m>int</m>.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Adjust the current value
			</digest>
			<description>
				The <m>dial</m> object will send out numbers in response to clicking or dragging on it directly with the mouse.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Display and store value, but do not output
			</digest>
			<description>
				The word <m>set</m>, followed by a number, changes the displayed value of the <o>dial</o>, without triggering output.
			</description>
		</method>
		<method name="setminmax">
			<arglist>
				<arg name="min-max-values" optional="0" type="list" />
			</arglist>
			<digest>
				Set the minimum and maximum values
			</digest>
			<description>
				The word <m>setminmax</m>, followed by two numbers, sets the low and high range values for the <o>dial</o> object. If the number list consists of floating point values, the <i>floatoutput</i> attribute will automatically be set.
			</description>
		</method>
		<method name="resize">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Change the display size
			</digest>
			<description>
				The word <m>resize</m>, followed by a number, changes the size of the <o>dial</o> dial object in pixels.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color
			</digest>
			<description>
				Sets the background color of the <o>dial</o> object in RGBA format.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color" />
				<attribute name="legacydefault" get="1" set="1" type="float" size="4" value="0.862 0.862 0.862 1." />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="rect_fill" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="clip" get="1" set="1" type="int" size="1">
			<digest>
				Value clipping flag
			</digest>
			<description>
				Causes the <o>dial</o> 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.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Clip Dial Values" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="degrees" get="1" set="1" type="int" size="1">
			<digest>
				Degrees of rotation
			</digest>
			<description>
				Sets the limits of <o>dial</o> object's rotation.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="270" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Degrees Used in Circle" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="3" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="fgcolor" get="1" set="1" type="atom" size="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="obsolete" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="floatoutput" get="1" set="1" type="atom_long" size="1">
			<digest>
				Floating-point flag
			</digest>
			<description>
				Toggles floating-point output from the <o>dial</o> object. The default is 0 (off).
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="atom_long" size="1" value="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Float Output" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="min" get="1" set="1" type="float" size="1">
			<digest>
				Minimum value offset
			</digest>
			<description>
				Sets a value that will be added to the <o>dial</o> object's value before it is sent out the outlet. The default is 0.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="0." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Minimum Value" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="5" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="mode" get="1" set="1" type="int" size="1">
			<digest>
				Drawing Style
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="3">
					<enumlist>
						<enum name="Arc">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Indicator">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Pie Slice">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Drawing Style" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="enumindex" />
			</attributelist>
		</attribute>
		<attribute name="mult" get="1" set="1" type="float" size="1">
			<digest>
				Value multiplier
			</digest>
			<description>
				Sets a multiplier value for the <o>dial</o> 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.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Step Mulitplier" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="6" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="needlecolor" get="1" set="1" type="float" size="4">
			<digest>
				Indicator Color
			</digest>
			<description>
				Sets the indicator color of the dial in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Indicator Color" />
				<attribute name="legacydefault" get="1" set="1" type="float" size="4" value="0.662 0.662 0.662 1." />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="circle_frame" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
				<attribute name="stylemap" get="1" set="1" type="symbol" size="1" value="color" />
			</attributelist>
		</attribute>
		<attribute name="outlinecolor" get="1" set="1" type="float" size="4">
			<digest>
				Outline color
			</digest>
			<description>
				Sets the outline color of the dial in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Outline Color" />
				<attribute name="legacydefault" get="1" set="1" type="float" size="4" value="0.78 0.78 0.78 1." />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="preview" get="1" set="1" type="symbol" size="1" value="circle_frame" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="set" get="1" set="1" type="pointer" size="1" value="pointer" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
				<attribute name="stylemap" get="1" set="1" type="symbol" size="1" value="elementcolor" />
			</attributelist>
		</attribute>
		<attribute name="parameter_enable" get="1" set="1" type="int" size="1">
			<digest>
				Enable parameter mode handling
			</digest>
			<description>
				Enables use of this object with <link type="vignette" module="core" name="live_parameters">Max for Live Parameters</link> and allows for <link type="vignette" module="core" name="parameter_enable">setting initial parameter values</link> in the Max environment.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Parameter" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Parameter Mode Enable" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="size" get="1" set="1" type="float" size="1">
			<digest>
				Value range
			</digest>
			<description>
				Sets the range of the <o>dial</o> object. The default value is 128. Setting the size to 1 disables the <o>dial</o> visually (since it can only display one value). Any specified size less than 1 will be set to <m>2</m>.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="128." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Number of Steps / Range" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="4" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="style" get="1" set="1" type="symbol" size="1">
			<digest>
				Style
			</digest>
			<description>
				Sets the <link type="vignette" module="core" name="styles">style</link> to be applied to the object. Styles can be set using the <link type="vignette" module="core" name="format_palette">Format palette</link>.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Appearance" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Style" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="style" />
			</attributelist>
		</attribute>
		<attribute name="thickness" get="1" set="1" type="float" size="1">
			<digest>
				Circle Width (Percent)
			</digest>
			<description>
				Sets the thickness of the <o>dial</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Appearance" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="50." />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Circle Width (Percent)" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="vtracking" get="1" set="1" type="int" size="1">
			<digest>
				d Mouse tracking mode
			</digest>
			<description>
				Selects the mouse tracking mode.
				<br />
				<m>circular</m>: Causes the <m>dial</m> 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.
				<br />
				<m>vertical</m>: (the default) Causes the <m>dial</m> to use vertical tracking. Moving the mouse up increases the object’s value, and moving it down decreases the value.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="2">
					<enumlist>
						<enum name="Circular">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Vertical">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Mouse Tracking" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="2" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="enumindex" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="dial.png" caption="Produce output by dragging onscreen... or use to display numbers passing through" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="pictctrl" />
		<seealso name="pictslider" />
		<seealso name="rslider" />
		<seealso name="slider" />
		<seealso name="basicchapter07" module="max" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="int">
			<description>
				Numbers received in the inlet, or produced by clicking or dragging on <o>dial</o> with the mouse, are first multiplied by the multiplier, then have the offset added to them, then are sent out the outlet.
			</description>
		</entry>
	</misc>
</c74object>
