The node library isn’t just for reading about nodes, but for incorporating them into your compositions. Once you have found a node of interest, you may create your own copy by dragging it straight from the node library onto your canvas, or by double-clicking the node listing within the library.
Not a mouse person? Navigating the library by arrow key and pressing ↵ to copy the node to your canvas works just as well.
You may copy nodes from the library individually, or select any number or combination of nodes from the library and add them all to your canvas simultaneously with a single keypress or mouse drag — whatever best suits your work style.
You can create a cable by dragging from a node’s output port to a compatible input port or from a node’s output port to a compatible input port.
Compatible ports are those that output and accept matching or convertible types of data. Compatible ports are highlighted as you drag your cable, so you know where it’s possible to complete the connection.
If you complete your cable connection between two ports whose data types are not identical, but that are convertible using an available type converter (e.g., vuo.math.round for rounding real numbers to integers), that type converter will be automatically inserted when you complete the connection.
Sometimes existing cables may also be re-routed by dragging (or “yanking”) them away from the input port to which they are currently connected. It is possible to yank the cable from anywhere within its yank zone. You can tell where a cable’s yank zone begins by hovering your cursor near the cable. The yank zone is the section of the cable with the extra-bright highlighting. If no yank zone is highlighted, you’ll need to delete and add back the cable.
You can select one or more nodes and copy or cut them using the
and/or menu options, or their associated keyboard shortcuts. Any cables or type converters connecting the copied nodes will automatically be copied along with them.You can paste your copied components into the same composition, a different composition, or a text editor, using the
menu option or its keyboard shortcut.
Select one or more nodes and drag them while holding down ⌥ to duplicate and drag your selection within the same composition. Press ⎋ during the drag to cancel the duplication.
Delete one or more nodes and/or cables from your canvas by selecting them and either pressing ⌫ or right-clicking one of your selections and selecting from its context menu.
When you delete a node, any cables connected to that node are also deleted. A cable with a yank zone may also be deleted by yanking it from its connected input port and releasing it.
Any type converters that were helping to bridge non-identical port types are automatically deleted when their incoming cables are deleted.
You can move nodes within your canvas by selecting one or more of them and either dragging them or pressing the arrow keys on your keyboard.
Hold down ⇧ while pressing an arrow key to move the nodes even faster.
You can change the constant value for an input port by double-clicking the port, then entering the new value into the input editor that pops up. (Or you can open the input editor by hovering the cursor over the port and pressing ↵.) When the input editor is open, press ↵ to accept the new value or ⎋ to cancel.
Input editors take on various forms depending on the data type of the specific input being edited — they may present as a text field, a menu, or a widget (such as color picker wheel), for example.
Some ports take lists as input. These ports have special attached “drawers” containing 0 or more input ports whose values will make up the contents of the list. Drawers contain two input ports by default, but may be resized to include more or fewer ports by dragging the “drag handle.”
You can change how a trigger port should behave when it’s firing events faster than downstream nodes can process them. Do this by right-clicking on the port, selecting
from its context menu, and selecting either or .You can change a node’s title (displayed at the top of the node) by double-clicking or hovering over the title and pressing ↵, then entering the new title in the node title editor that pops up. You may save or dismiss your changes by pressing ↵ or ⎋, respectively, just as you would using a port’s input editor. You can also select one or more nodes from your canvas and press ↵ to edit the node titles for each of the selected nodes in sequence. If you delete the title and don’t enter a new title, the node will default to its original title.
You can change a node’s tint color by right-clicking on the node, selecting
from its context menu, and selecting your color of choice. Tint colors can be a useful tool in organizing your composition. For example, they can be used to visually associate nodes working together to perform a particular task.If your composition is too large to be displayed within a single viewport, you can use the Zoom buttons within the composition window’s menubar, or the
/ / / menu options, to adjust your view. You can use the scrollbars to scroll horizontally or vertically within the composition. Alternatively, if you have no nodes or cables selected, you can scroll by pressing the arrow keys on your keyboard. You can also grab the workspace by holding down the spacebar while dragging.
Hold down ⇧ while pressing an arrow key to scroll even faster.
A composition’s published ports are displayed in sidebars, which you can show and hide using the menu
.You can publish any input or output port in a composition. Do this by right-clicking on the port and selecting
from the context menu. Alternatively, drag a cable from the port to the well that appears in the sidebar when you start dragging. You can unpublish the port by right-clicking on the port again and selecting .In the sidebars, you can rename a published port by double-clicking on the name or by right-clicking on the published port and selecting
.
If you copy a node with a published port, that port will be published under the same name (if possible) in whatever composition you paste it into. The published port will be created if it does not already exist, merged if an existing published port of the same name and compatible type does exist, or renamed if an identically named published port already exists but has an incompatible type.
To create a composition with a predetermined set of published ports defined by a protocol, go to the
menu, select , and select the protocol you want. Typically, a protocol is used when running a Vuo composition inside another application, such as a VJ or video postproduction app. That application should instruct you about the protocol to select.The published ports in a protocol appear in a tinted area of the published port sidebars, with the protocol name at the top. You can’t rename or delete these published ports. However, you can add other published ports to the composition and rename or delete them as usual.