Node Editor

Page content

The Node Editor has different modes, depending on which Node type is used. For example, if you enable the Scene Manager, the Scene mode (see also Scene Nodes Introduction) will be used; if you enable a Node Material, the Material mode will be used. In the following you will find references to the fact that a particular function will only work in a particular mode.

General

Material mode.

The following applies to the Node Editor (Material mode):

The Node Editor is where everything takes place when creating and editing Material Nodes (in the following referred to as Nodes). Everything you see in the Node Editor has to be linked with a Node Material (please note this tip), i.e., to create and edit Nodes, a Node Material must be selected. The Node Editor always displays the currently selected Node Material.

Please note that Nodes are quite complex and to use them effectively you need to have a higher level of knowledge about how shading and rendering works in general. However, several functions are very simple when a pre-defined material is used such as the Uber Material, which is almost as easy to use as a normal material (and can still be used in conjunction with an image node in various material channels)._

The general flow of data is always from left to right. At the far right, everything must always culminate in a Material Node (no Material Node means no working material; only 1 Material Node per material).

The Node Editor can be opened as follows:

The following applies to the Scene Node Editor:

The Node Edtor's content is not assigned to a specific element (such as the Material Node Editor to a Node Material) but is itself displayed in the scene. Therefore, the last output Node must always be connected to the scene output via its Op Output output, otherwise no geometry will be generated.

Note that the Scene Node Editor is designed for advanced users and a higher 3D skillset and technical knowledge is needed. See Szenen Nodes Introduction for a brief introduction.

The Scene Node Editor is opened via the Scene Node Editor command in the main menu (Window / Scene Node Editor).

The Editor also offers several special functions that are described farther down.

As with the Node Materials when they were introduced, the Scene Editor comes with a range of additional Nodes for specific uses. Many Nodes (such as the Math Node) work in both the Material Node Editor as in the Scene Node Editor. A description of most Nodes can be found under Individual Assets.

Several special Viewport settings for displaying geometry generated by the Scene Node Editor are available in the Project Preferences menu (see Nodes).

Note:Note also the Node Layout (at the top right of the main interface in the Layouts drop-down menu), which offers an interface designed for working with Nodes.

The following applies to the Node Editor (Capsule mode):

This mode is somewhat different from the previous two modes because it is activated automatically if a Node is removed from the Asset Construction Node group, e.g., dragged into the Object Manager or selected there. These Nodes make up the basis for the creation of Asset Capsules, with which you can, for example, create custom objects, selection methods, deformers or modeling commands and, among other things, combine them directly with normal objects in the Object Manager. Since these Nodes work like a group, the Node Editor will automatically display the content of the selected Asset Construction Node. However, if a conversion to an Asset was already done, the Capsule mode will be activated but the content of the Asset can no longer be displayed directly in the Node Editor. The Asset would, for example, have to be converted back to a group.

Node Editor

Navigation:

As with other Managers; the following hotkeys can be used to navigate in the Node Editor (see also commands in the View menu):

If you have the Navigator section open at the bottom right of the Node Editor (this can be opened via "Show Navigator" in the "View" menu), it can be used for navigation. Simply click on the location in the Navigator that you want to display centered in the Node Editor.

R26

The Node Editor offers a similar simplification of the Node display when zooming out of a setup. The Nodes' details and their text will be reduced continuously and finally hidden completely if you zoom out far enough. This way you can still see which Nodes are used and how they're connected even when you're zoomed out. The following series of images demonstrates this.


This series of images shows from top to bottom how details are automatically reduced the farther you zoom out.

Creating Nodes

Nodes can, for example, be created in the following ways.

Note that not all output ports can be connected with all input ports. Many file types will be converted automatically but there are limits to this (e.g., a ShadingContext cannot be connected with a BooleDatatype in the Material Node Editor). Cinema 4D will show you if a connection is possible: if you hover over the port to which you want to connect, the potential connection will be either bright (possible) or dark (not possible).

Moving Nodes

Nodes can be moved at any time by clicking and dragging them. Multiple selections will be moved as a whole. If you move your selection to the edge of the Node Editor view, the view will start to scroll correspondingly.

Connecting Nodes

Node can be created in the following ways (drag & drop, double-click, etc.):

In order to let data flow from one Node to another they must be connected: For this, Node outputs (right Node side) of one Node can be connected with the inputs of another Node (left Node side). To do so:

The following applies:

R26

Connections can also be updated automatically by dragging a Node onto an existing connector line. As soon as the line color brightens, the Node can be released and the original connection will be shared. In order for this to work, the linked data types have to be compatible with the available Input and Output ports. Connector lines will be added to Input and Output ports that are compatible with the respective Node, as shown below.


In this example, the cubes created will be colored by an Color Op Node. After the Color Op Node is created, drag it onto the Op Output line of the cube.


