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

pvar Reference

Connect to a named object in a patcher

pvar

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. To set an object's name, select the object, open the inspector, then enter a name under Name > Scripting Name. The name cannot be a number, although it can contain numbers.

Examples

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

Arguments

object-name [symbol]

Optional

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]

Optional

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.

Attributes

Common Box Attributes

Messages

bang

Performs the same function as anything.

int

Arguments

input-message [int]
Performs the same function as anything.

float

Arguments

input-message [float]
Performs the same function as anything.

list

Arguments

input-message [list]
Performs the same function as anything.

anything

Arguments

input-message [list]
The message is sent to the named object currently associated with pvar.

loadbang

Performs the same function as anything.

setname

Arguments

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.

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.

See Also

Name Description
Organizing Your Patch Organizing Your Patch
receive
send
thispatcher
value