<?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="udpreceive" module="max" category="Devices">
	<digest>
		Receive messages over a network
	</digest>
	<description>
		Receives messages transmitted over a network using the User Datagram Protocol (UDP).
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Devices
		</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>
				data out
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="port" optional="0" type="int">
			<digest>
				Local network port
			</digest>
			<description>
				Specifies the local port that the <o>udpreceive</o> object will use to listen for incoming messages.
			</description>
		</objarg>
		<objarg name="full-packet" optional="1" type="symbol">
			<digest>
				Full packet mode
			</digest>
			<description>
				The <o>udpreceive</o> object and its counterpart the <o>udpsend</o> object provide support for third-party Max objects that work with the Open Sound Control (OSC) protocol developed by the Center for New Music and Audio Technologies (CNMAT) at the University of California, Berkeley. An optional symbol argument (it can be any symbol) specifies that the <o>udpreceive</o> object should pass on UDP buffers as OSC 'FullPacket' messages instead of decoding them and outputting them as Max messages.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="maxqueuesize">
			<arglist>
				<arg name="maximum" optional="0" type="int" />
			</arglist>
			<digest>
				Set maximum queue size
			</digest>
			<description>
				The word <m>maxqueuesize</m>, followed by an integer, sets the maximum number of incoming messages that can be in the queue at any given time (default=512). The work queue will grow as needed until this maximum limit is reached. In high-traffic or high-speed situations, you may need to increase the maximum queue size to avoid dropped messages.
			</description>
		</method>
		<method name="port">
			<arglist>
				<arg name="port" optional="0" type="int" />
			</arglist>
			<digest>
				Set the network port
			</digest>
			<description>
				The word <m>port</m>, followed by a number, sets the local port that the <o>udpreceive</o> object will use to listen for incoming messages.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="quiet" get="1" set="1" type="int" size="1">
			<digest>
				Quiet
			</digest>
			<description>
				When enabled, status notifications to the Max Console are suppressed.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Quiet" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="udpreceive.png" caption="Look ma! No hands!!!" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="udpsend" />
		<seealso name="communicationschapter03" module="max" type="tutorial" />
	</seealsolist>
	<misc name="Output">
		<entry name="anything">
			<description>
				All OSC-compatible UDP messages received at the port number of the host computer (designated by argument or the <m>port</m> message) are sent out the outlet.
			</description>
		</entry>
	</misc>
</c74object>
