User Guide Cancel

Version 10.1 | Substance 3D Painter

  1. Substance 3D home
  2. Home
  3. Getting Started
    1. Getting Started overview
    2. Activation and licenses
    3. System requirements
    4. Project creation
    5. Export
      1. Export overview
      2. Export window
        1. Export window overview
        2. Export settings
        3. Output templates
        4. List of exports
      3. Export presets
        1. Export presets overview
        2. Predefined presets
          1. Predefined Presets
          2. USD PBR Metal Roughness Preset
          3. Default Presets
        3. Creating export presets
    6. Glossary
    7. Performance
  4. Interface
    1. Assets
      1. Assets overview
      2. Navigation
      3. Customizing the layout
      4. Filter by path
      5. Saved searches
      6. Advanced search queries
      7. Adding a new library
      8. Sub-library tab
    2. Substance 3D Assets
    3. Color picker
    4. Display settings
      1. Display settings overview
      2. Environment settings
      3. Camera settings
      4. Viewport settings
    5. History
    6. Layer stack
      1. Layer stack overview
      2. Creating layers
      3. Managing layers
      4. Masking and effects
      5. Blending modes
      6. Layer instancing
      7. Geometry mask
    7. Main menu
      1. Main menu overview
      2. File menu
      3. Edit menu
      4. Mode menu
      5. Window menu
      6. Viewport menu
      7. Plugins menu
      8. Help menu
    8. Project configuration
    9. Properties
    10. Settings
      1. Settings overview
      2. General preferences
      3. Shortcuts
      4. Libraries configuration
    11. Shader settings
      1. Shader settings overview
      2. Updating a shader
    12. Texture Set
      1. Texture Set overview
      2. Texture Set list
      3. Texture Set settings
      4. Texture Set reassignment
    13. Toolbars
    14. Viewport
      1. Viewport overview
      2. 2D view
      3. 3D view
      4. Camera management
    15. Miscellaneous
      1. Sliders
      2. Log
      3. Update checker
  5. Painting
    1. Painting overview
    2. Tool list
      1. Paint brush
      2. Eraser
      3. Projection
      4. Polygon fill
      5. Smudge tool
      6. Clone Tool
      7. Quick mask
      8. Path tool
    3. Straight line   
    4. Lazy mouse 
    5. Symmetry
      1. Symmetry overview
      2. Mirror Symmetry
    6. Fill projections
      1. Fill projections overview
      2. Fill (match per UV Tile)
      3. UV projection
      4. Tri-planar projection
      5. Planar projection
      6. Spherical projection
      7. Cylindrical projection
      8. Warp projection
      9. UV set to UV set projection
    7. Presets
      1. Presets overview
      2. Creating and saving presets
      3. Creating particles presets
        1. Creating particles overview
        2. Installing the particle editor
        3. Overview of the particle editor
        4. Creating a new particle script
      4. Photoshop brush presets (ABR)
        1. Photoshop brush presets overview
        2. Exporting Brush Presets from Photoshop
        3. Importing Photoshop Brush Presets
        4. Photoshop Brush Parameters Compatibility
    8. Dynamic strokes
      1. Dynamic strokes overview
      2. Enabling Dynamic Stroke feature
      3. Dynamic Stroke Performances
      4. Creating custom Dynamic Strokes
    9. Advanced channel painting
      1. Channel painting overview
      2. Ambient Occlusion
      3. Flow Map
      4. Height Map
      5. Normal Map
    10. Vector graphic (.svg & .ai)
    11. Text resource
  6. Effects
    1. Effects overview
    2. Generator
    3. Paint
    4. Fill
    5. Levels
    6. Compare Mask
    7. Filter
    8. Anchor Point
  7. Baking
    1. Baking overview
    2. How to bake mesh maps
    3. Baking visualization settings
  8. Content
    1. Creating custom effects
      1. Creating custom effects overview
      2. Generic filter
      3. Channel specific filter
      4. Generators
      5. Mesh map
      6. Mesh based input
      7. User data
    2. Importing assets
      1. Adding resources via drag and drop
      2. Adding resources via the import window
      3. Adding content on the hard drive
      4. Receiving assets from other Substance 3D applications
  9. Features
    1. Automatic UV Unwrapping
    2. Physical size
    3. Smart Materials and Masks
    4. Subsurface Scattering
      1. Subsurface Scattering overview
      2. Enabling Subsurface in a Project
      3. Subsurface Parameters
      4. Subsurface Material Type
    5. Dynamic Material Layering
    6. UV Reprojection
    7. UV Tiles
      1. UV Tiles overview
      2. Image Sequence
    8. Color Management
      1. Color management overview
      2. Color management with Adobe ACE - ICC
      3. Color management with OpenColorIO
    9. Post Processing
      1. Post Processing overview
      2. Color correction
      3. Depth of Field
      4. Glare
      5. Lens Distortion
      6. Tone Mapping
      7. Vignette
      8. Color Profile
    10. Iray Renderer
      1. Iray Renderer overview
      2. Iray Settings
      3. Viewer and MDL Settings
    11. Plugins
      1. Plugins overview
      2. Autosave
      3. Resources Updater
    12. Sparse Virtual Textures
    13. Custom Shaders
    14. SpaceMouse® by 3Dconnexion
    15. Universal Scene Description (USD)
    16. Send to
  10. Technical Support
    1. Performance Guidelines
      1. Performances guidelines overview
      2. Conflicts and background applications
      3. Mesh and UV setup
      4. GPU Drivers
      5. NVIDIA Drivers Settings
      6. GPU VRAM amount and bandwidth
      7. GPU VRAM and other applications
      8. Texture Sets amount
      9. Layer management
      10. Channels management
      11. Substance filters and materials
      12. Viewport display
    2. Configuring Pens and Tablets
    3. Exporting the log file
    4. Exporting a DXDiag
    5. Technical issues
      1. GPU Issues
        1. Crash when working with overclocked GPU
        2. Forcing the external GPU on Mac OS
        3. GPU drivers compatibility
        4. GPU drivers crash with long computations (TDR crash)
        5. GPU has outdated drivers
        6. GPU is not recognized
        7. GPU is not recognized and is mentionned as GDI Generic
        8. Issues with Nvidia GPUs on recent Mac OS versions
        9. Multi/Bi-GPU
        10. Running on integrated GPU
        11. Painter doesn't start on the right GPU
      2. Startup Issues
        1. Application failed to start because of Qt
        2. Crash or freeze during startup
        3. Software conflicts
      3. Rendering Issues
        1. Artifacts and glitches on Mac OS with Custom GPUs
        2. Blocky artifacts appear on textures in the viewport
        3. Mesh appears pink in the viewport
        4. Mesh flash to white when moving camera
        5. Some HDPI scaling values are not working
      4. Stability Issues
        1. Crash during export
        2. Crash when opening or saving a file
        3. Crash while baking
        4. Crash with low virtual memory
        5. Windows Blue Screens
      5. Miscellaneous Issues
        1. Corrupted texture error message
        2. Shelf resources are gone after 7.2 update
        3. Error there is no disk in the drive
        4. Error with missing api-ms-crt dll
        5. Impossible to drag and drop files into the shelf
        6. Impossible to use the ALT keyboard shortcut on Linux
        7. Assets (or shelf) previews are empty
    6. Workflow Issues
      1. Export Issues
        1. My exported opacity map is totally black
        2. Texture dilation or Padding
      2. Tools Issues
        1. Normal map looks incorrect when loaded in layer or tool properties
        2. Paint Tool bleeds on other UV islands
      3. Project Issues
        1. A project has been processed as a text file and is now corrupted
        2. Loading files from a network
        3. Preserve brush strokes setting stays disabled
        4. Projects are really big
      4. Library Issues
        1. Thumbnails in the shelf look incorrect
        2. Error when importing a Font
      5. Viewport Issues
        1. Mesh faces disappear when looking at them from behind
        2. Viewports and textures are blurry or lack sharpness
      6. Plugins Issues
        1. Substance Source plugin doesn't load
      7. License Issues
        1. Maintenance is expired dialog on startup
  11. Pipeline and integration
    1. Installation and preferences
      1. Preferences and application data location
      2. Automated installation
      3. Retrieving the installation path
    2. Configuration
      1. Command lines
      2. Environment variables
      3. Firewall Configuration
      4. Querying Current Software Version
      5. Remote Desktop
    3. Resource management
      1. Shelf and Assets location
      2. Resource paths
        1. Adding resource paths by editing preferences manually
        2. Editing resource paths manually
        3. Editing the Shelf Preferences with Python
      3. Adding saved searches manually
      4. Preferences and content migration
      5. Excluding resources in a resource path
  12. Scripting and development
    1. Scripts and plugins
      1. Creating a Javascript plugin
      2. Remote control with scripting
    2. Shader API Reference
      1. Shader API overview
      2. Changelog - Shader API
      3. Libraries - Shader API
        1. Lib Alpha - Shader API
        2. Lib Bayer - Shader API
        3. Lib Defines - Shader API
        4. Lib Emissive - Shader API
        5. Lib Env - Shader API
        6. Lib Normal - Shader API
        7. Lib PBR - Shader API
        8. Lib PBR Aniso - Shader API
        9. Lib Pom - Shader API
        10. Lib Random - Shader API
        11. Lib Sampler - Shader API
        12. Lib Sparse - Shader API
        13. Lib SSS - Shader API
        14. Lib Utils - Shader API
        15. Lib Vectors - Shader API
      4. Parameters - Shader API
        1. All Custom Params - Shader API
        2. All Engine Params - Shader API
        3. All Rendering States Params - Shader API
        4. Layering Bind Materials - Shader API
        5. Layering Declare Stacks - Shader API
      5. Shaders - Shader API
        1. PBR Material Layering - Shader API
        2. PBR Metal Rough - Shader API
        3. Pixelated - Shader API
        4. Surface Shader - Shader API
        5. Toon - Shader API
  13. Release notes
    1. Release notes overview
    2. All Changes
    3. Version 10.1
    4. Version 10.0
    5. Version 9.1
    6. Old versions
      1. Version 9.0
      2. Version 8.3
      3. Version 8.2
      4. Version 8.1
      5. Version 7.4
      6. Version 7.3
      7. Version 7.2
      8. Version 2021.1 (7.1.0)
      9. Version 2020.2 (6.2.0)
      10. Version 2020.1 (6.1.0)
      11. Version 2019.3
      12. Version 2019.2
      13. Version 2019.1
      14. Version 2018.3
      15. Version 2018.2
      16. Version 2018.1
      17. Version 2017.4
      18. Version 2017.3
      19. Version 2017.2
      20. Version 2017.1
      21. Version 2.6
      22. Version 2.5
      23. Version 2.4
      24. Version 2.3
      25. Version 2.2