The result of the drag & drop action. The existing connection was automatically shared with the fitting Input and Outputs of the added Node.


Optimizing connections

When connecting ports, connector lines can intersect or run across other Nodes. This can negatively affect the readability of the setup. Connections can also be run through a detour point. The advantage of this can be seen in the images below.


In this exmple, the connection for the color value of one Node was partially covered.

In order to improve the readability of the setup, connector lines can be subdivided additionally. Similar to adding a new point to a linear spline, the course of a connector line can be modified individually. To do so, simple Ctrl + left-click on the connector line that you want to modify. This way you can add any number of detour points along a connector line. To remove a detour point, click on it and press Del on your keyboard.


Ctrl + hover over a connector line to create a detour point, which can be moved freely. Alternatively you can simply Ctrl + left-click on a connector line to create a detour point.

A detour point can be grabbed and moved with the mouse. The course of the connector line can be modified freely. Detour points can be added to create more complex detours.


The detour point can be moved with the mouse to modify the course of the connector line. In this example, the lines overlapping the Node can be moved.

This option can be used to make horizontally running setups in particular easier to read.


The more complex a setup becomes, the more overlapping that can occur. In this example, you can't properly see the connections between the mathematical Nodes at the center of the setup.


Using detour points, the setup can be made easier to read.

Detour points can not only be used to modify connector lines but can also make data available that should be passed vial the connector lines. The can therefore also be used as branch points for a given connections, as shown in the example below.


Here a detour point was used to improve the readability of the setup.

If the cursor is moved in the vicinity of a detour point, two port points will be displayed, from which a new connection can be dragged when clicked upon.


Additional points will be displayed when the cursor is placed near a detour point.

A detour point can be used like an Output port by linking the ports with a detour point with other Node inputs.


A detour point can be used like a port and also use additiona connector lines.

Existing detour points can be duplicated by Ctrl + drag & drop and placed outside of an existing connector line in the Node Editor. If a connector line is then dragged from such an independent detour point, the free-standing detour point can be used as a Value Node. You can then click on the detour point and enter a value via the Attribute Manager, which will be passed to the connected Node.

This function can also be very useful for making the setup more readable because detour points also have Basic settings in the Attribute Manager that can, for example, be used to add a comment to an applied value or modify a detour point's disaply color.


An existing detour point can be duplicated via Ctrl + drag & drop and placed anywhere in the Node Editor. If such a free-standing detour point is then connected with a Node input, the detour point can be used to input a value.

Selecting Nodes

Nodes can be selected dragging a rectangle around them (simply click on an empty area of the Node Editor view and drag) or by clicking on them. As always, the Shift and Ctrl/Cmd keys cam be used in conjunction with making selections. In the Edit menu you will find several additional selection commands (such as Select Connected). The selected Nodes’ settings are displayed in the Attribute Manager. This also applies to detour points.

Deleting Nodes

Selected Nodes can be deleted by pressing the Backspace- and Del- keys. This also works with detour points.

Node Editor Title

At the very top of the Node Editor you will find the following elements (from left to right):

Navigator

The Navigator is located at the bottom right of the Node Editor view - it's a small depiction of the entire Node constellation and serves for better orientation and quicker navigation, especially for complex Node setups. The light gray triangle shows the visible part of the Node Editor view. You can move this section by clicking and dragging in the view. By simply clicking on the Navigator you can display the respective section centered in the Node Editor.

The following Nodes have a special display:

Input and Output Group Areas

On each side of the Node you will see a dark edge (if output ports were already created). Connections/ports can be output with these areas by dropping a new connection into an empty region of the area. This makes little sense for individual Nodes but if you combine different groups with one another, you can use this method to create a port that is shown as a group port (as in the image below). This means that even in a group within a group a specific Node port at the very bottom can be connected from the outside (or as an output to the outside).

Node ports in groups can be led outside.

When a connection is released in an empty area, a small menu will open (see image bottom left) with the following options:

Parts of the described functionality (creating inputs) can also be done via the port context menu commands.

General information about Nodes

