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

pvar

Connect to a named object in a patcher

Description

The pvar object lets you build user interfaces in one part of your patcher that are associated with the "process" part in another part of the patcher. Unlike the send and receive objects, pvar does not work globally; the pvar object and its associated object must be in the same patcher. You set an object's name by selecting the object and choosing Name... from the Object menu. The name cannot be a number, although it can contain numbers.

Arguments

Name	Type	Opt	Description
object-name	symbol	opt	The first argument specifies the name of the object to which pvar will be associated with. If no name is supplied, the setname message can be used to connect later.
number-of-outlets	int	opt	The second argument specifies the number of outlets pvar will have. pvar connects to as many outlets as its associated object has, unless it is more than the number you specify as an argument. The default number of outlets is 1.

Messages

bang		Performs the same function as anything.
int	input-message [int]	Performs the same function as anything.
float	input-message [float]	Performs the same function as anything.
list	input-message [list]	Performs the same function as anything.
anything	input-message [list]	The message is sent to the named object currently associated with pvar.
loadbang		Performs the same function as anything.
setname	object-name [symbol]	The word setname, followed by a symbol, specifies the name of the object to which pvar will be associated with. The named object must be in the same patcher as the pvar object.

Information for box attributes common to all objects

Output

any message: The outlets of pvar correspond to the outlets of its associated named object. When the named object sends anything out one of its outlets, the output also comes out of the corresponding outlets of the pvar object.

Examples

pvar can be used to build a user interface without any messy patch cords

Name	Description
receive	Receive messages without patch cords
send	Send messages without patch cords
thispatcher	Send messages to a patcher
value	Share a stored number with other objects