The graph view

This page presents the Graph view of Substance 3D Designer.

The graph view is the main window of Substance 3D Designer, where you author and edit your graphs. The graph view has two main areas: a toolbar at the top, providing quick access to certain functions, and the actual graph area where nodes are placed.

The graph view is used for all graph types, but differs slightly between Substance compositing graphs, Substance model graphsfunction graphs, MDL graphs and FX-Map graphs, mainly in the toolbar area. 



Navigation

Navigating the graph happens in two dimensions, by Panning and Zooming.

  • You Pan by dragging anywhere on the graph with Middle-Mouse Button, or by dragging with Ctrl + Right Mouse Button.
  • You Zoom by Scrolling up or down with the Mouse Wheel, or by dragging up and down with Alt + Right-Mouse Button.

Zoom direction

Each of the zooming methods is inverted with the other:

  • Mouse wheel up pulls the graph view closer
  • Alt+RMB and drag up pushes the graph view away

You Focus on the selected Node(s), or the whole graph if nothing is selected, with Hotkey F

Navigation can also happen by using Pins and Hotkey F2, see graph Items.



Placing and managing nodes

Nodes can be placed in the graph in 5 ways. Each method works for all types of graphs.

  • By clicking or dragging from an icon on the node toolbar (see below). Only Atomic nodes can be placed this way.
  • By right-clicking on an empty area of the graph, and choosing Add node.  Only Atomic nodes can be placed this way.
  • By dragging a thumbnail from the Library View into the graph View. This method works for all types of nodes, including node Instances.
  • By pressing Spacebar to access the quick menu. This menu provides access to all node types, has a search interface and lets your favorite certain nodes so they appear on top of the list.
    This menu filters its results based on the currently selected node's output types, showing only nodes that can be connected without errors.
  • By binding keyboard shortcuts to the creation of specific nodes. See Preferences window.

If a node is placed when another node is selected, Designer will attempt to automatically connect the new node to the old node.
This automatic connection always places the new node after the old one in the flow.

Removing nodes can be done in two ways, depending on how you want a lost link to be treated:

  • Select a node and press Delete, or right-click and choose Delete Selection. This breaks all existing connections, potentially leading to broken functionality.
  • Select a node and press Backspace, or right-click and choose Delete and Relink. This attempts to keep links when possible, preventing broken functionality.



Links in Designer are created either when a node is placed, or by manually dragging a link between two connections. 


Links are removed by either selecting the link and pressing Delete, or by Alt-clicking on any connection that has links. Alt-clicking deletes all links on that connection.

Links can be duplicated by Ctrl-dragging from a connection.

Links can be picked up and moved between connections by Shift-dragging them between connections.



Disabling nodes

This only applies to Substance compositing graphs.

Nodes can be disabled so they have no effect in the graph but do not need to be disconnected or deleted.

Disabled nodes have the following behaviour:

  • They are displayed with the  Disabled badge, a dashed outline, and an interior rerouting link instead of a thumbnail
  • The nodes will output the data received in their main input
  • Disabled nodes can be chained together
  • Their properties and connections are not modified
  • Their disabled state is saved and persists across sessions
  • When publishing to SBSAR, the resulting file takes into account the disabled state of nodes – i.e. what you see is what you get

You can disable a node or a group of selected nodes by using the Shift+D keystroke, or by right-clicking in the graph and selecting the Disable node/Disable selection item in the contextual menu.

Only nodes which match the following criteria may be disabled:

  • The node has at least one input
  • The node has only one output
  • The types of the main input and of the output must match – i.e. grayscale to grayscale, color to color
  • All selected nodes must have the same state – i.e. all must be enabled, the same rule applies for enabling them

Interacting with the 2D View

This only applies to Substance compositing graphs.

To display a node output in the 2D View, double-click LMB on a node, or click RMB on the node and select the View Output in 2D View option in the contextual menu. If the node has more than one output, select the desired output in the submenu.

You may display any of the graph outputs in the 2D View by clicking RMB on an empty area in the Graph View, and selecting the View Output in 2D View option in the contextual menu. If the graph has more than one output, select the desired output in the submenu.



Interacting with the 3D View

To apply an node output in the 3D View, click RMB on a node and select the View in 3D View option in the contextual menu. If the node has more than one output, select the desired output in the submenu. Then choose a target channel of the shader currently used in the 3D View.

(Substance compositing graph only) You may apply all the graph outputs in the 3D View by clicking RMB on an empty area in the Graph View, and selecting the View Outputs in 3D View option in the contextual menu. Make sure one or more Output nodes are present in the graph and that it is set up correctly.



Toolbars

The full list only applies to Substance compositing graphs. Other graph types have a limited set of these options.

Graph tools

The main toolbar can be found in every graph type, and provides general functions, as well as toggles for the visibility of the other toolbars. You can find these functions:

 Focus selection (or press F) - Focus view on selection, or whole scene if selection is empty.

Reset zoom (or press Z) - Bring back the current zoom level to it's default state, and centers the view on the middle of the graph. Can mean zooming in or out.

Export Graph view - Exports the full graph at a 1:1 resolution as an image. Useful for sharing a screenshot of your entire graph.

 Node information

  • Display Connector name - Toggles the name display of each individual Connector on a node.
  • Display node Badges  - Toggles node Badges on all nodes.
  • Display node Size - Toggles node resolution display.
  • Display Timings - Toggles display of millisecond timings for each node.
  • Limit text scaling when zooming out - Keeps the text of graph items at a constant screen size past a zoom threshold, which keeps the text clearly visible when zooming out.

 Node finder (or press Ctrl+F)- Opens up extra are of the toolbar to search and highlight nodes within your graph.

 Highlight flow - Highlight any nodes connected before, or after the currently selected node. Good for tracing a complex path of nodes.

 Node palette - shows or hide the node toolbar, see below.

 Rectangle links - Switch between rounded or rectangular-shaped links between nodes. Not available for FX-Maps.

 Align tools - Toggles display of the Align Tools


Only on Substance compositing graphs:

 Parent size - Toggles display of the Parent Resolution control settings, see below.

 Link Creation Modes - Choose between Standard (Hotkey 1), material (Hotkey 2) and Compact material (Hotkey 3) link creation modes.

 Timings control - Lets you Reset all nodes and Reset all Timings.

 Tools

 Node image cache - Toggles display of the node image cache toggle, see below.


Node palette

The node toolbar differs depending on the graph type:


For Substance compositing graphs, see atomic nodes and graph items for more information on each item.


For Substance model graphsfunction graphs and MDL graphs, see graph items.


For FX-Maps, also see graph items.


Parent size

This toolbar is only available in Substance compositing graphs, and sets the Output Size of the graph's parent, which impacts the graph's Output Size if it uses the Relative to parent inheritance method.

Horizontal and vertical size are linked by default, but can be unlinked for non-square textures. Values can also be reset to the default value of 256*256.


Node image cache

This toggle the use of cache when computing nodes in Substance compositing graphs.

When a node is computed, its output images are stored in memory – i.e., cache – so they can be reused when recomputing the graph if this node is not impacted by a change. This means only the part of the graph which actually changes gets recomputed.
The memory storage limit of this cache can be changed in the General section of the Preferences, under the Memory section.

Enabling this option results in a large boost to the overall responsiveness of graph computations, at the cost of a significant increase of Designer's memory usage.


Align tools

These tools are a set of simple helpers to align and organize your nodes. They work in all graph types.

 Align horizontally - Aligns all selected nodes horizontally.

 Align vertically - Aligns all selected nodes vertically.

 Snap nodes to grid - Snaps all selected nodes to nearest grid positions.