<?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="Live UI Objects">
	<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">
			Live UI Objects
		</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>
				Display and output a value
			</digest>
			<description>
				The word <m>assign</m>, followed by a floating point value, causes that value to be displayed and sent out the <o>live.button</o> object's outlet. The value, however, will not be stored. 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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.352941 0.352941 0.352941 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_led_bg" />
				<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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.427451 0.843137 1. 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_value_arc" />
				<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="annotation_name" get="1" set="1" type="symbol" size="1">
			<digest>
				Annotation Name
			</digest>
			<description>
				The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Description" />
				<attribute name="default" get="1" set="1" type="symbol" size="1" value="" />
				<attribute name="invisible" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Info View Title" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.352941 0.352941 0.352941 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_led_bg" />
				<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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.764706 0.764706 0.764706 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_control_zombie" />
				<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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.313725 0.313725 0.313725 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_contrast_frame" />
				<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="attr_attr_save" 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="defaultname" get="1" set="1" type="float" size="4" value="0.313725 0.313725 0.313725 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_focus_frame" />
				<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="parameter_mappable" get="1" set="1" type="int" size="1">
			<digest>
				Visible to Max Mapping
			</digest>
			<description>
				When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the <link module="core" name="mappings" type="vignette">Max Mappings feature</link>.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="atom" size="1" value="Parameter" />
				<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="Visible to Mapping" />
				<attribute name="order" get="1" set="1" type="int" size="1" value="10" />
				<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="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>
