Reroutes, Wireless Connections and Subgraphs#
Setups get big, and once they do the wires start crossing and it gets hard to see what is connected to what. There are three tools for that. Reroutes bend a wire, wireless connections get rid of it, and subgraphs pack a whole chunk of the setup into one node.
None of them change what the setup does, only how it reads. Comments and notes are worth using alongside them, documented in our Comment and Note sections!
Reroute#
A Reroute node is a single point you can drop into a connection and drag around, so the wire goes where you want it to instead of straight through everything in between.
To make one, hold Ctrl and drag anywhere on a connection. The reroute appears under your cursor and stays attached to the mouse, so you can drop it where you want it in one go.
You can also click a connection and pick the reroute button from the context menu.
To remove a reroute, drag it onto the pin at either end of its connection and drop it there. The connection closes back up and the links transfer onto the pin. You can also remove a reroute by either selecting it and pressing Delete or choosing Delete from the right-click menu.
Wireless Connections#
Some connections are just long. A camera on one side of the graph feeding an export node on the other has to cross everything in between, and rerouting only moves the problem around.
A wireless connection replaces the wire with a pair of nodes: a Send node next to the output and a
Receive node next to the input. They find each other by name.
To make a pair, click the connection you want to replace and pick the wireless button from the menu. Both nodes are created for you, already named and already linked up.
To wire things up by hand, add a Send node and a
Receive node from the Wireless section of the node menu, connect them to the output and the input you want, then give them the same name. Double-click either node to rename it. Names are matched ignoring capitals and surrounding spaces, so Main Camera and main camera count as the same name.
A few things worth knowing:
One
Send node can feed any number of
Receive nodes. Name them all the same and they all get the data.
A
Receive node with no matching
Send node shows No matching Send node underneath it. A
Send node with nothing listening stays quiet, but it will show an error if it finds a match whose pin it isn’t allowed to connect to.
Hover a
Send or
Receive node to see its wireless links drawn in, which is the quickest way to check where something is going.
click one and use Go to Sibling to jump to its counterpart. If it has several, they’re listed in a submenu.
click a
Send node and use Send To… (or Receive From… on a
Receive node) to pick an existing counterpart by name from a list. It renames the node to match.
Select a
Send node and one or more
Receive nodes and press Ctrl + L to rename them all at once. They take the name of the
Send node in the selection.
Subgraphs#
A Subgraph node contains a node graph of its own. Once a part of a setup is finished, this is a good way to fold it away so the main graph only shows the handful of nodes you still care about.
To make one, select the nodes you want to pack up, click and pick Convert To Subgraph. The nodes move inside the new subgraph node, and any connection that crossed the boundary is replaced with an
Input or
Output node so the pin still exists on the outside.
Double-click the node to go inside it. There is a path across the top of the node graph showing where you are, starting at Root, and you can click any step of it to go back up. clicking a subgraph node and picking Enter Subgraph works too, and double-click-to-enter can be turned off under Settings > Preferences… > General.
Pins#
The pins on the outside of a subgraph node come from the Input and
Output nodes inside it. Add one from the Subgraph section of the node menu to add a pin, delete it to remove the pin, and rename it to rename the pin. Pins are ordered top to bottom by where their nodes sit vertically inside the graph, so moving those nodes around reorders the pins.
Parameters#
A subgraph node starts with no parameters of its own. You choose which ones it gets.
Go inside the subgraph, click a parameter in the Node Details panel and pick Add To Parent. It now shows up on the subgraph node, where it drives the original. Remove From Parent takes it back off.
Subgraphs can be nested, and a parameter that has been exposed once can be exposed again to the level above it.
A Subgraph node can be saved as a node preset like any other node, and the graph inside it is saved with it. That is how you carry a finished piece of a setup into another project. Check out our Node Presets section!