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

pcontrol

Open and close subwindows within a patcher

Description

pcontrol serves as a remote control for patcher/subpatcher windows and functions.

Arguments

None.

Messages

close patcher-name [list]
Closes the patcher window of any subpatches or patcher objects connected to the pcontrol object's outlet.
help filename [symbol]
The word help, followed by a symbol, opens a help file in Max's max-help folder with the name of the symbol followed by .help.
load filename [list]
The word load, followed by the name of a patcher file, opens that file if it can be found in Max's search path. The file name may optionally be followed by up to nine numbers and/or symbols, which will be substituted for the appropriate changeable # arguments (#1 to #9) in the patch being opened.
loadunique patcher-name [list]
The word loadunique, followed by the name of a patcher file, opens a single instance that file if it can be found in Max's search path. If the file has already been loaded, the previously loaded copy will be activated (i.e. only a single copy of the file may be opened). As with the load message, the file name may optionally be followed by up to nine numbers and/or symbols, which will be substituted for the appropriate changeable # arguments (#1 to #9) in the patch being opened.
open patcher-name [list]
Opens the patcher window of any subpatches or patcher objects connected to the pcontrol object's outlet.
shroud filename [list]
The word shroud, followed by the name of a patcher file, opens that file but does not show its window. (Use this message with care, since having patchers open but invisible can potentially lead to some disconcerting results.)

Information for box attributes common to all objects

Output

Patcher-Control: Any subpatches or patcher objects connected to the pcontrol object's outlet can have their patcher window opened or closed, or MIDI enabled/disabled, when the appropriate message is received in the inlet of pcontrol.

Examples

Show/hide a subpatch window or enable/disable its MIDI objects

See Also

Name Description
bpatcher Embed a visible subpatch inside a box
inlet Receive messages from outside a patcher
patcher Create a subpatch within a patch
thispatcher Send messages to a patcher