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