Preferences window

This page presents the Preferences window and all its settings.

You can find the Preferences window through the Edit menu in the main top bar the application. This dialog lets you adjust a number of settings. It is organized in tabs covering different areas of behavior and functionality.
We recommend reviewing all of these settings to get a better insight on how the application operates and how it can be tailored to your workflow.

For more information about how these preferences are stored and how you can integrate them in a production environment, you can refer to the User Preferences - Automating Setup page of the documentation.



General

Recent Documents

Recent documents list contains
Default: 10

This allows you to select the number of documents to list in the Recent Packages entry of the File item in the Main Menu.

History

History stack size
Default: 200

This indicates the number of available undo operations at any given time in the Edit > Undo item of the Main Menu.

The more undo operations you need, the more memory the application will require.

Language

Choose the language of the application
Default: System

This setting defines the language used in the application interface.
The available languages are English, Japanese or Korean. The System value will auto-detect language from your system language settings.

Changing this setting will only take effect after restarting the application.

Views

Invert zoom in views
Default: Unchecked

If checked, the zoom control will be inverted in the 2D View3D View and graphs.

Paths

Save/Export Path
Default: Last path

Determines whether the suggested save/export path is your last selected path, or the SBS package's path. The last selected path is saved across sessions.

Temporary Folder
Default: Path depending on system OS

When the image data of a graph exceeds the allocated memory pool (see below Memory > Image Cache), the overflowing data is written on disk. This setting lets you define the location the overflowing image cache data is written to.

This location is also used to store a copy of the currently open SBS package with the latest modifications since the last manual save.

Memory

Image Cache

The application keeps in cache a full-resolution, uncompressed image for each rendered node in the current graph.
Instance nodes will generate these images for all nodes of the graph they reference, and delete them once their outputs have been computed. Only the outputs are kept in memory at that point.

You can set the maximum cache size allocated to thumbnails and images in system memory, and see the current usage. If the cache data overflows its allocated pool, the excess data is written to the Temporary Folder (see above Paths > Temporary Folder).

Memory Budget
Default: Automatic

This allocation is calculated automatically to approximately 75% of the total system memory pool. To set this value manually, select the Custom option and set a value in the adjacent input field.

Please note writing to disk is orders of magnitude slower than writing to system memory. Therefore, graph rendering time will increase exponentially as overflowing data needs to be written to the Temporary Folder.
To prevent this from happening, we recommend taking a look at the suggestions for decreasing a graph's memory footprint in the Performance Optimization Guidelines section of the documentation.

Job Scheduler

During specific tasks, such as image conversions for thumbnails or the 2D View, separate jobs will be created and distributed across the system processing cores for efficiency. Each job will write data to system memory to perform its operations.
This setting lets you define the allocated memory pool for all concurrent jobs. When this pool is entirely used, new jobs will be queued until the current ones have completed.

Memory Budget
Default: Automatic

This allocation is calculated automatically to approximately 10% of the total system memory pool. To set this value manually, select the  Custom  option and set a value in the adjacent input field.

User Interface

Disable High DPI
Default: Unchecked

High DPI mode will maintain consistent scaling of text and user interface elements independently of the system's display and scaling settings.
Disabling (i.e. checkbox filled) this setting will let the interface be scaled, which results in larger and more readable text on some displays but can also create inconsistencies in text size, along with other layout issues.

Changing this setting will only take effect after restarting the application.

Auto Backup

An auto-save feature is included by default, which creates copies of the current state of open SBS packages at set periods of time. Auto-saves are placed in an .autosave folder at the SBS package location.

Auto backup every # minutes
Default: 5

The time period between each auto-save.

 Keep up to # versions
Default: 6

The maximum number of auto-saves to keep at any given time.

When the maximum amount of versions is reached, newer backups will delete the oldest backups.
Please also note auto-saves should be opened after moving them to the original SBS package location. They should not be opened at their current location.

Publishing and sending SBSAR files

Alawys save .sbs file when publishing to .sbsar or sending to another application
Default: true

Set the auto-save behavior when Publishing or Sending to another application.

Cooker

Cooking Size Limit
Default: 8192 pixels

Defines the maximum pixel resolution permitted for all nodes in any graph.
As a Substance material's output is always a square image of powers-of-2 resolution, the value set here defines both the maximum width and height, in pixels.

Engine

GPU Cache Limit
Default: 2048 MB

This setting lets you define how much memory should be reserved for caching render stages. Usually, the engine will cache the output of each node in a Substance 3D graph.

We recommend taking a look at the suggestions for decreasing a graph's memory footprint in the Performance Optimization Guidelines section of the documentation.

