The Graph Editor
The Nodegraph Editor lets you view the Nodes associated with the current scene (Figure 1). The Render Target encompasses all of the scene-related nodes: Camera, Environment, Visible Environment, Geometry, Film Settings (which specifies the resolution), animation settings, Kernel, Render Passes, Render Layer, AOV Output Group, Imager, and post-processing nodes. Selecting a Node in the Graph Editor brings up that Node's settings up in the Node Inspector along with its empty Node pins. You can fill empty node pins in the Graph Editor or the Node Inspector. Placing the mouse cursor over a Node pin shows the name of the Material contained by that pin.
Figure 1: Nodegraph Editor
You can move around the Nodegraph Editor with the mouse by clicking and dragging the yellow area on the thumbnail preview at the top-left corner of the Graph Editor (Figure 2). You can also zoom in and out of the Nodegraph Editor by using your mouse's scroll wheel or pan using the right mouse button.
Figure 2: The Nodegraph's viewable area
Adding Nodes In The Nodegraph Editor
To add more Nodes, right-click on an empty area to bring up the context menu with the Node options. After selecting, the new node is placed on the cursor location (Figure 3).
Figure 3: Node context menu
Node Context Menus
Right-clicking on a Node brings up a context menu with options to delete all selected Nodes, save the selected Nodes as a macro file or in LiveDB, and render the Node under the cursor (Figure 4). The Group Items option creates a single group node that represents the selected Nodes. Grouping Nodes is useful if you want to hide complex Node systems. Node pin connections are saved when you save multiple Nodes. The context menu also includes Show In Outliner, which will quickly pick and select the respective node’s corresponding element in the Outliner.
Figure 4: Node context menu
Selecting Multiple Nodes
Start dragging in an empty area of the node graph editor to select multiple Nodes with a box (Figure 5). Hold down the Shift key to add additional Nodes to the current selection. You can also add and remove Nodes from the selection by holding down Ctrl and clicking on a Node. The Nodegraph Editor supports copy and paste operations by right-clicking on selected Nodes to invoke a context menu of command options, or by simple keyboard shortcuts Ctrl+C for copy and Ctrl+V for paste. There are also application-wide shortcuts for cut, copy, paste, and delete commands in the application menu (Figure 6). Copying and pasting nodes also duplicates connections coming from other Nodes to the copied Nodes. Dropping macro and mesh files on the Nodegraph Editor is also possible.
Figure 5: Selecting Nodes
Figure 6: Copying the selected Nodes
Disconnecting Nodes
Hold down the Ctrl key, then press the left mouse button and move the cursor between Nodes to disconnect them (Figure 7).
Figure 7: Disconnecting Nodes
Hiding Complex Node Systems
For a clean and organized graph, you can group nodes together, and they are represented by a single node named Node Graph (Figure 8). You can rename the node through its node entry in Node Inspector pane. Double-clicking on a grouped node opens a new tab in the Nodegraph Editor, which shows the graph of the constituent nodes for that group. You can group together other grouped nodes to create nested groups.
Figure 8: Group Items option
Figure 9: Ungroup option
Internal Graph And Material Previews
The Nodegraph Editor has buttons to show the internal material preview scene when you select a Node (Figure 10).
Figure 10: Nodegraph Editor buttons
Node Graph Editor Navigation
You can scroll in the Node Graph Editor with the mouse wheel when holding down the CTRL key (or CMD key on Macintosh® platforms). Like the Viewport, the Node Graph Editor also has panning and zooming controls:
- Select nodes - Left mouse button
- Pan - Right mouse button
- Zoom in/out - Mouse wheel/middle mouse button
When zoomed out far enough, you can not edit connections, but you can still move items. When an item or a node is dragged out of the Node Graph Editor window, the Node Graph window auto-pans to make that node visible.
Multi-Connect - Connects multiple nodes at a time by holding down the CTRL key (or CMD key on Macintosh® platforms) while connecting some selected nodes to a pin on another node. It is inactive if only one connection is possible.
Connection Cutter - Cuts off multiple connections by holding down the CTRL key (or CMD key on Macintosh® platforms) and then click-dragging the mouse to form a line over the connections to remove.
Search Dialog - Pressing CTRL+F brings up the Search Dialog, which finds and selects nodes and dynamic pins that contain the entered search string.