Create a subpatch within a patch
Creates patches within patches.
Cycling '74
Max
Control
Patching
TEXT_HERE
Subpatch name
The subpatch can be given a name by the argument, so that its name appears in the title bar of the subpatch window. The name in the title bar of the subpatch window is displayed in brackets to indicate that it is part of another file. If there is no argument typed in, the subpatch window is named [sub patch]. Different patcher objects that share the same name are still distinct subpatches, and do not share the same contents.
Object Accent Color
Sets the default accented background color for objects.
Assistance Shows Patcher Name
If set to 0 (default) and an inlet or outlet object in the subpatcher has a comment, the patcher name is not shown. If there is no comment, it is shown. If the attribute is set to 1, the patcher name is always shown whether or not the inlet / outlet object has a comment.
Object Background Color
Sets the default background color for objects.
Object Background Gradient
Sets the default gradient fill for objects.
Pin Bottom Toolbar on Open
Controls the display of the bottom toolbar when a file is opened. If set to "last saved", the toolbar will be shown only if it was visible when the patcher was saved. If set to "pin", the bottom toolbar will always be visible. If set to "unpin" the toolbar will always be invisible until the cursor moves over the bottom edge of the window.
Last saved
The bottom toolbar will be shown only if it was visible when the patcher was saved.
Pinned visible
The bottom toolbar will always be visible.
Unpinned
The bottom toolbar will always be invisible until the cursor moves over the bottom edge of the window.
Box Animate Time
Sets the time, in milliseconds, used for animation of object behavior in the patcher window.
Bubble Background Color
TEXT_HERE
Bubble Outline Color
TEXT_HERE
Comment Background Color
Sets the default background color for comment objects.
Object Color
Sets the default foreground color for objects.
Default Focus Box
The scripting name of the object that will receive keyboard focus when the patcher is first opened.
Description
Sets a searchable description used by the database and documentation system.
Digest
Sets a searchable short description used by the database and documentation system.
Unlocked Background Color
Sets the patcher background color when the patcher is unlocked.
Object Element Color
Sets the default border color for objects.
Show Horizontal Scrollbar
If enabled, the horizontal scrollbar will appear when the patcher’s content width exceeds its window width.
Enable Transparent Patcher With Title Bar
When set to 1, this enables patchers with locked and unlocked backgrounds set to 0% opacity to become fully transparent. Please note that you must change the opacity setting for the Locked Patcher Background Color, locked_bgcolor, and Unlocked Patcher Background Color, editing_bgcolor.
Show Vertical Scrollbar
If enabled, the vertical scrollbar will appear when the patcher’s content height exceeds its window height.
File Path
The patcher’s complete file location if saved (read-only).
Default Font Style
The default font style used for new text objects.
Regular font
Regular font
Bold font
Bold font
Italic font
Italic font
Bold and italic font
Bold and italic font
Default Font Name
Sets the default font used for new text objects.
Default Font Size
Sets the default font size used for new text objects.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Global Patcher Name
Sets the global name by which this patcher can be referred to by pattr objects (for more information, see the pattrmarker object).
Show Grid on Open
If enabled, a grid will be displayed in the unlocked patcher background when the patcher is opened.
Grid Size
Sets the X and Y size of the grid in pixels.
Snap to Grid on Open
If enabled, "Snap to Grid" will be on when the patcher is opened.
Help File Sidebar Closed
If enabled, keep the sidebar closed when opening the help patcher. If the help patcher is tabbed then this must be applied to the root patcher of the help file.
Snap to Pixel
TEXT_HERE
Isolate Start and Stop of Patcher Audio
If enabled, starting or stopping audio in this patcher will not affect the audio in other patcher windows.
Pin Left Toolbar on Open
Controls the display of the left toolbar when a file is opened. If set to "last saved", the toolbar will be shown only if it was visible when the patcher was saved. If set to "pin", the left toolbar will always be visible. If set to "unpin" the toolbar will be invisible until the cursor moves over the left edge of the window.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Locked Background Color
Sets the patcher background color when the patcher is locked.
Snap to Objects on Open
If enabled, "Snap to Objects" will be on when the patcher is opened
Open in Presentation
If enabled, the patcher opens in presentation mode.
Fixed Initial Window Location
Sets the initial window position (horizontal offset/vertical offset/width/height) for the patcher window. If non-zero, changes to the patcher window's size or position will not be reflected when the file is saved.
Patchline Color
Sets the default color for patch cords.
Pin Right Toolbar on Open
Controls the display of the right toolbar when a file is opened. If set to "last saved", the toolbar will be shown only if it was visible when the patcher was saved. If set to "pin", the right toolbar will always be visible. If set to "unpin" the toolbar will be invisible until the cursor moves over the right edge of the window.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Object Selection Color
Sets the default selection color for objects.
Show on Patcher Tab
If set to 1 (parent), the patcher’s title will appear as a tab in its parent patcher. If set to 2 (top-level), the patcher's title will appear as a tab of the top-level patcher. In a top-level patcher this attribute is ignored.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Background Stripe Color
Sets the default background color for objects that display lists.
Style
Sets the style to be applied to the patcher. Styles can be defined and edited using the Format Palette.
Subpatcher Template
Sets the template used when creating an embedded subpatcher with the patcher object or when a patcher is created using the Encapsulate feature. Only the toolbar, style, and editing settings are used by the template; objects are not added to the subpatcher.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Tags
Sets searchable tags (separated by spaces) used by the database.
Tall Object Box
If enabled, the default object box is slightly taller to make its text easier to read.
Comment Text Color
Sets the default text color for comment objects.
Object Text Color
Sets the default text color for objects.
Text Justification
Sets the default text justification used for new text objects.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Title
Sets the name shown in the patcher’s title bar.
Show Toolbar on Open
If enabled, the toolbars will be shown when the patcher is opened.
Pin Top Toolbar on Open
Controls the display of the top toolbar when a file is opened. If set to "last saved", the toolbar will be shown only if it was visible when the patcher was saved. If set to "pin", the top toolbar will always be visible. If set to "unpin" the toolbar will be invisible until the cursor moves over the top edge of the window.
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Disable Workspace
If enabled, the patcher will not be re-opened when relaunching if it was open when last quitting Max.
Take a patch contained within a single patcher window, place it within a patcher object, add inlet s and outlet s, and you can instantiate it as an object (or many copies of that object) capable of its own messaging, embedded within a larger patch.
The number of inlets in a patcher object is determined by the number of inlet objects contained within its subpatch window. The messaging which the patcher object can handle depends upon the patch you embed within it.
Double-clicking on a patcher object with the mouse opens the subpatcher in a new window.
The number of outlets a patcher object has is determined by the number of outlet objects contained within the subpatch window. Output can also be sent via send and value objects contained in the subpatch. The actual messages sent out of a patcher object depend on the contents of the subpatch.
When a patcher object is first created, the subpatch window is automatically opened for editing. To view or edit the contents of a patcher object (or any subpatch object) later on, double-click on the object when the patcher window is locked.
All the objects in a subpatch of a patcher object are saved as part of the patcher which contains the object.