<?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="jit.gl.picker" module="jit" category="Jitter OpenGL">
	<digest>
		Mouse picking in an opengl context
	</digest>
	<description>
		The <o>jit.gl.picker</o> object responds to mouse interaction in the destination by reporting the <at>name</at> of jit.gl (OB3D) objects intersecting with the mouse.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				messages in
			</digest>
			<description>
				TEXT_HERE
			</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>
				mouse picker messages
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--OB3D-->
	<OB3D />
	<!--MESSAGES-->
	<methodlist>
		<method name="touch">
			<arglist>
				<arg name="screen-x" type="long" />
				<arg name="screen-y" type="long" />
			</arglist>
			<digest>
				Detect and report object intersections from screen coordinate args
			</digest>
			<description>
				Detect and report object intersections from screen coordinate args. If an intersection is detected, the dump outlet outputs the object name.
			</description>
		</method>
		<method name="touch_ray">
			<arglist>
				<arg name="x-from" type="float" />
				<arg name="y-from" type="float" />
				<arg name="z-from" type="float" />
				<arg name="x-to" type="float" />
				<arg name="y-to" type="float" />
				<arg name="z-to" type="float" />
			</arglist>
			<digest>
				Detect and report object intersections from ray coordinate args
			</digest>
			<description>
				Detect and report object intersections from ray coordinate args. The first 3 args set the ray start position, and the last 3 set the ray end. If an intersection is detected, the dump outlet outputs the object name.
			</description>
		</method>
	</methodlist>
	<jittermethodlist>
		<jittermethod name="bang" />
		<jittermethod name="anim_grow" />
		<jittermethod name="anim_move" />
		<jittermethod name="anim_reset" />
		<jittermethod name="anim_turn" />
		<jittermethod name="draw" />
		<jittermethod name="drawimmediate" />
		<jittermethod name="drawraw" />
		<jittermethod name="exportattrs" />
		<jittermethod name="exportsummary" />
		<jittermethod name="getattributes" />
		<jittermethod name="getstate" />
		<jittermethod name="importattrs" />
		<jittermethod name="summary" />
		<jittermethod name="update_node" />
	</jittermethodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="filters" get="1" set="1" type="symbol" size="10">
			<digest>
				List of filterclass names to control picking
			</digest>
			<description>
				Specify a list of <at>filterclass</at> names that can be picked (default = all). Possible values include <ar>all</ar> and <ar>default</ar>. Additional values include any user-specified <at>filterclass</at> names (maximum allowed = 10).
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Filters" />
			</attributelist>
		</attribute>
		<attribute name="hover" get="1" set="1" type="int" size="1">
			<digest>
				Enable mouse hovering
			</digest>
			<description>
				Enable mouse hovering (default = 1)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Hover" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="ui_priority" get="1" set="1" type="int" size="1">
			<digest>
				UI Priority
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="UI Priority" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="anchor" />
		<jitterattribute name="anim" />
		<jitterattribute name="animmode" />
		<jitterattribute name="axes" />
		<jitterattribute name="dest_dim" />
		<jitterattribute name="drawto" />
		<jitterattribute name="enable" />
		<jitterattribute name="inherit_all" />
		<jitterattribute name="inherit_color" />
		<jitterattribute name="inherit_depth" />
		<jitterattribute name="inherit_fog" />
		<jitterattribute name="inherit_material" />
		<jitterattribute name="inherit_poly" />
		<jitterattribute name="inherit_texture" />
		<jitterattribute name="inherit_transform" />
		<jitterattribute name="layer" />
		<jitterattribute name="name" />
		<jitterattribute name="position" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example caption="Mouse picking in an opengl context" img="jit.gl.picker.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.phys.picker" />
		<seealso name="jit.gl.handle" />
	</seealsolist>
	<discussion>
		This object requires one argument: the name of a drawing context. A named drawing context is a named instance of a <o>jit.window</o>, <o>jit.pwindow</o>, or <o>jit.matrix</o> object that has an instance of the <o>jit.gl.render</o> object associated with it. Additionally it can reference the name of a <o>jit.gl.node</o> sub-context. This value may also be set via the OB3D <at>drawto</at> attribute. If no argument is present, the object is implicitly added to the first valid drawing context or sub-context found in the current patch or by searching up the patcher hierarchy.
	</discussion>
</c74object>
