Grouping Nodes

Group nodes to simplify cluttered schematics. A group is represented by a single dynamic node that displays the group’s contents, inputs, and outputs. You can use a group node as a parent to, or child of, other clips and nodes.

You can create several groups and work on each group separately. For example, group a Keying and Colour Correction branch separately from an Action and a filtering branch, and then work on each branch independently. If you need to edit the nodes in a group, you can expand the group and make the necessary modifications.

To group nodes:

Ctrl-drag to select the nodes you want to group.
Selected nodes are outlined in white.
In the Process Tree controls, click Group.

The selected nodes collapse into a Group node. The Group node lists the nodes contained in the group, as well as the non-hidden input tabs and output tabs.

TipYou can create a group inside a group.

(a) Input connection (b) Proxy window (c) Output connections (d) Group icon
To rename the group, enter a name in the Node Name field.

To set a context view for any output in a group node:

Press = and click the tab of the output whose context you want to set.
(C1) or (C2) is added to the output name. As well, a green dotted line appears around the output name.

(a) Context 1 is set for keyer5
To display the context in a viewport, select the context from the View box.

To set a context view for the current output in a group node:

Select an output in the node’s output list (press Shift+up or down arrow to navigate through the outputs).
A yellow line appears around the selected output.

(a) Selected output
Press = and click anywhere in the node.
A context view is set on the selected output. As well, a green dotted line appears around the output name.

(a) Context 1 is set for selected output
To display the context in a viewport, select the context from the View box.

Defining Group Display Settings

Customize the group node using the Group List menu. The Group List menu lists all the nodes and connections contained in a group. You can rename and hide the contents of the group, as well as define which input and output connection sockets are visible and available for connection in the schematic.

You can select a node in the Group List menu to display the group at the selected node's stage. The View box must be set to Result, Front, or Back to use this display option. You can also display a preview proxy of a node in the group.

To define a group's display settings:

Select a group in the schematic.
The Group List menu appears.

(a) Sort Order buttons (b) Enabled icon visibility (c) Disabled UI visibility (d) Enabled input visibility (e) Enabled output visibility

Change the group's interface by doing any of the following.

Click:	To:
Sort Order buttons	Move the selected node one position up or down (click the single-arrow buttons). To move the selected node to the first or last position in a group, click the arrow-line buttons.
Name	Change the node's name.
Icon	Toggle the node's visibility in the group. Icons in the Group List are yellow when the node is visible and grey when hidden.
UI	Toggle the node's availability in the Node List box. Icons in the Group List are yellow when the node is displayed in the box and grey when hidden.
Proxy	Display a proxy of the corresponding node in the proxy window. Icons in the Proxy list are white when locked and grey when unlocked. Lock an icon when you do not want its proxy in the window to change as you navigate the Group List.
Inputs	Hide or unhide the selected node's input sockets. Sockets are colour-coded with the same scheme as Batch nodes that are not part of a group. Icons in the Group List have a yellow border when the input socket is visible.
Outputs	Hide or unhide the selected node's output sockets. Sockets are colour-coded with the same scheme as Batch nodes that are not part of a group. Icons in the Group List have a yellow border when the output socket is visible.
Node Proxy	Display a preview proxy of a node in the group.
Collapsed	Collapse the group icon so that only the preview proxy is visible. Note that you can still cycle through the Group List to display other proxies when the group icon is collapsed.

To display a proxy of an output in the proxy window:

Do any of the following:
- Click the field in the Proxy list that corresponds to the node whose output you want to display.
- Press the Shift+up or down arrow as you navigate through the node’s Group List.
- If a node has multiple outputs, press Ctrl+Shift+up or down arrow as you navigate through the node’s Group List to display all the outputs of a node.

To change the size of the group icon:

Drag the lower-right corner of the icon to make it wider or narrower.

Editing a Group

Use the Edit Group controls to edit the contents of a group.

To edit a group:

Select the group you want to edit.
Click Edit.
The nodes in the group appear in their own schematic.

TipInstead of editing the group, you can access a single node's menu by selecting the node's name from the Node List box. Click the L (List) button to return to the Group List menu.

(a) List button (b) Node List box
Modify the nodes as required.
NoteSelecting All from the Selection Mode box while editing a group selects all nodes within the current group; any nodes outside the group in the current Batch pipeline remain unselected.
Click Exit Group to return to the previous schematic.
NoteClick Ungroup to expand the group of nodes to their pre-grouped positions in the schematic.

Resolution Issues

A node's bit depth and resolution are not always compatible. It is not always possible to use clips of different resolution or bit depth. For example, it is not possible to have one custom Colour Corrector node with an 8-bit clip and another with a 12-bit clip. Garbage masks, on the other hand, work correctly with clips of different bit depth, but not of different resolutions.

Comment on this topic