<?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="pattrmarker" module="max" category="Data">
	<digest>
		Provide pattr communication between patchers
	</digest>
	<description>
		The <o>pattrmarker</o> object associates a patcher with a global name, which can be used when looking up named objects. This permits, among other conveniences, name lookup and communication between two or more independent patcher hierarchies.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Data
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				set name
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="name" optional="0" type="symbol">
			<digest>
				Global access name
			</digest>
			<description>
				The name for the parent patcher of the <o>pattrmarker</o> object in the <o>pattr</o> global namespace.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="getmarkerlist">
			<arglist>
				<arg name="all" optional="1" type="int" />
			</arglist>
			<digest>
				Output all global pattr names
			</digest>
			<description>
				Reports a list of all registered names in the <o>pattr</o> global namespace from the <o>pattrmarker</o> object's outlet, prepended by the word <m>markerlist</m>. These names are reported whether they were registered via <o>pattrmarker</o> objects or via the <at>globalpatchername</at> attribute of the <o>patcher</o> object. With no argument, or an argument of <m>0</m>, the names of <o>pattrmarker</o> objects with the <at>invisible</at> attribute enabled <b>will not</b> appear in the reported list. With an argument of <m>1</m>, all names, regardless of the <at>invisible</at> status, will be reported.
			</description>
		</method>
		<method name="reveal">
			<arglist>
				<arg name="name" optional="0" type="symbol" />
			</arglist>
			<digest>
				Open a patcher view for a global name
			</digest>
			<description>
				Opens a view of the patcher referred to by the <m>global name</m> argument.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="invisible" get="1" set="1" type="int" size="1">
			<digest>
				Suppress visibility
			</digest>
			<description>
				When enabled, the name of this <o>pattrmarker</o> object will not appear in the list reported by the <m>getmarkerlist</m> message.
			</description>
		</attribute>
		<attribute name="name" get="1" set="1" type="symbol" size="1">
			<digest>
				Parent patcher name
			</digest>
			<description>
				The global name of the parent patcher of the <o>pattrmarker</o> object.
			</description>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="autopattr">
			Manage multiple objects at once, or expose them to <o>pattrstorage</o> 
		</seealso>
		<seealso name="pattr" />
		<seealso name="pattrforward" />
		<seealso name="pattrhub" />
		<seealso name="pattrstorage" />
	</seealsolist>
	<discussion>
		The <o>pattrmarker</o> object provides the same basic functionality of the <at>globalpatchername</at> attribute of the <o>patcher</o> object.
	</discussion>
</c74object>
