Version 7.4

Substance 3D Painter 7.4 adds support for OpenColorIO with the introduction of the new Color Management workflow.

Release date: 24 November 2021

Major features

New color management

This version introduces color management with the support of OpenColorIO (OCIO for short) version 2.

This new workflow allows to manage and calibrate colors from import to export and inside the viewport as well, allowing to match any content across different applications more easily.

  • Project settings
    When creating a new project it is now possible to enable color management. Existing project can also enable color management via the project settings.
    To enable color management, switch from Legacy (default) to OpenColorIO and use one of the default configurations or a custom one.

  • Viewport display settings
    At the top of the 2D and 3D views are two controls for color management:
    Color button: enable or disable the color transformation of the viewport.
    Display transform dropdown: select which display transform to use to convert the colors.

  • Color picker settings
    When color management is enabled, the color pickers offers new controls. Color are edited in the working color space specified by the configuration.
    Below the HSV/RGB sliders is displayed the final color value, transformed from the working space to the display color space.

  • Import bitmaps and Substance materials with custom color space
    Dedicated settings are available to specify how resources should be handled, including how Substance materials output should be interpreted.
    It is also possible to know which color space a resource is using by parsing its filename.

  • Export settings
    When exporting textures, color managed channels will display in their filenames the name of the color space used with the help of the new keyword $colorSpace.

To learn more about how color management works inside the application, see the dedicated page.

New undock of 2D and 3D viewport

The 2D and 3D view can now be undocked to be moved elsewhere. For example by having the 3D view on a main screen while the 2D view sits on another screen.

Working with an undocked view is easier to organize the layout of the application and to keep a eye on things without loosing too much painting area.

  • Undock a view
    To undock a view, simply open the view menu and choose one of the two options. Each option opens a new window with the its view inside, while the other view remains docked inside the main interface.

  • Swap even with an undocked view
    While a view is undocked, the swap action from the view menu can be used to exchanged them.

  • Compatible with color management
    The undocked view has its own color management display transform, making it easier to manage in different monitors.

New support for SpaceMouse® by 3Dconnexion

The SpaceMouse® is a device by 3Dconnexion that allows to manipulate the 3D viewport camera in a more intuitive and friendly way. It is now supported natively and directly plug and play with Painter.

For more information, see the dedicated documentation page.

  • Available with version 7.4.2 and above.
  • Make sure to install the latest SpaceMouse® drivers to benefit from the Painter control scheme.

New content

A new set of assets has been added to the default content available with the application:

  • New decals, tool presets and filter (by Käy Vriend):
    • Decals
      • Scar Plain Straight
      • Pocket Patch Regular
    • Presets
      • Zipper Advanced Tape
      • Zipper Advanced Stop
      • Zipper Advanced Slider
      • Tightening Cord Lace
      • Tightening Cord Eyelet
      • Glitter Stars Golden
      • Glitter Party
      • Glitter Dots Pastel
    • Generator
      • Inflate Shrink/Wrap

  • New grunge bitmaps (by Emiel Sleegers):
    • Grunge Plaster Paint
    • Grunge Plaster Faded
    • Grunge Paint Peeled
    • Grunge Humidity
    • Grunge Fluff
    • Grunge Cobweb
    • Grunge Bush
    • Grunge Wood Soft
    • Grunge Paper Ripped
    • Grunge Cracked Deep
    • Grunge Brushed Dust

Improved automatic UV unwrapping

The automatic UV unwrapping has been updated with a new option that to improve the support of 3D models with extended surfaces.

This new setting named Avoid elongated UV islands take better advantage of the UV space by splitting UV islands that could be too long.

Below is an example of this new settings without using it vs using it:

Improved Python scripting

The Python API has a new method which allows to call the Javascript API.

This new method make it easier to migrate old plugins toward the new Python API. It also unlock some features such as Baking and Shader management that haven't been exposed in Python yet.

To run a Javascript command from Python, use the evaluate() function form the new js submodule. More information can be found inside the API documentation (available via the Help menu of the application).

Release Notes


(Released March 08, 2022)


  • [SpaceMouse][Windows] Support of the 3Dconnexion SpaceMouse in the 3D Viewport for navigation
  • [SpaceMouse][Windows] Basic shortcuts/keys for Pro and Enterprise SpaceMouse models in the 3D Viewport
  • [SpaceMouse][Windows] Dedicated rotation center icon in the 3D Viewport
  • [Color Management] Use roles from OCIO configuration to change default settings
  • [Color Management] Color manage the properties window for color widgets
  • [Color Management] Color manage the properties window for material preview
  • [Color Management] Color manage swatches in color picker
  • [Color Management] Add a setting to define the standard sRGB color space
  • [Color Management] Add the Standard sRGB color space from OCIO config in color picker Display selector list
  • [Color Management] Improvements for color space override menu
  • [Color Management] Allow to override the environment map color space in Display Settings
  • [Color Management] Draw color picker gradients based on current Display
  • [Color Management] Clamp HDR values by default in color editor
  • [Color Management] Use passthrough (no color space) for filters in Legacy mode
  • [Color Management] Limit gradients display in color editor to match [0-1] range
  • [Color Management] Hide Display selector in color picker in Legacy mode
  • [Color Management] Make color picker hexadecimal field always in sRGB color space
  • [Color Management] Disable color picker Display dropdown for data channels
  • [Optimization] Warp grid recomputes only covered UV tiles
  • [Export] Allow to export UV Tile projects for Sketchfab, USD and glTF
  • [Scripting][Python] Allow to change tonemapping function


  • [Sketchfab] Updating existing model ends up creating new model
  • [Sketchfab] Crash when searching for previously updated model
  • Crash when exporting to USD
  • Crash when creating a new shader instance in Geometry Mask or when geometry is hidden
  • [Import Asset Window] Crash when changing the type of imported resources
  • Normal mesh maps are inverted when used in layer stack
  • [Substance] User data blending mode is not taken into account
  • [Color Management] Bitmaps with color space in filename are imported as UV Tile sequences
  • [Color Management] Color managed outputs of Substance graph are in wrong color space
  • [Color Management] Polygon Fill tool displays the wrong color
  • [Color Management] ACES tonemapper is applied to channels in solo mode
  • [Color Management] Tool preview sphere lighting is not color managed
  • [Color management][Export] Converted maps applies an incorrect conversion
  • [Scripting][Python][Color Management] Projects created with template & OCIO environment variable are in Legacy mode
  • [Scripting][Python] Cannot use the JavaScript evaluate function on startup
  • [3D Adobe Offer] Can not launch Painter when using regional settings with languages not supported by default

