Warnings in Substance compositing graphs
This page lists warnings and errors messages which may be triggered by Substance compositing graphs in Substance 3D Designer, and offers common troubleshooting steps for each.
Warnings are displayed in the warning icon's tooltip for the graph resource in the Explorer panel, as well as in the bottom left corner of the Graph view if the graph is loaded.
No output node defined
The graph does not have an Output node.
Solution
Add one or more Output nodes to the graph, and connect the output of the last node in a stream to it.
The [x] parameter's function has some warnings
The function graph applied to the specified parameter of the specified node has at least one warning.
The node parameter is specified between square brackets after the node label, following the template Node[Parameter]
.
E.g. Uniform Color[Output Color]
, Pixel Processor[Per Pixel Function]
Solution
Locate the node emitting the warning by its label and warning badge in the Graph view, then select it to display its properties in the Properties panel. Find the parameter emitting the warning and open its function by clicking the Edit function button.
Then, assess the warning(s) listed in the bottom left corner of the Graph view and solve the issues. You may refer to the Warnings in function graphs page for troubleshooting warnings reported in function graphs.
The referenced data has some warnings
The resource referenced by a node has one or more warnings. Here are some nodes referencing a resource:
- A graph instance node references a graph
- A Bitmap node references a Bitmap resource
- An SVG node references an SVG resource
- A Text node references a Font resource
Solution
In the Explorer panel, find the referenced resource and troubleshoot all warnings raised by the resource:
- For graphs, refer to other items in this page
- For any other type of resource, refer to the Warnings from dependencies page
Reference resource not found
The resource referenced by a node was not found at the path saved in the Substance 3D file (SBS). Here are some nodes referencing a resource:
- A graph instance node references a graph
- A Bitmap node references a Bitmap resource
- An SVG node references an SVG resource
- A Text node references a Font resource
Solution
For graph instance nodes
Check that the source graph exists in the package located at the path saved in their Package attribute.
If it does not, delete the instance node and replace it with an instance node referencing a valid package. Alternatively, you may recreate the package and graph referenced by the instance node, then reload the host package by clicking RMB on it in the Explorer panel and selecting the Reload option in the contextual menu.
Find the referenced resources in the Explorer panel and check they exist at the location saved in their File Path attribute.
If they do not, click RMB on the resource item in the Explorer and select the Relocate... option in the contextual menu to set a new valid target file for that resource.
Text node uses invalid font
A Text node references a font which cannot be loaded or parsed correctly.
Solution
Select the Text node and make a note of the value of its Font property. Find the source file for that font on your system and make sure it is healthy, e.g. by using it in another application such as a text editor. Replace the font by a healthy font file as necessary, or switch the Text node to another font.