A Node setup and display example (it's also possible to only display connected ports).

The core component of the Node System is - logically - the Node. A Node has inputs into which data from other Nodes is entered, which is then processed by the Node and the result is passed to its outputs. Inputs and outputs have ports through which the connection to other Nodes can be made. Basically, an input port can only have a single connection and output can have any number of connections.

Nodes can be grabbed on the left or right edge and made wider or narrower.

A Node has an upper area and a lower area:

Upper area

The Node's name is displayed over the respective Node. If you rename the Node in the Basic tab, its new name as well as the original name will be displayed. The latter so you always know which type of Node you're working with. This is also the name used in the Help. The name in white text can also be modified by double-clicking on it.

The upper Node area contains the Node preview - for Nodes wherever it makes sense. If the settings of the connected input Nodes change, the preview will change accordingly. You can show or hide the preview using the small icon (2nd from the left) (a command can also be used - see above).

In the Preview you will find the Solo Mode option on the left (see Solo) if the Node Preview is supported, which is, for example, not the case for Nodes for the Scene Node. Next to it on the right is the Preview icon.

You can click on the third icon (only visible for Group Nodes) to display the group content in the Node View (double-clicking on the Node will do the same).

The Display Mode icon at the far right can be used to switch between port display modes, as can be done using the three port commands machen.

Below the row of icons you will see a color bar whose color is defined using the Color setting in the Basic tab. This can make it easier to find certain Nodes. By default, some Bode types are already colored but can be recolored at any time.

Lower area

The lower area contains the input ports on the left with their respective names and the output ports on the right with their respective names. Ports can be hidden, and their order can be changed by moving them. Note that not all input ports will necessarily be listed in the Node itself. These can be displayed using the context menu.

Certain Nodes (such as the Layer Node, for example) even have drop-down port groups for each layer.

Depending on the data type being processed, ports will be assigned a certain color (see next data types).

Ports can be selected (using the Shift or Ctrl/Cmd keys to add or remove selections) so they can be affected by certain commands (see Node menu or context menu).

Data types and colors

Inputs and outputs are colored accordingly. Fitting data types for input and outputs will be displayed using colors. The most important types are:

As in XPresso, atypical input and outputs can be connected with one another. As a rule, a constructive conversion of the data types will take place. For example, a texture can also be connected to an input for a float comma value. The texture's RGB values will then automatically be converted to brightness values. Using this method, color textures can also be used to, for example, control the Roughness of a BSDF layer. This type of conversion of data types is denoted at the receiving Node by an additional point at the respective input.

Context menu

If you right-click on a Node/port, a comprehensive context menu will open, which contains commands mostly from the Node Editor menu. These are described here, except for the following:

Switch Node Type

Here you can switch the respective Nodes (e.g., Geometry objects) from the Base Node to OP Node and vice-versa.

Add Input

Not all inputs listed in the Attribute Manager have to be displayed by the Node as a port. Sometimes only the most important are shown. Use the Add Port command to show all hidden ports. If one is selected, it will be displayed again (if All is selected, all input ports will be made visible).

This menu point is not available if all input ports are displayed.

Add Output

Normally, all outputs are displayed. If not, (e.g., if Remove Unused Ports was applied) these can be displayed by selecting one of the output ports from the list.

Propagate Port

A list will be displayed from which a Node to which you can link can be selected. If multiple output ports come into question per Node, click on the small black arrow and the output ports that can be selected will be displayed. In addition to the complete Asset list, the first entries will be existing Nodes where Nodes are listed that are contained in the current Node Editor view. There is also the Add Group Input option with which a port can be drawn from a group (see also Input and Output Group Areas).

Note that this list is created dynamically, and only fitting Nodes will be suggested.

Replace Node

For the current, connected input port, the "feeding" Node will be replaced by one from the list. Note that the complete Node chain will be deleted at the Node to be deleted. This only applies to the Nodes being fed: Nodes that are connected to other output ports remain unaffected.

Textures

All loaded textures are listed here. Select a texture from the list to feed it into the input port.

Load Texture

Selecting this option will open a context window from which you can select a bitmap or video, which will then be fed to the input port using an Image Node.

Remove Port Instance

Several Nodes such as the Layer Node or the Gradient make this command available. With it you can delete elements such as Layers or Knots.

Hide Port

Selecting this command will hide the selected ports. This only works with ports that are not connected. The hidden port will then appear in the previously described list under Add Input (and can be made visible there).

Note also the Show All Ports command and the next two commands described there. This is a different functionality from the hiding or displaying of ports.

Port Inspector/ Data Inspector

The Port Inspector can display the values of simple data types.

Details about these two Debugging tools can be found there.

Reset to Default Value

Most settings have a default value, which is defined when the Node is created. Using this command, modified values will be reset to their default values. This only affects Nodes that are not connected.

Propagate Port

Calling up this command (only of use when the Node Editor view shows a group's contents) creates a connection to the outside or to the parent hierarchy. See also Input and Output Group Areas.

Copy Value

Paste Value

Here you can copy values/types of individual ports to the cache (for a port with an integer value of 4 it would, for example, look like this: int64:4). These values/types can be pasted to other selected ports using the Paste Value command. The data types will be converted, if possible.

Copy Type

A data type can be copied using this command (fora port with an inter value of 4 it would, for example, look like this: int64). Since it's possible to create very complex data types (e.g., with a Switch Node) you can use this command to save time by simply copying the data type and paste it at the desired location. For example, for a Compose Container Node, for which you can also define data types, click on the button at the far right of Data Type and select Edit Data Type and paste the data type there.

Solo Port (only output)

A Solo functionality can be enabled for Nodes. If this Node has multiple outputs, one of them must be defined as a Solo Port, which is what this option does.

Set as View Port (only output)

In the upper area of a Node you will find the Node's preview. If a Node has multiple outputs, this option can be used to define which output should be displayed in the preview.

Connections

Proceed as follows to connect a Node port with another port:

Connections can also be selected, whereby you can almost always do so in conjunction with the Shift and Ctrl/Cmd keys to add or remove selections (clicking and dragging a box can also be used to make a selection). So what can be done with selected connections? They can, for example, be deleted or modified per context menu commands described below (only those commands not described elsewhere are described below).

Add Converter

If ports are already connected, this command can be called up. It places a Converter Node in the connection, i.e., its input and output are already properly connected.

Remove Connection

Deletes selected connection.

Muted connections will be displayed with a dashed line. Values will not be accepted from the previously connected Node but from the Attribute Manager instead. This lets you temporarily disable connections for test purposes, for example.

Other Node Editor components

The icons at the top right

At the top right of the Node Editor you will find the following 5 icons, from left to right:

Connectors

The most major change compared to the previous Attribute Manager are the linked fields that have been replaced by Connectors. Node inputs can either be fed with values by simply entering values for given settings or - and this is new - by connecting Node inputs with node outputs of other Nodes, i.e., make a connection (which is what Nodes are all about).

Click on the icon at the right of the setting name (the "connector") and select a Node from the Connect Node list to connect with the input that you select (you can, of course, simply connect ports in the Node Editor view). The selected Node will be created and linked:

Bitmaps can at any time be dragged from outside of Cinema 4D onto a complete parameter line *incl. parameter name, connecting icon and GUI element) to link a given setting using an Image Node.

As soon as a parameter is connected with another Node, the following applies:

The connector icon can have one of the following 3 states:

Clicking on a connector icon will make the following commands available, from which most should already be familiar from the port context menu. The connector icon makes a similar functionality available, which makes it possible to access a port in the Node Editor per right-click.

In the following, only the Connector's commands are described.

Add Layer

This command can, for example, be found in the Layer Node. The selected Node will be linked with a new layer.

Copy

Copies the connected output port to the cache.

Paste (Duplicate)

This command connects the output port in the cache with the input on which you click. Contrary to the previously described command, a duplicate of the entire feeding Node is created.

Remove

Removes the connection from the input port.

Mute Port

The connection is maintained but no data will be passed. Instead, the value defined in the Attribute Manager will be used for the input. Call up the command again to allow data to be passed again.

S26

Show in Node Editor

Shows the respective Nodes/Ports in the Node Eitor. Alternatively you can Ctrl + click on the link icon.

This lets you quickly connect multiple parameters selecetd in the Attribute Manager with Nodes in the Node Editor.

Show Subchannels

Several Nodes such as the Layer Node or Grading Node offer this mode. Enable this mode, for example, to display the layer settings as animatable or adjustable settings. In addition, the input settings of the feeding Node can be displayed by activating one of the layers. In the following example, the inputs would be those of the Circle Node.

Multiple port selections are also possible in order to compare values.

Info area

At the bottom left you will find the scalable Info area in which you will find information pertaining to Nodes, connections and ports.

For Nodes:

Additional information for connections:

Additional information for ports:

Opens the group (or double-click on the Node).

If an asset is encrypted, this command will be grayed out.

Save New Version...

When editing existing Assets, modifications made should be saved using this command. A dialog window will open that you should be familiar with from the Save Asset command (see above). Since the old Asset state is also saved, versioning will be implemented.

Save as New Asset...

When editing existing Assets, a new Asset can be saved without the aforementioned versioning. A dialog window will open that you should be familiar with from the Save Asset command (see above).

Material Node example scene

The following material was created using Nodes only. Not bitmap or texture was used!

Load the following scene:

Here you can get an idea of what is possible using Nodes. Right-click on the material and select Node Editor to see what the Node setup looks like. Note the Plaid Group Node in which additional Node networks are nested.

Special information about the Scene Node Editor

Aside from the descriptions above, the Scene Node Editor has several special features:

These connections are a conglomerate of different values.

Click on the small arrow at the Op Output port to open them and display the value type. To create geometrty that is visible in the scene, a Op Output port must always be connected with the Scene port.

S26

If, for example, you search for "Oil Tank", you will only be shown 1 result, contrary to versions prior to S26. This is because all Node versions are no longer shown (Base Node, OP Node). Instead you can drag an oil tank into the Node Editor, Scene Manager or Object Manager. The oil tank will then be evaluated as a Base Node or Asset Capsule.. The Switch Node Type command can then be used to switch between Base and OP Node in the Node Editor.