Known Issues:

  • 3Dconnexion SpaceMouse not supported on MacOS
  • [UI] Horizontal scroll bar with color management appearing in some cases in new project window
  • [Bakers] "Average normals" setting has no effect in UV Tile projects
  • [Mac M1] Smart materials are not displayed correctly
  • [Color Management] Resources used in projection mode are not color managed in the overlay


(Released December 14, 2021)


  • [Color Management] Use data role in exported filenames
  • [Color Management] Expand the section Color Management, by default, when OCIO is selected in new project and project settings windows
  • [Color Management] Add ACES tonemapper in legacy mode
  • [Color Management] Adjust default configuration settings
  • [Color Management][Export] Fill $colorSpace in filenames for data channels
  • [Export] Export UV Tile project to Stager
  • [Interoperability] Not available for Steam and Substance editions
  • [Interoperability] Allow to send a UV Tile project to Stager


  • [MacOS][Crash] Painter does not start with Catalina
  • [Color Management][Crash] Random crash when playing with data type/color management on user channel
  • [Color management] Resources used as grayscale in mask display color space new menu
  • [Color Management] User channel is darker in the viewport in legacy mode + solo view
  • [Color Management] Env map is always linear when used in iRay
  • [Color Management] Color picker does not pick the right value for data channel in legacy mode
  • [Color management] Color picker is broken inside of a Substance in legacy mode
  • [Color management] Switching between solo channel views in the viewport does display with the right color space when using the dropdown menu
  • [Color Management] Export applies the wrong conversion on color managed user channels in legacy mode
  • Strokes made in solo view mask are not shown when switching back to material view
  • [Export] Converted maps are not exported as color managed channels
  • [Texture Set] Tooltip with original name is missing on renamed user channels
  • [Steam] Files missing when checking file integrity with Steam

Known Issues:

  • [Mac M1] Smart materials are not displayed correctly


(Released November 24, 2021)


  • [Color Management] Support of Color Management OpenColorIO version 2
  • [Color Management] Add color management settings to project settings
  • [Color Management] Warning window about Color Management configuration changes when opening a project
  • [Color Management] Display an error message if an invalid OCIO config file is selected
  • [Color Management] Allow to override configuration with OCIO environment variable
  • [Color Management] Multiple OCIO configurations integrated by default with the application
  • [Color Management] Extract color space name from imported bitmap filename
  • [Color Management] Allow to override the color space with one color space from the configuration in Properties window
  • [Color Management] Add color management options in Texture Set Settings
  • [Color Management][Viewport] Allow to color manage 2D and 3D views separately
  • [Color Management] Load and convert environment map to the working color space
  • [Color Management] Adjust color picker and editor with current color space
  • [Color Management] Allow to select the display transform color space in the viewport with a new dropdown menu
  • [Color Management] Apply display transform with Iray rendering results
  • [Color Management] Export textures with different color spaces
  • [Color Management][Python] Apply color management settings from Environment variable (OCIO) to new projects
  • [Viewport] Allow to undock the 2D or 3D viewport
  • [Auto Unwrap] New option to avoid elongated islands
  • [Scripting Python] Call JavaScript functions from Python API
  • [New Project Window] Make the imported maps section collapsible
  • [Projection][Warp] Allow to hide normals as an option in the Warp settings
  • [Content] 11 new grunge maps
  • [Content] 8 new tool presets (zipper, tightening cord, glitter)
  • [Content] 8 new materials (scar, pocket, ...)
  • [Content] 1 new generator (inflate shrinkwarp)

Known Issues:

  • [Mac M1] Smart materials are not displayed correctly
  • [Color Management][Crash] Random crash when playing with data type/color management on user channel
  • [Color Management] Color picker does not pick the right value for data channel in legacy mode
  • [Color management][Iray] Saving the render in EXR or TIFF while Color Management is activated in the viewport will always save in linear
  • [Color management] Resources used as grayscale in mask display the wrong Color Space menu
  • [Color Management][Iray] Env map is always linear when used in Iray
  • [Color Management][Export] Converted maps are not exported as a color managed channels
  • [Color Management][Export] Export ignores if user channel is color managed or not with legacy mode