Projects

Please refer to the Projects settings page.



Graph

Common

Tab key shows node menu
Default: Checked

If checked, the Tab key will open the Node Menu, replicating the functionality of the 'Space' key.

Enable creation of nodes by click-dragging connectors
Default: Checked

If checked, when you click on any connector, drag the cursor and release the created link in graph empty space, the Node Menu will be displayed.

The menu will also be filtered according to the type of the connector which was clicked on. This means only nodes which are compatible with the clicked connector will be displayed.

View outputs in 3D view when opening a graph
Default: Checked

If checked, all graph outputs are automatically applied in the 3D View when that graph is opened.

This also has the effect of rendering all nodes which are part of a stream leading to an Output node.

Substance compositing graph

Automatically compute all nodes thumbnails when opening a graph
Default: Checked

If checked, automatically render all node thumbnails when loading the graph.

View output in 2D view when opening a graph
Default: Checked

If checked, the first graph output is automatically displayed in the 2D View when that graph is opened.

This also has the effect of rendering all nodes which are part of a stream leading to that Output node.

Automatically display newly created compositing node
Default: Checked

If checked, the 2D View will automatically update to display the output of a newly created node.

Automatically insert color/greyscale conversion node
Default: Unchecked

If checked, automatically resolve Color/Grayscale connection types mismatches, by placing specific nodes to perform the appropriate conversion.

When a Grayscale output (gray connector) is connected to a Color input (yellow connector), a Gradient Map node is automatically placed between the two connectors.
When a Color output (yellow connector) is connected to a Grayscale input (gray connector), a Grayscale Conversion node is automatically placed between the two connectors.

Enable graph editing in context
Default: Unchecked

By default, when opening a graph referenced by an instance node with a right-click on the node and selecting Open Reference, that graph is loaded and edited in isolation.

If checked, you can edit graphs referenced by instances using the information passed in the instance by the current graph. To do this, right-click on an instance node and select Open Reference In Context, or use the Ctrl+E keystroke.

This means an instanced graph can be edited in the context of the graph it is instanced into. This is very useful for seeing the effects of the edits on the graph you were working in. See example below.


Open Reference



Open Reference In Context



3D View

Misc

Environment hidden by default
Default: Checked

Determines the Environment default visibility setting. When hidden, the backdrop of the 3D View is replaced with a solid color.

Descale Factor
Default: 4

Lets you can also define the factor by which the texture applied to the environment is scaled down.

Viewport scaling
Default: Auto

Controls the scaling of the 3D View's rendering resolution when the system uses display scaling.

  • Auto: the rendering resolution is based on the scaled display resolution
  • None: the rendering resolution is based on the native display resolution

OpenGL

Sample Count
Default: 64

Impacts the size of the 3D View shaders' sample table . A higher value will result in higher image quality at the cost of performance.

The shaders' sample table is also impacted by the system's GPU and OS.



Iray

Hardware
Default: CPU checked if no compatible GPU / GPU checked and CPU unchecked otherwise.

Defines which hardware resources are allocated to Iray

 computation. The list should include the CPU and all compatible NVIDIA GPU(s) detected.

If a compatible NVIDIA GPU is detected, the GPU is checked and the CPU is unchecked by default.

Learn more in the Hardware acceleration section of the Iray page.



Bakers

GPU Raytracing
Default: Checked

If checked, raytracing will be performed on the GPU for compatible bakers.

The following GPU raytracing backends will be the default depending on the GPU architecture:

  • DXR: Nvidia Turing and newer

Optix: Nvidia Pascal/Maxwell

More information about GPU-powered bakers is available in the GPU Raytracing  section of the Substance Bakers documentation.

You can use the following command line arguments when starting the application to force the use of a different GPU raytracing backend:

  • --force-optix : force the use of Optix on Nvidia Turing or newer GPUs
  • --force-dxr : force the use of DXR on Nvidia Pascal GPUs



Library

Rebuild Thumbnails

The option will trigger a recalculation of all Library thumbnails, which will automatically replace the previous ones.

Shortcuts

You can assign custom keyboard shortcuts for creating nodes in graphs.

Shortcuts can be assigned for nodes in all graph types: Substance compositing graphs, Substance model graphsFunction graphs, FX-Map graphs and MDL graphs.

Any node can be assigned a shortcut, even custom library nodes. A same shortcut can be assigned in different graph types. No shortcuts are assigned by default, you are free to customize this to your liking. 

In case of a conflict with another node shortcut, or a built-in program shortcut, the entry will be highlighted a warning will be displayed. The shortcut will have no effect until the conflict is resolved.