Creating a subcomposition

Abstract

Installing subcompositions in Composition-Local and User Library folders via menu items

In the example above, we created the Make Hemisphere subcomposition by selecting nodes and cables within a composition, right-clicking on them, and going to Package as Subcomposition. This installed the subcomposition in a Composition-Local Library.

New in Vuo 2.0

If you want to create an empty subcomposition in a Composition-Local Library, you can right-click on the canvas and go to Insert Subcomposition.

If instead you want to create a subcomposition in the User Library folder, you can open a new or existing composition and go to File > Save to User Library.

Naming a subcomposition

When you turn an already-saved composition into a node, the node’s title derives from the composition’s file name. A composition file called Scribble.vuo or scribble.vuo would be turned into a node titled Scribble. A composition file called Solve Anagram.vuo or SolveAnagram.vuo would be turned into a node titled Solve Anagram.

If you haven’t yet saved the composition file, Vuo prompts you to enter a node title.

The node’s class name is your vuo.org account name followed by a period followed by a lower-camel-case version of the node title — for example, me.scribble or me.solveAnagram. In the File > Save to User Library dialog, you can customize the prefix — for example, you could group your subcompositions into categories such as me.interaction.scribble or me.algorithm.solveAnagram.

New in Vuo 2.0

After turning a subcomposition into a node, if you want to change the node’s title, open the subcomposition and go to Edit > Composition Information….

If you want to change the node’s class name, rename the installed subcomposition file. Do this by right-clicking on the subcomposition node in the Node Library and choosing the menu item Show in Finder, finding your installed subcomposition in that folder (for example, me.scribble.vuo), and renaming the file. Be careful renaming a subcomposition, because any compositions that refer to the subcomposition by its old name will have an error until you substitute in the new version of the subcomposition.