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

receive

Receive messages without patch cords

Description

receive will receive and output messages from send objects which are named by the same argument and will allow you to send any kind of message between Patcher windows or within a window without using patch cords. The order of reception by two or more receive objects is not deterministic. A receive object can be instantiated simply by typing into an object box the short-form letter "r".
Note: Communication between Max for Live devices using send and receive is supported, but there may be some latency involved when sending data between devices.

Arguments

Name	Type	Opt	Description
object-name	symbol	opt	Gives a name to receive. If there is no argument, receive has one inlet, and a name must be provided by a set message before anything can be received. All receive objects that share the same name will receive data from any send objects that share their name. For information about using named objects in Max for Live, click here.

Messages

(mouse)		Double-clicking on a receive object looks for and opens a loaded patcher window containing a send object with the same name. Repeatedly doubleclicking on the receive object looks for and opens more such windows.
set	object-name [symbol]	If there is no typed-in argument, receive has one inlet. The word set, followed by a symbol, provides a name for receive, as if that name had been typed in as an argument.

Information for box attributes common to all objects

Output

anything: Any message received in the inlet of any send or forward object with the same name, or sent explicitly from an int, float, grab, or message box, is passed out the outlet of receive, even if the sending object is in a different loaded patch.

Examples

Virtual connections exist between all send and receive objects that share the same name

Name	Description
float	Store a decimal number
forward	Send remote messages to a variety of objects
int	Store an integer value
message	Send any message
pattrforward	Send any message to a named object in the patcher hierarchy
pvar	Connect to a named object in a patcher
route	Selectively pass the output out a specific outlet
send	Send messages without patch cords
value	Share a stored number with other objects
Max Basic Tutorial 16: Remote Messaging	Max Basic Tutorial 16: Remote Messaging