Version 10.1

Substance 3D Painter 10.1 adds new powerful filters, improved USD functionalities and updated VFX Platform and Linux support.

Release date: 17 September 2024

Note:

This version of Painter now uses Qt version 6 which affects the support of Python and JavaScript plugins. See below for more details.

Major features

New default filters

In this release several new filters have been added to greatly expand the texturing process:

  • New embroidery decal material
    Inside the materials section of the Assets window you can find a new Embroidery decal materials. Drag and drop it anywhere over you mesh, plug in any resource (like a texture or even a font) and you will be able to easily create new fabric details.

  • New fill area color/mask filter
    These two new filters allow to fill any closed paths or outlines. This is useful to quickly fill 3D paths for example. Because they are filters they can also be used for manual brush strokes or in other situations.

  • New FXAA filter
    This new filter can quickly reduce the aliasing, especially on hard edges that can appear after a level for example or on masks made with the color selection effect.

  • New highpass filter
    With this generic filter you can generate a grayscale texture to use it for more advanced effects (like softening, blurring or sharpening details).

  • New pixelate filter
    The pixelate filter can simulate a reduction in resolution which can be useful to stylize colors and patterns.

  • New posterize filter
    This filter can be useful to reduce the number of colors in an image which can help create contrasts in shapes and build stylized effects.

  • New threshold filter
    The threshold filter is a quick way to create sharp binary black and white masks from a grayscale input.

  • New smoothstep filter
    The smoothstep filter is another way of doing a level or contrast to refine grayscale information. This filter also applies an exponential curve to the result, making it possible to convert linear gradients into smooth curves.

  • Improved Transform and Mirror filters
    The transform filter has been updated to support non-uniform scaling, flipping horizontally or vertically, and simpler to use parameters. The mirror filter has also been refreshed with more straightforward parameters.

  • Improved icons
    To make standard filters more visible and easier to find, their icons have been remade. Icons tinted yellow are meant to be used on the content of a layer, while grayscale icons are generic and can be used both in layers content and mask.

  • Minor fixes on filters
    A few other filters has been adjusted to fix some issues:

    • The height adjust filter was affecting the alpha of a layer, making it difficult to use in some cases.
    • The blur filter wasn't using a linear color space in Legacy color management mode, creating incorrect colors when blending/mixing its input.

