<?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="live.dial" module="m4l" category="M4L U/I">
	<digest>
		Output numbers by moving a dial onscreen
	</digest>
	<description>
		<o>live.dial</o> works like a circular slider that outputs numbers according to its degree of rotation.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Live
		</metadata>
		<metadata name="tag">
			M4L U/I
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="int/float">
			<digest>
				Parameter Value (0.00-127.00)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="int/float">
			<digest>
				Parameter Value (0.00-127.00)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="int/float">
			<digest>
				Parameter Raw Value (0.-1.)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Live" action="live.dial" pic="live.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>
				Send the current value out the outlet
			</digest>
			<description>
				Sends the current value out the outlet.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Store, display, and output a value
			</digest>
			<description>
				The number received in the inlet is stored and displayed by the <o>live.dial</o> object and sent out the outlet.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Store, display, and output a value
			</digest>
			<description>
				The number received in the inlet is stored and displayed in the <o>live.dial</o> and sent out the outlet.
			</description>
		</method>
		<method name="assign">
			<arglist>
				<arg name="assign-input" optional="0" type="float" />
			</arglist>
			<digest>
				Store, display, and output a value
			</digest>
			<description>
				The word <m>assign</m>, followed by a floating point value, causes that value to be stored and displayed and sent out the <o>live.dial</o> object's outlet. If the Parameter Visibility attribute is set to Stored Only, the <m>assign</m> message will not add the new value to the Live application’s undo chain.
			</description>
		</method>
		<method name="init">
			<arglist />
			<digest>
				Restore and output the initial value
			</digest>
			<description>
				Restores and outputs the initial value.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Click and drag to change the dial value.
			</digest>
			<description>
				Click and drag in the dial to change the value. Hold down the Command key (Macintosh) or the Control key (Windows) for more precise mouse control.
			</description>
		</method>
		<method name="outputvalue">
			<arglist />
			<digest>
				Send the current value out the outlet
			</digest>
			<description>
				Sends the current value out the outlet.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="set-input" optional="0" type="float" />
			</arglist>
			<digest>
				Set a value without causing output
			</digest>
			<description>
				Sets the current value without causing any output.
			</description>
		</method>
		<method name="rawfloat">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Store a raw normalized value, convert to real, display, and output
			</digest>
			<description>
				A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, stored, displayed by <o>live.dial</o>, and the current value is sent out the outlet.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="active" get="1" set="1" type="int" size="1">
			<digest>
				Active mode enable
			</digest>
			<description>
				Toggles the object's active mode. When the <m>active</m> attribute is set to 0, the mouse action does not cause output and the inactive colors are used.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Behavior" />
				<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="Enabled" />
				<attribute name="paint" 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="activedialcolor" get="1" set="1" type="float" size="4">
			<digest>
				Dial color (active)
			</digest>
			<description>
				Sets the dial color in RGBA format to be used when the <m>active</m> attribute is set to 1.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.94902 0.376471 0. 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Dial Color (Active)" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="activeneedlecolor" get="1" set="1" type="float" size="4">
			<digest>
				Needle color (active)
			</digest>
			<description>
				Sets the needle color in RGBA format to be used when the <m>active</m> attribute is set to 1.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0. 0.019608 0.078431 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Needle Color (Active)" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="appearance" get="1" set="1" type="int" size="1">
			<digest>
				Display style
			</digest>
			<description>
				The word <m>appearance</m> followed by a number, sets the display style for the <o>live.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="int" size="1" value="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="3">
					<enumlist>
						<enum name="Vertical">
							<digest>
								Vertical dial display
							</digest>
							<description>
								Sets a vertical display (the default).
							</description>
						</enum>
						<enum name="Tiny">
							<digest>
								Tiny dial display
							</digest>
							<description>
								Sets a very tiny dial display.
							</description>
						</enum>
						<enum name="Panel">
							<digest>
								Panel dial display
							</digest>
							<description>
								Sets a dial display that includes a labeled panel.
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Display 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="bordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color
			</digest>
			<description>
				Sets the display color for the <o>live.dial</o> object's border in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.27451 0.32549 0.4 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Border Color" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="dialcolor" get="1" set="1" type="float" size="4">
			<digest>
				Dial color (inactive)
			</digest>
			<description>
				Sets the dial color in RGBA format displayed when the <m>active</m> attribute is set to 0.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.752941 0.784314 0.839216 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Dial Color (Inactive)" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="focusbordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color (focus)
			</digest>
			<description>
				Sets the display color for the focused <o>live.dial</o> object's border in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0. 0.019608 0.078431 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Border Color (Focus)" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="needlecolor" get="1" set="1" type="float" size="4">
			<digest>
				Needle color (inactive)
			</digest>
			<description>
				Sets the needle color in RGBA format. This is only used when the <m>active</m> attribute is set to 0.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.321569 0.321569 0.321569 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Needle Color (Inactive)" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="panelcolor" get="1" set="1" type="float" size="4">
			<digest>
				Panel color
			</digest>
			<description>
				Sets the panel color in RGBA format. This is only used when the <m>appearance</m> attribute is set to <m>panel</m> mode.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.709804 0.698039 0.694118 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Panel Color" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="showname" get="1" set="1" type="int" size="1">
			<digest>
				Display parameter name
			</digest>
			<description>
				Toggles the display of the parameter name. The default is 1 (displayed).
			</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="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Display Parameter Name" />
				<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="shownumber" get="1" set="1" type="int" size="1">
			<digest>
				Display parameter value
			</digest>
			<description>
				Toggles the display of the parameter value. The default is 1 (displayed).
			</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="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Display Parameter Value" />
				<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="textcolor" get="1" set="1" type="float" size="4">
			<digest>
				Text color
			</digest>
			<description>
				Sets the display color for the <o>live.dial</o> object's text in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0. 0.019608 0.078431 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Color" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="triangle" get="1" set="1" type="int" size="1">
			<digest>
				Display triangle
			</digest>
			<description>
				Toggles the display of a triangle in the dial display. When the <m>triangle</m> attribute is set to 1 and the triangle is displayed, clicking on it will restore the dial's initial value.
			</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="label" get="1" set="1" type="symbol" size="1" value="Display Triangle" />
				<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="tribordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Triangle border color
			</digest>
			<description>
				Sets the triangle border color in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.196078 0.196078 0.196078 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Triangle Border Color" />
				<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="rgba" />
			</attributelist>
		</attribute>
		<attribute name="tricolor" get="1" set="1" type="float" size="4">
			<digest>
				Triangle color default
			</digest>
			<description>
				Sets the display color for the <o>live.dial</o> object's triangle in RGBA format.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.6 0.6 0.6 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Triangle Color Default" />
				<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="rgba" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="live.dial.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="live.numbox" />
		<seealso name="live.slider" />
		<seealso name="dial" />
		<seealso name="basicchapter07" module="max" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="int/float">
			<description>
				Out left outlet: Numbers received in the object's inlet or produced by clicking or dragging on the <o>live.dial</o> object with the mouse are sent out the outlet. The value sent is an integer if the <m>Parameter Type</m> is set to <m>INT</m> or <m>ENUM</m>.
			</description>
		</entry>
		<entry name="float">
			<description>
				Out right outlet: When an output is triggered, a raw normalized value (between 0. and 1.) is sent out this outlet.
			</description>
		</entry>
	</misc>
</c74object>
