<?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.text" module="m4l" category="M4L U/I">
	<digest>
		A user interface button/toggle
	</digest>
	<description>
		<o>live.text</o> object is a user interface object used to create buttons and toggles.
	</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="INLET_TYPE">
			<digest>
				Messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Item Index
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Item Symbol
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette action="live.text" category="Live" pic="live.text.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>
				A bang message will toggle the state of the object.
			</digest>
			<description>
				A bang message will toggle the state of the object. If it is off, it will switch on and output a 1. If it is on, it will switch off and output a 0.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Toggle the button, send its text and a 0/1 message
			</digest>
			<description>
				In the <m>toggle</m> mode, any non-zero number will toggle the button to the &quot;on&quot; position, send the button text out the middle outlet and send a 1 out the left outlet. A zero sets the toggle to the &quot;off&quot; position, sends the button text out the middle outlet and sends a 0 out the left outlet.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Toggle the button, send its text and a 0/1 message
			</digest>
			<description>
				Converted to <m>int</m>.
			</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.text</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>
				Restore and output the initial value.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Highlight the text, send the text and a bang
			</digest>
			<description>
				In <m>button</m> mode, a mouse click on <o>live.text</o> highlights it for as long as the mouse is held down, sending the text out the second outlet and a <m>bang</m> message out the left outlet.
				<br />
				In <m>toggle</m> mode, a mouse click behaves the same as a <o>live.toggle</o>. When the mouse is clicked, the <o>live.text</o> object will send a 1 out the left outlet if the cursor is inside of the <o>live.text</o> object's rectangle, and a 0 if it is not. The button text is also sent out the second outlet on mouse click.
			</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>
				Toggle the state without sending output
			</digest>
			<description>
				In the <m>toggle</m> mode, the <m>set</m> messages toggles the &quot;on&quot; or &quot;off&quot; state without sending anything out the outlets. The word <m>set</m>, followed by any non-zero number, sets toggle to on. The message <m>set 0</m> sets it to &quot;off&quot;.
			</description>
		</method>
		<method name="setsymbol">
			<arglist>
				<arg name="button-text-item" optional="0" type="list" />
			</arglist>
			<digest>
				Choose a button by name and toggle it without causing output
			</digest>
			<description>
				In the <m>toggle</m> mode, the word <m>setsymbol</m>, followed by a symbol that specifies a button text item, causes <o>live.text</o> to display that symbol and act as though the object were toggled to that state.
			</description>
		</method>
		<method name="symbol">
			<arglist>
				<arg name="button-text-item" optional="0" type="list" />
			</arglist>
			<digest>
				Choose a button by name and toggle it
			</digest>
			<description>
				In the <m>toggle</m> mode, the word <m>symbol</m>, followed by a symbol that specifies a button text item, causes <o>live.text</o> to display that symbol and sends the current values out the outlets.
			</description>
		</method>
		<method name="rawfloat">
			<arglist>
				<arg name="input-value" optional="0" type="float" />
			</arglist>
			<digest>
				A raw normalized value (between 0. and 1.)
			</digest>
			<description>
				A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, and then functions like any other received int value in toggle mode.
			</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 <m>active</m> 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="activebgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color off (active)
			</digest>
			<description>
				Sets the background color off displayed 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.6 0.6 0.6 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color Off (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="activebgoncolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color on (active)
			</digest>
			<description>
				Sets the background color on displayed 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="1. 0.788235 0.027451 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color On (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="activetextcolor" get="1" set="1" type="float" size="4">
			<digest>
				Text color (Off)
			</digest>
			<description>
				Sets the display color for the <o>live.text</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. 0. 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Color (Off)" />
				<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="activetextoncolor" get="1" set="1" type="float" size="4">
			<digest>
				Text color (On)
			</digest>
			<description>
				Sets the display color for the <o>live.text</o> object's text when it is on.
			</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. 0. 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Color (On)" />
				<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>
				Appearance
			</digest>
			<description>
				Defines the display style. The options are:
				<br />
				<br />
				0: Default. The text appears with the boundaries of the text box.
				<br />
				1: Label. The text box appears as a square button, with the text appearing to the right.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" 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="2">
					<enumlist>
						<enum name="Default">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Label">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</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="automation" get="1" set="1" type="symbol" size="1">
			<digest>
				Automation Off Label
			</digest>
			<description>
				Sets the automation &quot;off&quot; label that will appear in Live.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="val1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Automation Off Label" />
				<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="text_onesymbol" />
			</attributelist>
		</attribute>
		<attribute name="automationon" get="1" set="1" type="symbol" size="1">
			<digest>
				Automation On Label
			</digest>
			<description>
				Sets the automation on label that will appear in Live.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="val2" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Automation On Label" />
				<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="text_onesymbol" />
			</attributelist>
		</attribute>
		<attribute name="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color off (inactive)
			</digest>
			<description>
				Sets the background color &quot;off&quot; 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.6 0.6 0.6 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color Off (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="bgoncolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color on (inactive)
			</digest>
			<description>
				Sets the background color on 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.490196 0.482353 0.478431 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background Color On (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="bordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color
			</digest>
			<description>
				Sets the display color for the <o>live.text</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.196078 0.196078 0.196078 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="focusbordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color (focus)
			</digest>
			<description>
				Sets the display color for the <o>live.text</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="mode" get="1" set="1" type="int" size="1">
			<digest>
				Mode
			</digest>
			<description>
				Sets the button mode. Button modes are:
				<br />
				<br />
				0: Button mode
				<br />
				1: Toggle (switch) mode
			</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="Button">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Toggle">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Mode" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="1" />
				<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="pictures" get="1" set="1" type="symbol" size="2">
			<digest>
				Images Files
			</digest>
			<description>
				Sets the paths for pictures used when the <m>usepicture</m> attribute is set to 1. Bitmap images such as PNG or vectorized images (SVG) can be used.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Pictures" />
				<attribute name="default" get="1" set="1" type="symbol" size="2" value="&lt;none&gt; &lt;none&gt;" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Images Files" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="2" />
				<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="rounded" get="1" set="1" type="float" size="1">
			<digest>
				Round-ness of Box Corners
			</digest>
			<description>
				Set the roundness of the border
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Appearance" />
				<attribute name="defaultname" get="1" set="1" type="float" size="1" value="0." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Round-ness of Box Corners" />
				<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="text" get="1" set="1" type="symbol" size="1">
			<digest>
				Text Off Label
			</digest>
			<description>
				Sets the button label when the button is in the off state.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="A" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text Off Label" />
				<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="textcolor" get="1" set="1" type="float" size="4">
			<digest>
				Text color (inactive)
			</digest>
			<description>
				Sets the display color for the <o>live.text</o> object's text 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="Text 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="texton" get="1" set="1" type="symbol" size="1">
			<digest>
				Text On Label
			</digest>
			<description>
				Sets the button label when the button is in the &quot;on&quot; state.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="B" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Text On Label" />
				<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="transition" get="1" set="1" type="int" size="1">
			<digest>
				Bang when a transition occurs
			</digest>
			<description>
				The parameter automation of <o>live.text</o> stores 0 and 1 values. The <m>transition</m> attribute specifies when a <m>bang</m> will be sent to the outlet.
			</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="0" />
				<attribute name="enumvals" get="1" set="1" type="atom" size="3">
					<enumlist>
						<enum name="Zero-&gt;One">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="One-&gt;Zero">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="Both">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Bang when Transition from" />
				<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>
		<attribute name="usepicture" get="1" set="1" type="int" size="1">
			<digest>
				Use Pictures
			</digest>
			<description>
				Toggles the use of pictures instead of text for display. Note that you need to provide enough pictures by setting the <m>pictures</m> attribute properly.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Pictures" />
				<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="Use Pictures" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="1" />
				<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>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="live.text.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="live.button" />
		<seealso name="live.tab" />
		<seealso name="live.toggle" />
		<seealso name="textbutton" />
	</seealsolist>
</c74object>