USD and VFX Platform support update

In this version of Painter many third party components have been improved and updated:

  • Export textures with Adobe Standard Material in USD
    When exporting textures from Painter into an USD file, you will now get the Adobe Standard Material properties with them. This make these USD files ready to be used into application that support those properties as well.

  • Import textures from USD files
    Importing an USD file will now also import its texture in the project it creates, making back and forth between applications easier. If the USD file uses the Adobe Standard Material this will also configure the shader settings, making the result in the viewport match the other source application.

  • Gltf changes
    Following the USD update, some change of behavior for the GLTF format were required to ensure parity. When importing a gltf file Painter will now presume that the normal map will be in OpenGL format.
    Some gltf files may use the DirectX format instead. Therefore a new setting has been added in the new project window to take it into account (note that the normal format can also be overriden from the layer stack).

  • Updated dependencies
    Several libraries used by Painter have been updated, notably to match the VFX platform reference. Here are the new versions used in Painter 10.1:

    • Qt 6.5.6 (and PySide6 6.5.6)
    • Substance Engine 9.1.3
    • OpenEXR 3.2
    • Python 3.11
    • OCIO 2.3.2
    • OpenSubdiv 3.6.0
  • Updated Linux support
    This new version of Painter now supports Red Hat Enterprise Linux (RHEL) version 8.6 as the minimum, but should also be compatible with version 9.x.

