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

See Also

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