<?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.button" module="m4l" category="M4L U/I">
	<digest>
		Flash on any message, send a <m>bang</m> 
	</digest>
	<description>
		<o>live.button</o> is used to trigger other messages and processes.
	</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>
				Bang for Transition From 0 to 1
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Live" action="live.button" pic="live.button.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>
				Performs the same function as <m>anything</m>.
			</digest>
			<description>
				Performs the same function as <m>anything</m>.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Performs the same function as <m>anything</m>.
			</digest>
			<description>
				Performs the same function as <m>anything</m>.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Performs the same function as <m>anything</m>.
			</digest>
			<description>
				Performs the same function as <m>anything</m>.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Flash the button and send a <m>bang</m> message
			</digest>
			<description>
				When any message is received in the inlet, the button flashes briefly and a <m>bang</m> is sent out the outlet.
			</description>
		</method>
		<method name="assign">
			<arglist>
				<arg name="assign-input" optional="0" type="float" />
			</arglist>
			<digest>
				Store a value, display it, and send it
			</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.button</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="(mouse)">
			<digest>
				Click to flash the button and send a <m>bang</m> message
			</digest>
			<description>
				Clicking on the <o>live.button</o> object will cause it to flash briefly and send a <m>bang</m> message 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 <m>active</m> is set to 0, 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>
				When the <m>active</m> attribute is set to 1, this attribute sets the background color displayed when the button is off 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.4 0.4 0.4 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>
				When the <m>active</m> attribute is set to 1, this attribute sets the background color displayed when the button is on 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.94902 0.376471 0. 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="bgcolor" get="1" set="1" type="float" size="4">
			<digest>
				Background color off (inactive)
			</digest>
			<description>
				When the <m>active</m> attribute is set to 0, this attribute sets the background color displayed when the button is off 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.4 0.4 0.4 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>
				When the <m>active</m> attribute is set to 0, this attribute sets the background color displayed when the button is on 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.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="blinktime" get="1" set="1" type="int" size="1">
			<digest>
				Blink time
			</digest>
			<description>
				Sets the blink time in milliseconds.
			</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="100" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Blink Time in Milliseconds" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="bordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color
			</digest>
			<description>
				Sets the border color of <o>live.button</o> object in RGBA format. Note that this color is only used in the <m>assignment</m> mode within Live.
			</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 focused <o>live.button</o> object's border in RGBA format. Note that this color is only used in <m>assignment</m> mode within Live.
			</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="transition" get="1" set="1" type="int" size="1">
			<digest>
				Bang on value transition
			</digest>
			<description>
				The parameter automation of <o>live.button</o> stores 0 and 1 values. The <m>transition</m> attribute specifies when a <m>bang</m> message will be sent to the outlet.
				<br />
				<m>0 Zero-&gt;One</m>: output a <m>bang</m> when the parameter value changes from 0. to 1.
				<br />
				<m>1 One-&gt;Zero</m>: output a <m>bang</m> when the parameter value changes from 1. to 0.
				<br />
				<m>2 Both</m>: output a <m>bang</m> when the parameter value changes from 0. to 1. and when it changes from 1. to 0.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" 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>
								Output a <m>bang</m> on 0. to 1. transitions
							</digest>
							<description>
								Outputs a <m>bang</m> when the parameter value changes from 0. to 1.
							</description>
						</enum>
						<enum name="One-&gt;Zero">
							<digest>
								Output a <m>bang</m> on 1. to 0. transitions
							</digest>
							<description>
								Outputs a <m>bang</m> when the parameter value changes from 1. to 0.
							</description>
						</enum>
						<enum name="Both">
							<digest>
								Output a <m>bang</m> on 0. to 1. and 1. to 0. transitions
							</digest>
							<description>
								Outputs a <m>bang</m> when the parameter value changes from 0. to 1. and when it changes from 1. to 0.
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Bang when Transition from" />
				<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="live.button.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="button" />
		<seealso name="trigger" />
		<seealso name="basicchapter02" module="max" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="bang">
			<description>
				A mouse click or any message in the inlet causes the <o>live.button</o> object to flash and send a <m>bang</m> message.
			</description>
		</entry>
	</misc>
</c74object>
