User Guide Cancel

Color Management | Substance 3D Designer

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.

Alert:

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


Color management settings in Project files

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 LegacyOpenColorIO or Adobe ACE modes for Color Management in Substance 3D Designer.

Default: Legacy


OpenColorIO

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.
When it exists, the configuration file will be locked in Designer. It is still possible to change default color spaces and displays transforms (see settings below).

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.
You also may use the command line to create a temporary environment variable and start Designer from the same command line environment.

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

2D and 3D view display default

Sets the default display color space for the 2D view and 3D view viewports.

Default: Set by OpenColor IO configuration file

Color manage thumbnails

Lets Designer automatically transform the node thumbnails to the working color space in the graph.

Default: Checked


Adobe ACE

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

2D and 3D view display default

Sets the default display color space for the 2D view and 3D view viewports.

Default: ICC Profile for the main screen, retrieved from the OS

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.

Note:
For more information about image exports, you can refer to the Exporting Bitmaps page of the documentation.

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.

Note:

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).

Bitmap color space setting


Exporting outputs

When using the Export Outputs dialog, it is possible to assign a color space (OCIO) or attach an ICC profile (Adobe ACE) for each output.
Designer will convert images to the specified color spaces before saving the image files.

Export outputs dialog

You can also assign a color space (OCIO) or attach an ICC profile (Adobe ACE) to images saved from the 2D View.

2D View export options


2D & 3D views

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.

Color space setting in 2D View

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 space setting of 3D View environment


Color conversion nodes

The Library includes the following nodes for performing conversions to and from the ACEScg color space:

Substance graph

  • ACEScg to Linear sRGB
  • Linear sRGB to ACEScg
  • ACEScg to sRGB
  • sRGB to ACEScg

Substance function graph

  • 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.

Color conversion nodes in Library


Known limitations

The current implementation of color management in Substance 3D Designer has the following limitations:

Get help faster and easier

New user?