Connecting Shader Nodes

Dynamic property assignment is a feature of the render tree that lets you extend shaders by using the output of one shader as the input for one or several shader parameters. Since each node has an output and at least one input, you can connect a nearly endless number of nodes together. For example, you can use a 2D or 3D texture to control a material shader's reflectivity and another texture to control the its specularity.

Some render tree connections are very basic. For example, when you connect a color output into the an object's surface input, you have a pretty good idea of what the result is going to be because you're only changing the object's color. But what if you connect a fractal shader to another shader's Reflection input or a cloud texture to a material's Displacement input? The combinations are endless!

In general, you connect shader nodes by clicking and dragging an output port from the right side of one shader node onto an input port on the left side of another shader node, or the other way around (drag the input port onto an output port).

Data flows along the connection from the first node and is processed by the second node.

1	Data travels from this node's output port ...
2	.. and is processed by this node via its input port.

When a port is connected, the value of its corresponding parameter is driven by the connection, which means that you can no longer set the parameter's value in that shader's property editor. In fact, the parameter and its controls (checkboxes, sliders, etc.) are not even displayed. If you remove the connection, the controls reappear in the property editor.

ImportantWhen you connect to an input port, any existing animation on that parameter's value is lost.

The type of the data, as indicated by the port colors, determines whether you can connect two specific ports. If you cannot connect two ports, it is likely because the types are incompatible. See Ports for Parameters: The Ins and Outs for more information.

Once you have created a connection arrow from a node's output, you can drag the cursor over a port inside another node to see if a parameter will accept the connection.

If the parameter name changes color, it will accept the connection arrow.
If the input and output are not of the same type, a conversion node is created automatically.

Connecting Nodes

If a shader node already exists in the render tree, you can connect one of its output ports by dragging the port icon onto another node. You can also add a new node and connect it at the same time by dragging the node from the preset manager directly onto a node's port (you can't do this for shader compounds).

You can hover the mouse pointer over a connection to highlight the connected ports. If a port is not visible because it has been collapsed or because the view is zoomed out too far, information about the port is displayed in a pop-up.

Connecting Existing Shader Nodes

Bring two or more shaders that you want to connect into the render tree.
Do either of the following:
- Click on an output port on the right side of a node, then drag it over to an input port on another node and release the mouse button. If the input port's name is highlighted when you drag over it, the connection is valid.
- Click on an input port on the left side of a node, then drag it over to an output port on another node and release the mouse button. When the menu of ports appears, select the one to which you want to connect.
  
  You can connect the same output to as many input ports as you want.
  
  Connection arrow shows connection between the two ports.
  
  NoteDragging a connection to the edge of the workspace automatically scrolls the view.

Adding a Node from the Preset Manager and Connect It to an Input

Drag a shader node (not a shader compound) from the preset manager directly onto the node to which you want to connect. The new node is slightly transparent and displays an arrow when it's on top of the existing node.
Drag the new node over the port name to which you want to connect so that the name is highlighted. When you release the mouse button, the new node is connected to that port.

Connecting to Collapsed Nodes, Port Groups, and Texture Layers

When port groups, texture layers, or entire nodes are collapsed, their ports are hidden. Rather than expanding them, you can use a pop-up menu to connect nodes to ports while they're collapsed.

Drag a connection arrow from an output port onto a collapsed node, port group, or texture layer. Release the mouse button and a pop-up menu appears showing all input ports that are valid for that connection.
Select an item from the menu to connect to that port.

Ports that are already driven by a connection are have a bullet beside their name in the menu. Selecting a connected port replaces the old connection with the new one.

You can press Shift to keep the menu open while you select multiple ports.

A	A dot beside a port name means that it is already connected.
B	When connecting to a collapsed node, port group, or texture layer, a menu appears. Select a port from it to which you can connect.

Inserting Nodes

Rather that getting shader nodes from the preset manager or Nodes menu and then connecting them, you can insert certain nodes directly into the render tree workspace using a contextual menu. You can insert nodes between other nodes in one of three ways:

Connected to a specific input of an existing node.
Between two existing nodes as a conversion shader.
Blended with the shader's parameters using a texture layer. For more information about working with texture layers in the render tree, see Working with Texture Layers in the Render Tree.

Inserting a node from the preset manager

Drag a shader node (not a shader compound) from the preset manager onto the connection line between two nodes. The new node is slightly transparent.
Release the mouse button when the connection line is partially highlighted and the new node's outline shows an arrow.

