- Substance 3D home
- User guide
- Glossary
- Getting started
- Interface
- Interface
- Customizing your workspace
- Home screen
- Main toolbar
- Preferences
- Explorer
- Graph view
- Library
- Properties
- 2D view
- 3D view
- Dependency manager
- Resources
- Resources
- Importing, linking and new resources
- Bitmap resource
- Vector graphics (SVG) resource
- 3D scene resource
- AxF (Appearance eXchange Format)
- Font resource
- Warnings from dependencies
- Substance graphs
- Substance graphs
- Substance graph key concepts
- Creating a Substance graph
- Exposing a parameter
- Graph parameters
- Inheritance in Substance graphs
- Output size
- Values in Substance graphs
- Publishing Substance 3D asset files (SBSAR)
- Exporting bitmaps
- Exporting PSD files
- Sample Substance graphs
- Warnings in Substance graphs
- Nodes reference for Substance graphs
- Nodes reference for Substance graphs
- Atomic nodes
- Node library
- Node library
- Texture generators
- Texture generators
- Noises
- Noises
- 3D Perlin noise
- 3D Perlin noise fractal
- 3D Ridged noise fractal
- 3D Simplex noise
- 3D Voronoi
- 3D Voronoi fractal
- 3D Worley noise
- Anisotropic noise
- Blue noise fast
- BnW spots 1
- BnW spots 2
- BnW spots 3
- Cells 1
- Cells 2
- Cells 3
- Cells 4
- Clouds 1
- Clouds 2
- Clouds 3
- Creased
- Crystal 1
- Crystal 2
- Directional noise 1
- Directional noise 2
- Directional noise 3
- Directional noise 4
- Directional scratches
- Dirt 1
- Dirt 2
- Dirt 3
- Dirt 4
- Dirt 5
- Dirt gradient
- Fluid
- Fractal sum 1
- Fractal sum 2
- Fractal sum 3
- Fractal sum 4
- Fractal sum base
- Fur 1
- Fur 2
- Fur 3
- Gaussian noise
- Gaussian spots 1
- Gaussian spots 2
- Grunge concrete
- Grunge Damas
- Grunge galvanic large
- Grunge galvanic small
- Grunge leaks
- Grunge leaky paint
- Grunge map 001
- Grunge map 002
- Grunge map 003
- Grunge map 004
- Grunge map 005
- Grunge map 006
- Grunge map 007
- Grunge map 008
- Grunge map 009
- Grunge map 010
- Grunge map 011
- Grunge map 012
- Grunge map 013
- Grunge map 014
- Grunge map 015
- Grunge rough dirty
- Grunge rust fine
- Grunge scratches dirty
- Grunge scratches fine
- Grunge scratches rough
- Grunge shavings
- Grunge splashes dusty
- Grunge spots
- Grunge spots dirty
- Liquid
- Messy fibers 1
- Messy fibers 2
- Messy fibers 3
- Microscope view
- Moisture noise
- Perlin noise
- Plasma
- Caustics
- Voronoi
- Voronoi fractal
- Waveform 1
- White noise
- White noise fast
- Patterns
- Patterns
- 3D linear gradient
- 3D volume mask
- Alveolus
- Arc pavement
- Brick 1
- Brick 2
- Brick generator
- Checker 1
- Cube 3D
- Cube 3D GBuffers
- Fibers 1
- Fibers 2
- Gaussian 1
- Gaussian 2
- Gradient axial
- Gradient axial reflected
- Gradient circular
- Gradient linear 1
- Gradient linear 2
- Gradient linear 3
- Gradient radial
- Height extrude
- Mesh 1
- Mesh 2
- Panorama shape
- Polygon 1
- Polygon 2
- Scratches generator
- Shape
- Shape extrude
- Shape mapper
- Shape splatter
- Shape splatter blend
- Shape splatter data extract
- Shape splatter to mask
- Splatter
- Splatter circular
- Star
- Starburst
- Stripes
- Tile generator
- Tile random
- Tile random 2
- Tile sampler
- Triangle grid
- Weave 1
- Weave 2
- Weave generator
- Filters
- Filters
- Adjustments
- Adjustments
- Apply color palette
- Auto levels
- Channel mixer
- Chrominance extract
- Clamp
- Color match
- Color to mask
- Contrast/Luminosity
- Convert to linear
- Convert to sRGB
- Create color palette (16)
- Grayscale conversion advanced
- Hald CLUT
- HDR range viewer
- Height map frequencies mapper
- Highpass
- Histogram compute
- Histogram equalize
- Histogram range
- Histogram render
- Histogram scan
- Non-uniform histogram scan
- Histogram select
- Histogram shift
- ID to mask grayscale
- Invert
- Lighting cancel high frequencies
- Lighting cancel low frequencies
- Luminance highpass
- Min max
- Modify color palette
- Pow
- Quantize color (Simple)
- Quantize color
- Quantize grayscale
- Replace color
- Replace color range
- Threshold
- View color palette
- Blending
- Blurs
- Channels
- Effects
- Effects
- 3D texture position
- 3D texture SDF
- 3D texture surface render
- 3D texture volume render
- Ambient occlusion (HBAO)
- Ambient occlusion (RTAO)
- Anisotropic Kuwahara color
- Anisotropic Kuwahara grayscale
- Bevel
- Bevel smooth
- Cross section
- Curvature
- Curvature smooth
- Curvature sobel
- Diffusion color
- Diffusion grayscale
- Diffusion UV
- Directional distance
- Edge detect
- Emboss with gloss
- Extend shape
- Flood fill
- Flood fill mapper
- Flood fill to Bbox size
- Flood Fill to gradient
- Flood Fill to grayscale/color
- Flood Fill to index
- Flood Fill to position
- Flood Fill to random color
- Flood Fill to random grayscale
- FXAA
- Glow
- Mosaic
- Multi directional warp
- Non-uniform directional warp
- Reaction diffusion fast
- RT irradiance
- RT shadow
- Shadows
- Shape drop shadow
- Shape glow
- Shape stroke
- Summed area table
- Swirl
- Uber emboss
- Vector morph
- Vector warp
- Normal map
- Tiling
- Transforms
- Material filters
- Material filters
- 1-click
- Effects (Material)
- Transforms (Material)
- Blending (Material)
- PBR utilities
- Scan processing
- Mesh-based generators
- Mesh-based generators
- Mask generators
- Weathering
- Utilities (Mesh-based generators)
- Spline & Path tools
- Spline & Path tools
- Working with Path & Spline tools
- Path tools
- Spline tools
- Spline tools
- Paths to Spline
- Point list
- Scatter on Spline color
- Scatter on Spline grayscale
- Spline 2D transform
- Spline (Cubic)
- Spline (Poly quadratic)
- Spline append
- Spline bridge (2 Splines)
- Spline bridge (List)
- Spline bridge mapper color
- Spline bridge mapper grayscale
- Spline circle
- Spline fill
- Spline flow mapper
- Spline mapper color
- Spline mapper grayscale
- Spline merge list
- Spline render
- Spline sample height
- Spline sample thickness
- Spline select
- Spline warp
- UV mapper color
- UV mapper grayscale
- 3D view (Library)
- 3D view (Library)
- HDRI tools
- Node library
- Substance function graphs
- Substance function graphs
- What is a Substance function graph?
- Create and edit a Substance function graph
- The Substance function graph
- Variables
- FX-maps
- FX-Maps
- How it works
- The Iterate node
- The Quadrant node
- Using Substance function graphs in FX-Maps
- Warnings in Substance function graphs
- Sample Substance function graphs
- Nodes reference for Substance function graphs
- MDL graphs
- Bakers
- Best practices
- Pipeline and project configuration
- Color management
- Package metadata
- Scripting
- Scripting
- Plugin basics
- Plugin search paths
- Plugins packages
- Plugin manager
- Python editor
- Accessing graphs and selections
- Nodes and properties
- Undo and redo
- Application callbacks
- Creating user interface elements
- Adding actions to the Explorer toolbar
- Using color management
- Using spot colors
- Logging
- Using threads
- Debugging plugins using Visual Studio Code
- Porting previous plugins
- Packaging plugins
- Scripting API reference
- Technical issues
- Release notes
Color Management
This page explains the Color Management features and settings in Substance 3D Designer.
Substance 3D Designer can be configured to use OpenColorIO (OCIO) or Adobe Color Engine (ACE) for Color Management. This allows you to have consistent color transforms and image display across multiple applications.
In this mode, Designer will work internally with linear RGB colors. Since 8-bit depth is usually not enough to represent linear colors, it is recommended to use at least 16-bit depth for color textures in the graph.
An effective Color Management workflow relies on working with a correctly calibrated display, Third party solutions exist to correctly calibrate your monitor for your work environment using specialised hardware.
OpenColorIO users should use matching OpenColorIO color spaces for their monitors.
Adobe ACE users should make sure the ICC profiles selected in the OS matches their monitors.
In this page
Configuration
Color Management settings can be configured in Projects tab of the Preferences dialog. You can set the following settings:
Color Management Mode
Color management |
This setting lets you select the Legacy, OpenColorIO or Adobe ACE modes for Color Management in Substance 3D Designer. Default: Legacy |
OpenColorIO configuration
When using the OpenColorIO mode for Color Management, Designer will use the information stored in a configuration file (*.config) to perform color transforms, identify color spaces and set defaults.
Substance 3D Designer ships with the following configurations:
- Substance: a simple configuration which includes common color spaces
- ACES 1.0.3: the full-featured Academy Color Encoding System (ACES) configuration, an industry standard for Color Management workflows
You can find these configuration files in the resources > ocio folder of Designer's installation files.
OpenColorIO Configuration |
This setting lets you select the OpenColorIO configuration file to use throughout Designer. Alternatively, you can set the OpenColorIO configuration file using the OCIO environment variable.
Alert:
After adding the environment variable, we recommend closing Designer, signing out from your user session in the OS, then signing back in. This ensures the environment variable is in effect when starting Designer. Default: Substance |
Custom Configuration File |
If the Custom option is set in OpenColorIO Configuration, you can select the specific *.config file to use as a configuration file in this field. Default: set by OpenColorIO configuration file or OCIO environment variable |
Bitmap Color Space Defaults
8-bit images |
Sets the default color space for 8-bit bitmaps. Default: Set by OpenColorIO configuration file |
16-bit images |
Sets the default color space for 16-bit bitmaps. Default: Set by OpenColorIO configuration file |
Floating point images |
Sets the default color space for floating point precision bitmaps, such as HDR images in the *.exr or *.hdr formats. Default: Set by OpenColorIO configuration file |
Use file name to detect color space |
Lets Designer assign a color space automatically if the suffix of a bitmap filename matches exactly the the lowercase name of a color space included in the current OpenColorIO configuration. Example: a bitmap resource mybitmap_aces_acescg.png would be automatically set to the ACES - ACEScg color space, and the appropriate transform will be applied to the working color space. Default: Checked |
2D and 3D View Display Default
Color settings
When using the Adobe ACE mode for Color Management, Substance 3D Designer will use the information stored in ICC Profiles (*.icc / *.icm) to perform color transforms and identify color spaces.
Designer ships with a number of ICC Profiles. You can find the files for these profiles in the resources > icc
folder of Designer's installation files.
You can add your own ICC Profiles by placing these files in the Adobe/Adobe Substance 3D Designer/icc
location in the Documents folder for the current system user.
Working space |
This setting lets you select the working color space to perform color operations throughout Substance 3D Designer. Default: sRGB IEC61966-2.1 |
Rendering intent |
This option lets you control how colors should be transformed when they are outside the gamut of the working colour space. Default: Relative Colorimetric |
Bitmap Color Space Defaults
8-bit images |
Sets the default ICC profile to use for 8-bit bitmaps. Default: sRGB IEC61966-2.1 |
16-bit images |
Sets the default ICC profile to use 16-bit bitmaps. Default: sRGB IEC61966-2.1 |
Floating point images |
Sets the default ICC profile to use for floating point precision bitmaps, such as HDR images in the *.exr or *.hdr formats. Default: Raw (i.e. no profile applied) |
Use embedded ICC profiles when available |
Lets Designer use the ICC profile embedded in a bitmap instead of the defaults listed above. Default: Checked |
2D and 3D View Display Default Space
Graph Display
Color manage thumbnails |
When checked, Designer will transform the node thumbnails to the current working color space. Default: Unchecked |
Legacy mode
When using Legacy mode, Color Management is disabled in Designer-
In this mode, graphs and images behave exactly in the same way as in previous versions. This means your workflow from previous versions is entirely unaffected if this setting is left untouched. There are however some useful additions:
You can choose to use ACES sRGB tonemapping in the 3D View to match the output of other software, such as Unreal Engine.
You can set a colour space for exported bitmaps as described in the Exporting Outputs section in this page. The available color spaces are the following:
- sRGB
- Linear
- Raw
In Legacy mode, Designer uses the sRGB working color space, which can be reproduced by most displays.
Considering the 'Raw' option writes the image data as-is from the graph – i.e. using the graph working color space – this means the Raw and sRGB options result in the same color output.
By default, the 'sRGB' option will be set for outputs which contain color information (e.g. Base Color, Emissive), and the 'Raw' option is set for outputs which hold pure data (e.g. Roughness, Metallic, Height, Normal). As explained above, these defaults effectively result in the same colors, and are set only to differentiate the end usage of their outputs.
The Linear option is the only one which results in a color transform being applied to the image, and may be only used for High Dynamic Range (HDR) images, which commonly use floating point precision (i.e. 16F or 32F bit depth) in linear color space. This allows these images to be used in a wide array of color spaces and production environments.
Importing bitmaps
You can assign a color space (OCIO) or ICC profile (Adobe ACE) to imported and linked bitmaps.
When importing or linking bitmaps, a color space or ICC profile will be set by default to the bitmap resource using the options set in the Bitmap Color Space Default section of the Color Management tab in the Project settings.
You can change the color space of a bitmap at any time, the option is located in the bitmap resource's Properties.
OpenColorIO only
In particular, the file name can be used to set the appropriate color space automatically. Please note the color space name in the file name must match the name in the OpenColorIO configuration file (e.g. myImage_utility - linear -srgb.png will be set to the Utility - Linear - sRGB color space).
You can also assign a color space (OCIO) or attach an ICC profile (Adobe ACE) to images saved from the 2D View.
Display toolbar
You can toggle Color Management on/off and change the display transform for the view at any time using the drop down menu in the display toolbar.
Library HDRI environments
The HDRI environments shipped with Designer are in the Linear sRGB color space.
When using an OpenColorIO configuration where the scene linear color space is not Linear sRGB – such as the ACES configuration – the environment will display incorrect colors.
In that case, the color space for library HDRI environments should be set manually in the environment properties, available in the 3D View panel Environment menu.
Color conversion nodes
The Library includes the following nodes for performing conversions to and from the ACEScg color space:
- ACEScg to Linear sRGB
- Linear sRGB to ACEScg
- ACEScg to sRGB
- sRGB to ACEScg
- ACEScg to Linear sRGB
- Linear sRGB to ACEScg
These are useful when working with graphs created without Color Management or materials from the Substance 3D assets library.
Known limitations
The current implementation of color management in Substance 3D Designer has the following limitations:
- Color management is currently not exposed in the Python API;
- Color management does not work with MDL graphs;
- OpenColorIO looks are not supported.