Improved performance

A few areas of the application have received some performance improvements:

  • Improved opening time of projects
    Project that used a lot of brush strokes should now be faster to open in Painter. The saving time of these project should also be slightly improved.
    In some of our test projects we observed a reduction from 50s to only 6s of loading time when opening a project. Memory consumption when opening old projects and converting them to the latest version has also been improved.

  • Improved tesselation performance
    We now employ an automatic optimization when tesselation is enabled in the Shader settings. Triangle that are smaller than a pixel on screen will not be tesselated anymore, leading to less triangles to drawn and therefor faster rendering times.
    This change doesn't produce visual differences and doesn't affect the mesh export process.

  • Simplified thumbnails are now the default
    In version 6.2 we introduced the simplified thumbnails for UV Tiles projects to improve performance, but regular projects could still use the old way of computing layers thumbnails. This behavior was controlled via an application setting.
    This setting now defaults to the optimized thumbnails by default to help performance on any projects. It can be reverted in the main preferences if desired.

Painter 10.1 migration notes

Note:
  • Python plugins may need to be updated following the update to Qt6. See this page for more details.
  • JavaScript plugins have now been moved into a subfolder inside the User Documents directory. Existing plugins will not appear anymore in the application as they need to be moved manually into that folder.
  • On Steam/Ubuntu, a system library is required to make Painter work properly. Make sure that the libxcb-cursor is installed before launching the application.

Release Notes

10.1.0

Release date: 2024/09/17

Summary: Major release, new content: Fill area mask/color filter, embroidery decal filter and six generic Substance filters, import USD with material and shader properties, performance improvement, VFX platform 2024 compliant and migration to Linux RedHat

Added:

  • [Content] Add new Fill area mask/color filter
  • [Content] Add new Embroidery decal filter
  • [Content] Add 6 new generic Substance filters (FXAA, pixelate, highpass, posterize, smoothstep, threshold)
  • [USD] Export USD layer with a defined ASM material
  • [USD] Import USD with material and shader properties
  • [Performance] Enable optimized layer stack thumbnails by default
  • [Performance] Reduce project file opening time and memory consumption (data decoding)
  • VFX platform 2024 compliant
  • [VFX Platform 2024] Update to Python 3.11
  • [VFX Platform 2024] Update to OpenEXR 3.2
  • [VFX Platform 2024] [USD] Update OpenSubdiv 3.6.0
  • [VFX Platform 2024][Color Management] Update to OCIO 2.3.2
  • [Linux] Migration to Linux RedHat
  • [Linux] Update Nvidia driver min version to 535.171.04
  • [Import] Add an option to flip normal map when importing a GLTF mesh
  • [UI] Use operating system default value for drag event detection distance
  • [Substance Engine] Add call strip function to remove the symbols from the executable
  • [Splash screen] Update to new splash screen format
  • Update Substance Engine to version 9.1.3
  • [Python] Show link to examples in the layer stack documentation menu
  • [JavaScript] Move Javascript plugins into javascript/plugins subfolder

Fixed:

  • [Illustrator] Crash exporting a UV Tile with .ai graphic in specific cases
  • [Dynamic Strokes][Path] Random per stroke does not work on a path
  • [UI][Properties] Lock is enabled when tiling is non-uniform
  • ​Debug TXT file is created when double clicking on Painter project
  • [USD][Export] Some textures may be missing
  • [ASM] Scattering Color channel ignores metallic
  • [Content] Blur filter doesn't work in "working" color space
  • [Content] Height Adjust filter also modifies the alpha of the layer

Known Issues:

  • [Color Management] HDR color space conversions with ACE on Linux produce clamped colors
  • [Win][Crash] [ACE] Not using sRGB ICE color space for display transform
  • [Regression][UI] Right-click Menu is too small on HD screens
  • [Crash][Python] USD export triggered by TextureStateEvent
  • [MacOS Intel] Crash when importing some presets
  • [Crash] Relocate resource and save project
  • [Engine] Painting with Clone tool in normal channel shift colors incorrectly
  • [Python] Ghost widget appears deleted by script still functioning
  • [RedHat] Color picker issues

Get help faster and easier

New user?