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

udpreceive Reference

Receive messages over a network

udpreceive

Description

Receives messages transmitted over a network using the User Datagram Protocol (UDP).

Examples

Look ma! No hands!!!

Arguments

port [int]

Specifies the local port that the udpreceive object will use to listen for incoming messages.

full-packet [symbol]

Optional

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.

Attributes

quiet [int]

When enabled, status notifications to the Max Console are suppressed.

Common Box Attributes

Messages

maxqueuesize

Arguments

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=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.

port

Arguments

port [int]
The word port, followed by a number, sets the local port that the udpreceive object will use to listen for incoming messages.

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.

See Also

Name Description
Using Max with Hardware Using Max with Hardware
Using Max with other applications Using Max with other applications
udpsend
Max Comm Tutorial 3: UDP Networking Max Comm Tutorial 3: UDP Networking