<?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="pattrhub" module="max" category="Data">
	<digest>
		Access all pattr objects in a patcher
	</digest>
	<description>
		Centralizes communication with all pattr objects in a patcher.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Data
		</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>
				passout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				dumpout
			</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-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Pass through
			</digest>
			<description>
				<m>bang</m> is passed through the <o>pattrhub</o> object and output from its left outlet.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Pass through
			</digest>
			<description>
				An <m>int</m> is passed through the <o>pattrhub</o> object and output from its left outlet.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Pass through
			</digest>
			<description>
				<m>float</m> is passed through the <o>pattrhub</o> object and output from its left outlet.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Pass through
			</digest>
			<description>
				<m>list</m> is passed through the <o>pattrhub</o> object and output from its left outlet.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="arguments" optional="0" type="list" />
			</arglist>
			<digest>
				Send values to pattr objects
			</digest>
			<description>
				Incoming messages to the <o>pattrhub</o> object are analyzed. If the first element of the <m>message</m> matches the name of a <o>pattr</o>- or <o>autopattr</o>-maintained object, the subsequent arguments in the message set that object's value. If the first element of the message matches <m>get</m> (name), where (name) matches the name of a <o>pattr</o>- or <o>autopattr</o>-maintained object, the value of that object is sent from the <o>pattrhub</o> object's right outlet, preceded by the object's name. Otherwise, the message is passed through the <o>pattrhub</o> object and output from its left outlet.
			</description>
		</method>
		<method name="getattributes">
			<arglist>
				<!-- <arg name='target-name(s)' optional='0' type='list'/> -->
			</arglist>
			<digest>
				Output a list of pattr object names
			</digest>
			<description>
				The <m>getattributes</m> message causes a list of all <o>pattr</o>- or <o>autopattr</o>-maintained object names to be output from the <o>pattrhub</o> object's right outlet, preceded by the symbol <m>attributes</m>.
			</description>
		</method>
		<method name="getstate">
			<arglist>
				<!-- <arg name='target' optional='0' type='list'/> -->
			</arglist>
			<digest>
				Retrieve pattr objects and values
			</digest>
			<description>
				The <m>getstate</m> message causes a series of lists to be output from the <o>pattrhub</o> object's right outlet -- one for every <o>pattr</o>- or <o>autopattr</o>-maintained object in the patcher containing the <o>pattrhub</o> object. Each list begins with the name of the object, and is followed by the object's current value.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="patcher" get="1" set="1" type="symbol" size="1">
			<digest>
				Patcher reference
			</digest>
			<description>
				The word <m>patcher</m>, followed by a symbol describing a valid path to a patcher, sets the patcher referenced by the <o>pattrhub</o> object. The default is the special symbol <m>this</m>, which represents the patcher the pattrhub object resides within. The <o>pattrhub</o> object can refer to patchers other than the one in which the object resides. A double-colon syntax ('::') is used to separate levels of patcher hierarchy. See the <o>pattrhub</o> help file for further information on this feature.
			</description>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="pattrhub.png" />
	</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="pattrmarker" />
		<seealso name="pattrstorage" />
		<seealso name="pattrchapter01" module="max" type="tutorial" />
	</seealsolist>
	<discussion>
		The <o>pattrhub</o> object has a single inlet and two outlets. The inlet is used for all incoming messages. Messages that can be understood by a <o>pattr</o> object within the <o>pattrhub</o> object's patcher (e.g. <m>get</m> or <m>set</m> messages) will be automatically forwarded to that object, and any response will be sent from the <o>pattrhub</o> object's right outlet.
	</discussion>
	<misc name="Output">
		<entry name="anything">
			<description>
				Out left outlet: Any <m>message</m> not matching a <m>get</m> or <m>set</m> request to a <o>pattr</o>- or <o>autopattr</o>-maintained object in the <o>pattrhub</o> object's <m>patcher</m> is passed through the left outlet unchanged.
				<br />
				<br />
				Out right outlet: <m>get</m> queries to the a <o>pattr</o>- or <o>autopattr</o>-maintained object in the <o>pattrhub</o> object's <m>patcher</m> are output from the right outlet, also known as the <m>dumpout</m> outlet.
			</description>
		</entry>
	</misc>
</c74object>
