Nodes

  1. Home
  2. Docs
  3. Nodes
  4. Utilities
  5. Subpatch Node

Subpatch Node

The Subpatch Node groups other Nodes together to form a subpatch. This allows scaling more complex projects by organizing Nodes, as well as by using subpatches of any complexity as a single Node: subpatches can be copy-pasted, duplicated, and moved, just like any single Node.

Subpatches support infinite nesting. When creating a subpatch from an already existing selection of Nodes, inputs/outputs are automatically created as necessary.

Creating and Editing Subpatches

The quickest way to create a subpatch is selecting 2 or more Nodes, and choosing Group from the right click menu (on touch devices, tap the node to reveal this menu in the header). This will automatically create a Subpatch Node and move the selected Nodes into it. If the selected Nodes connect to other non-selected Nodes, this will also automatically create inputs/outputs on the Subpatch Node as necessary.

Editing the subpatch can be done by right clicking the Subpatch Node, and then choosing Edit.

Additionally, Subpatch Nodes can be created manually just like any other Node, by right clicking on empty Patcher area and choosing the Subpatch Node under the Utilities category.

Navigating Subpatches

  • Right-click the Subpatch Node and choose Edit to enter a subpatch
    • Note: this is currently not available on touch devices, see the known issues section below
  • Click the (X) icon near the top right corner of the Patcher to exit the current subpatch (one level up in the case of nested subpatches)
  • Click the Patcher icon near the top left corner of AudioNodes to exit to the main patch
  • Screen panning, zooming, node creation, etc. work the same as in the main patch
  • An additional category of Nodes is available in the node browser while inside a subpatch

Inputs

This Node has a variable number of Audio, Control, or Melody inputs, depending on what input Nodes are contained inside the subpatch.

Subpatch inputs can be created by creating Subpatch Audio Input, Subpatch Control Input, and Subpatch Melody Input Nodes within the subpatch. When necessary, inputs are also automatically created when grouping an already existing selection of Nodes.

Outputs

This Node has a variable number of Audio, Control, or Melody outputs, depending on what output Nodes are contained inside the subpatch.

Subpatch outputs can be created by creating Subpatch Audio Output, Subpatch Control Output, and Subpatch Melody Output Nodes within the subpatch. When necessary, outputs are also automatically created when grouping an already existing selection of Nodes.

Known Issues

  • Currently, it’s not possible to enter a subpatch when the UI is set to touch mode. The workaround is to go to settings and temporarily set UI mode to mouse and keyboard, touch and hold the subpatch node, and choose Edit from the menu. UI mode can be reset afterwards.
Was this article helpful to you? Yes No