Graph parameters


This page describes the standard parameters for the Substance Compositing Graph.

A graph has several parameters that you can modify. You can find them by either clicking on empty space in the graph, or selecting the graph item in the Explorer panel. Parameters will be then displayed in the Parameters view.



Base Parameters

The Base Parameters section includes parameters which have an impact on all the nodes it contains. Every node in this graph which have one or more Base Parameters set to Relative To Parent will get their corresponding values from the graph's.


Output Size

This parameter allows you to chose the base resolution of images in the graph. Read more about the Output Size.

Default: (0,0) - Relative To Parent

Output Format

Allows to choose base bit depth in the graph, from these options:

  • 8 bit
  • 16 bit
  • HDR Low Precision 16F (16 bit floating point)
  • HDR High Precision 32F (32 bit floating point)

Default: 8 Bits per Channel - Relative To Parent

Pixel Size

Defines the pixel size. We recommend leaving both Width and Height values set to 1.

Default: (1,1) - Relative To Parent

Tiling Mode

Defines the base tiling mode in the graph from these options:

  • No Tiling
  • Horizontal Tiling
  • Vertical Tiling
  • H and V Tiling

Default: H and V Tiling - Relative To Parent

Random Seed

Defines the base random seed for the graph.

Default: 0 - Relative To Parent



Attributes

The Attributes section contains metadata for the graph, which provides information for identifying, categorising and applying the graph as designed by its author.


Identifier

This is the name of the graph, and must be unique – you cannot have two or more graphs with the same Identifier in the same package. It is used as the graph's name in the Explorer panel. 

You can use only the following characters for this value: A-Z, 1-9, @$%[{]}_-
Unauthorised characters are automatically replaced by a '_' character.

Default: New_Graph, or set by user at graph creation

Package

The absolute filename for the Package this graph belongs to.

The Folder button can let you open a new system file browser window at this location.

Default: Package filename / Empty if package was never saved

Exposed in SBSAR

This controls whether the graph and its outputs can be viewed in the SBSAR file published from the graph's Package.

This is useful if some graphs in the package are only used as subgraphs for the main graph of the package, and should not appear in the SBSAR.

Default: Yes

Description

This is the description text of the graph.

It is visible in the tooltip for the graph entry in the Library, any Instance node for this graph, and software with an existing Substance Integration.

Default: Empty

Category

You can this field to set a category for this graph item in the Library.

Default: Empty

Label

The Label is used instead of the Identifier to display the name of the graph for better readability in user facing scenarios – e.g. Library entry or Instance node label.
A label can be not unique, and can contain special characters.

Reminder

If you rename a graph – e.g. in the Explorer, you may also want to change the label!

Default: Empty

Author

You can use this field to put the name of the author.

Default: Empty

Author URL

This field lets you input an URL – e.g. the author's website.

Default: Empty

Tags

You can use this field to add your own tags, for improving the searchability and discoverability of the graph.

Default: Empty

Physical Size

This indicated the span the texture would have in the physical world, in X (length), Y (width) and Z (height). It is therefore inherently related to the material which is produced in the graph.

The Physical Size can be used, for instance, to display the texture at its correct ratio in the 2D View and 3D View.

The Z value is currently not taken into account in the 3D View. The Height Scale value for the material should therefore be set using an Output node set to the heightscale usage, or directly in the Material Properties.

Default: (0,0,0)

User Data

You can use this field to add your own additional data. This is useful for custom integrations in third-party software.

Default: Empty

Show in Library

Controls whether the graph should be visible in the Library, if the package is stored in a location which is watched by the Library.

Default: Set in the Library tab of the Project Settings

Icon

This area lets you define an icon which will be used by the Library to display this graph's entry, both as an SBS and an SBSAR. The icon is also used in other situations, such as Substance Painter's Shelf.

The area offers the following options:

  • Browse: Lets you browse your system files for the existing image which should be used as an icon
  • Generate: This generates an icon using a built-in preset of the PBR Render node
  • Paste: Lets you paste the image data currently in the clipboard as an icon
  • Remove: This option removes the existing icon and leaves the icon slot empty

The Generate option uses the Physical Size to determine the PBR Render's Height Scale for its displacement effect.
If an Output node set to the physicalsize usage exists in the graph, this output is used. If no such output exists, the value from the graph's Attributes is used instead.
If the attribute's value is (0,0,0), then the preset value of 0.1 is used.

When no icon is defined, the first image output for the graph is used instead.

Default: Empty



Input Parameters

All the Input Parameters – which include exposed parameters – are managed, edited and previewed here. Presets can also be created for some or all parameters.

Read how to expose a parameter.




Inputs

In this part, all the Input values (Value Input node) and bitmaps (Color Input and Greyscale Input nodes) are listed.

You can reorder them by using drag and drop on the handle on the far left of each item.



Outputs

In this part, all the Output bitmaps and values (Output node) of the graph are listed.

You can reorder them by using drag and drop on the handle on the far left of each item.