<?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.menu" module="m4l" category="Live UI Objects">
	<digest>
		Dropdown menu
	</digest>
	<description>
		The <o>live.menu</o> object can be used to display text associated with incoming numbers and provide a general user interface. Item numbering starts from zero (0).
	</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>
				Item Index
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Item Symbol
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="2" type="OUTLET_TYPE">
			<digest>
				Parameter Raw Value (0.-1.)
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Live" action="live.menu" pic="live.menu.svg" />
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="OBJARG_NAME" optional="0" type="OBJARG_TYPE">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--parameter-->
	<parameter />
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Send the current item out the outlets
			</digest>
			<description>
				Sends the current item out the outlets.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="item-index" optional="0" type="int" />
			</arglist>
			<digest>
				Display a menu item and output its index and symbol
			</digest>
			<description>
				An integer specifies a menu item to be displayed, and causes the <o>live.menu</o> object to display that item and output information about its index and the symbol associated with that menu index. Menu item numbering starts at 0.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="item-index" optional="0" type="float" />
			</arglist>
			<digest>
				Display a menu item and output its index and symbol
			</digest>
			<description>
				Converted to <m>int</m>.
			</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.menu</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="init">
			<arglist />
			<digest>
				Restore and output the initial value
			</digest>
			<description>
				Restore and output the initial value.
			</description>
		</method>
		<method name="(mouse)">
			<digest>
				Click to select a menu itam
			</digest>
			<description>
				Clicking with the mouse lets you select a menu item to be displayed and outputs information about its index and the symbol associated with that menu index.
			</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="rawfloat">
			<arglist>
				<arg name="input-value" 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.menu</o>, and the current item is sent out the outlets.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="item index" optional="0" type="float" />
			</arglist>
			<digest>
				Display a menu item without triggering output
			</digest>
			<description>
				The word <m>set</m>, followed by a number, specifies a menu item to be displayed by the <o>live.menu</o> object without triggering any output.
			</description>
		</method>
		<method name="setsymbol">
			<arglist>
				<arg name="menu item" optional="0" type="list" />
			</arglist>
			<digest>
				Select a menu item for display without triggering output
			</digest>
			<description>
				The word <m>setsymbol</m>, followed by a message, selects a menu item to be displayed by name without triggering any output.
			</description>
		</method>
		<method name="symbol">
			<arglist>
				<arg name="menu item" optional="0" type="list" />
			</arglist>
			<digest>
				Select a menu item for display by name
			</digest>
			<description>
				The word <m>symbol</m>, followed by a message, selects a menu item to be displayed by name. If the item is found, the menu item is displayed and information about its index and the symbol associated with that menu index.
			</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 <at>active</at> attribute is set to 0, the mouse action does not cause output and the inactive colors are used. The default is 1 (on).
			</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 (active)
			</digest>
			<description>
				Sets the background color of the display when the <at>active</at> attribute is set to 1.
			</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_text_bg" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Background 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="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="appearance" get="1" set="1" type="int" size="1">
			<digest>
				Display Style
			</digest>
			<description>
				Defines the display style.
			</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="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>
								The text appears with the boundaries of the text box. All attributes, except those with 'lcd' in the name, are functional.
							</description>
						</enum>
						<enum name="LCD">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								The text appears with the boundaries of the text box. To adjust the colors of the object you must use the attributes with 'lcd' in the name, such as <at>inactivelcdcolor</at>, <at>lcdbgcolor</at>, and <at>lcdcolor</at>.
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<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.menu</o> object's border 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.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 border color in RGBA format to be used when the <o>live.menu</o> has the focus.
			</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="hltcolor" get="1" set="1" type="float" size="4">
			<digest>
				Highlight color
			</digest>
			<description>
				Sets the highlight color in RGBA format to be used when you select an item with the mouse.
			</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.780392 0.929412 1. 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_selection" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Highlight 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="hlttextcolor" get="1" set="1" type="float" size="4">
			<digest>
				Highlight Text Color
			</digest>
			<description>
				Sets the highlight text color in RGBA format to be used when you select an item with the mouse.
			</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. 0. 0. 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_control_text_selection" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Highlight 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="inactivelcdcolor" get="1" set="1" type="float" size="4">
			<digest>
				LCD Color (Inactive)
			</digest>
			<description>
				Sets the text and highlight color when the <at>appearance</at> attribute is set to 1:LCD, and the <at>active</at> attribute is set to 0.
			</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.54902 0.54902 0.54902 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_lcd_control_fg_zombie" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="LCD 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="lcdbgcolor" get="1" set="1" type="float" size="4">
			<digest>
				LCD Background Color
			</digest>
			<description>
				Sets the background color of the display when the <at>appearance</at> attribute is set to 1:LCD.
			</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.156863 0.156863 0.156863 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_lcd_bg" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="LCD Background 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="lcdcolor" get="1" set="1" type="float" size="4">
			<digest>
				LCD Color
			</digest>
			<description>
				Sets the text and highlight color when the <at>appearance</at> attribute is set to 1:LCD.
			</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="1. 0.709804 0.196078 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_lcd_control_fg" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="LCD 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="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="pictures" get="1" set="1" type="symbol" size="64">
			<digest>
				Images Files
			</digest>
			<description>
				Sets the paths of any pictures used when the <at>usepicture</at> 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="label" get="1" set="1" type="symbol" size="1" value="Images Files" />
				<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="remapsvgcolors" get="1" set="1" type="int" size="1">
			<digest>
				Remap SVG Colors
			</digest>
			<description>
				Sets the color that the SVG image will use. When <at>usepicture</at> is set to 1, and <at>remapsvgcolors</at> is set to 0, the color supplied by the SVG file are used; if set to 1, the color attributes for the appropriate display mode are used.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Pictures" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Remap SVG Colors" />
				<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.menu</o> object's text 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. 0. 0. 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_control_fg" />
				<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="tricolor" get="1" set="1" type="float" size="4">
			<digest>
				Triangle Color Default
			</digest>
			<description>
				Sets the triangle color 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. 0. 0. 1." />
				<attribute name="dynamiccolor_default" get="1" set="1" type="symbol" size="1" value="live_control_fg" />
				<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>
		<attribute name="usepicture" get="1" set="1" type="int" size="1">
			<digest>
				Use Pictures
			</digest>
			<description>
				Toggles the use of the pictures instead of text display. Note that you need to provide enough pictures by setting the <at>pictures</at> 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="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" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="usesvgviewbox" get="1" set="1" type="int" size="1">
			<digest>
				Use SVG ViewBox
			</digest>
			<description>
				Sets the viewbox for the svg files when <at>usepicture</at> is set to 1. If <at>usesvgviewbox</at> is set to 0, Max determines the viewbox; if set to 1, uses the viewbox flag supplied by the svg file.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Pictures" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="0" />
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="8.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Use SVG ViewBox" />
				<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.menu.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="live.tab" />
		<seealso name="umenu" />
	</seealsolist>
	<misc name="Output">
		<entry name="int">
			<description>
				Out left outlet: The number of the selected menu item is sent out. Menu items are numbered beginning with 0.
			</description>
		</entry>
		<entry name="anything">
			<description>
				Out middle outlet: The text of the selected menu item is sent out as a message.
			</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>