The new node's inputs and outputs are connected according to the first valid ports available. If these are not the desired ports, simply reconnect them.

Inserting a node using a pop-up menu

Expand a node and right-click any of the following:
- The input port to which you want to connect the inserted shader node.
- The input port's name.
- The connection line between two nodes.
Right-click in any of these places (A, B, C) to insert a node.

TipIf you are displaying connections as horizontal and vertical lines, it may be difficult to isolate a connection line. Change the line display to curved line by choosing Show Show Connections as Curved Lines from the render tree menu.
From the pop-up menu that appears, choose one of the following:

Option	What it does
Disconnect	Cuts the connection between the parameter and an attached shader.
Blend with	Opens another menu from which you can select a texture shader. The selected shader is blended with the parameter's value using a mixing shader. If a shader is already connected to the parameter, it is disconnected and replaced with the new shader and the mixer shader.
Insert	Opens another menu from which you can select a conversion shader (Invert, Color Correction, and so on). If a shader is already connected to the parameter, the conversion shader is inserted between the parameter and the previously connected shader.
Edit Conversions	Opens a combined property editor for all conversion shaders connected in series to the parameter. For example, if a Phong shader's diffuse parameter is connected to a Color Correction shader, which is connected to an Intensity shader, which is connected to an Image texture shader, choosing Edit Conversions will open a combined property editor for the Color Correction and Intensity shaders.
Image	An image is connected to the port using an Image shader.
Clips	Opens a sub-menu that lists all of the scene's image clips. You can select any clip from the list. The clip is connected to the parameter using an Image shader.
Sources	Opens a sub-menu that lists all of the scene's image sources. You can select any source from the list. A new image clip is created from the source and connected to the parameter using an Image shader.
[Various shaders]	Lists shaders that are commonly associated with the parameter. Selecting one of these shaders connects it to the parameter. If a shader is already connected to the parameter, it is disconnected and replaced with the new shader.
More...	Opens a browser so you can select any shader from the shader library. The selected shader is connected to the parameter. If a shader is already connected to the parameter, it is disconnected and replaced with the new shader and the mixer shader. Note: Once you select a shader from the browser, it will appear in a list of most recently used shaders under the More... option.

Disconnecting Nodes

Disconnecting nodes is as simple as connecting them. Use any of the following techniques:

Disconnecting a port

Do either of the following:

Right-click the port you want to disconnect and choose Disconnect from the pop-up menu.

Move the mouse pointer over the connection line, close to the input port. The line's right end is shaded in white.
Click and drag away from the port until the cursor changes to a pair of scissors, then release the mouse button.

You can also replace a connection by connecting a new node without disconnecting the first one.

NoteDisconnecting an input this way deletes any branch of the render tree that is connected only to that input. Nodes in the branch that are connected to other nodes are not deleted.

Disconnecting all of a node's inputs/outputs

Right-click the node whose inputs or outputs you want to disconnect.
From the pop-up menu, choose one of the following:
- Disconnect All Inputs removes all connections to the node's inputs.
- Disconnect All Outputs removes all connections from the node to any other nodes.
- Disconnect All removes all connections to and from the node.

Assigning Texture Projections to Nodes

Texture shaders and certain other properties require you to select a projection. You can specify an existing projection or create a new one using the texture projection control in the upper-left of the render tree.

A	If multiple objects use the same material, you can select the one(s) to affect: All or a specific object. This box appears only if a material is shared by multiple objects. It updates automatically as you select objects in the scene, as long as the render tree is not locked.
B	Select an existing projection to use. If an object already has one or more projections when you apply a texture, the texture will automatically use the first projection. However, this box will remain blank until you explicitly select a specific projection. If multiple objects with the same material use different projections, (multiple values) appears instead of a projection name. You can select a projection by name only if all objects have a projection with the same name. However if you are using a naming convention for projections on different objects, you can enter a string with a * wildcard pattern.
C	Click to modify the properties of the selected projection, as well as the support if applicable. In the case of multiple texture projections, a multi-selection property editor opens. Changes that you make from the property editor affect all projections.
D	Click to create a new projection. See Creating Texture Projections.

Besides viewing and editing texture projection information, you can also get information about other maps used by selected nodes (weight maps, color at vertices maps, and so on). If you select multiple nodes that use different types of maps, the texture projection controls are deactivated.

For information on texture projections in general, see Applying and Editing Textures.

Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License