A newer version of Max is available. Click here to access the latest version of this document.

udpreceive

Receive Max messages over a network using UDP

Description

udpreceive receives messages transmitted over a network using the User Datagram Protocol.

Arguments

Name	Type	Opt	Description
local-port	int		Obligatory. Specifies the local port that the udpreceive object will use to listen for incoming messages.
OSC-full-packet-designation	symbol	opt	The udpreceive object and its counterpart the udpsend 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 udpreceive object should pass on UDP buffers as OSC 'FullPacket' messages instead of decoding them and outputting them as Max messages.

Messages

maxqueuesize	message-maximum [int]	The word maxqueuesize, followed by an integer, sets the maximum number of incoming messages that can be in the queue at any given time (default="2048)." 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.
port	local-port [int]	The word port, followed by a number, sets the local port that the udpreceive object will use to listen for incoming messages.

Attributes

Name	Type	g/s	Description
quiet	int		When enabled, status notifications to the Max window are suppressed.

Information for box attributes common to all objects

Output

anything: All OSC-compatible UDP messages received at the port number of the host computer (designated by argument or the port message) are sent out the outlet.

Examples

Look ma! No hands!!!

See Also

Name	Description
udpsend	Send Max messages over a network using UDP
Max Comm Tutorial 3: UDP Networking	Max Comm Tutorial 3: UDP Networking