10.4. Working with subcompositions

As you work with Vuo, you might find yourself creating compositions that perform functions of general use to you in multiple applications. Subcompositions provide a convenient way to package your compositions so that you may easily reuse them any number of times and avoid the hassle of copying and pasting the same group of nodes and cables over and over again. Once you install a subcomposition, it takes the form of a node that you can drag from the Node Library onto your canvas just like any other node.

10.4.1. Installing a subcomposition

To install a subcomposition, open or create a composition within the Vuo Editor and select the File > Move Composition to Node Library menu item. (If your composition has not yet been saved, the menu item will read Save Composition to Node Library, and you will be prompted to enter a title for your node.) The subcomposition node will immediately be listed and highlighted within your Node Library for use within other compositions.

When designing a composition that you intend to install as a subcomposition, you can use the steps described in the Publishing ports section to create published input and output ports. Any published inputs that you incorporate into your composition will be displayed as input ports on the installed subcomposition node, and published outputs in the composition will be displayed as output ports of the subcomposition node.

10.4.2. Editing a subcomposition

There are several ways to edit a subcomposition after it has already been installed:

  • Right-click on the subcomposition node, either within the Node Library or on the canvas, and select the Edit Composition… context menu item

  • Double-click the body of the node on the canvas

  • Select the node on the canvas and press ⌘↓

  • Click the Edit Composition… link in the node library documentation panel

A subcomposition node is recognizable by the icon in its top-right corner consisting of two overlapping squares, symbolizing that the subcomposition node contains nodes of its own.

10.4.3. Removing a subcomposition

To remove an installed subcomposition, you can right-click on the subcomposition node within the Node Library and select the Open Enclosing Folder context menu item, or follow the instructions in the Installing a node section to navigate to your User Modules folder. Locate the .vuo file matching the name of your subcomposition and remove it from the folder. The next time you restart the Vuo Editor, the subcomposition will no longer appear in your Node Library.