<?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="hover" module="max" category="U/I">
	<digest>
		Report object scripting names
	</digest>
	<description>
		Sends out the scripting names of any object over which the cursor is hovering.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				controls/attributes
			</digest>
			<description>
				controls/attributes
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Reports the scripting name of the object over which the mouse is hovering at any given time.
			</digest>
			<description>
				Reports the scripting name of the object over which the mouse is hovering at any given time.
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				The dumpout sends a 'none' message if no named objects are found under the mouse at a given location.
			</description>
		</outlet>
		<outlet id="2" type="OUTLET_TYPE">
			<digest>
				Scripting Name of Object Mouse Has Just Left
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="3" type="OUTLET_TYPE">
			<digest>
				none if Object Mouse Has Just Left Has No Scripting Name
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="mode" get="1" set="1" type="int" size="1">
			<digest>
				Tracking Mode
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Tracking Mode" />
				<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="hover.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="thispatcher" />
	</seealsolist>
	<discussion>
		The <o>hover</o> object does not output anything when the mouse is over objects that do not respond to mouse clicks. This includes the <o>panel</o> and <o>comment</o> objects as well as any object whose <i>Ignore Click</i> attribute is set. In addition, the <o>hover</o> object uses the <link name="object_ordering" module="core" type="vignette">front-to-back ordering</link> of objects in a patcher to determine the top-most object under the mouse.
	</discussion>
	<misc name="Output">
		<entry name="symbol">
			<description>
				Out left outlet: When the mouse enters the space over an object with a scripting name, hover outputs the scripting name of the object out the left outlet.
				<br />
				Out second outlet: When the mouse enters the space over an object without a scripting name, hover outputs the symbol none out the second outlet.
				<br />
				Out third outlet: When the mouse leaves the space over an object with a scripting name, hover outputs the scripting name of the object out the third outlet
				<br />
				Out right outlet: When the mouse leaves the space over an object without a scripting name, hover outputs the symbol none out the right outlet.
			</description>
		</entry>
	</misc>
</c74object>
