User Guide Cancel

Version 10.0 | 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.0

Substance 3D Painter 10.0 brings support of Illustrator (.ai) files, integrates Substance 3D Assets, imports Fonts via the Text resources, adds layer stack functionalities in the Python API, and several quality of life improvements.

Release date: 16 May 2024

Major features

New text resource

This new version introduces the Text resource which is a way to load font files to write text in different contexts (brush, fill projection, Substance image inputs, etc.) to embellish your textures.

  • Browse your fonts in the Assets window
    Fonts are now listed in the Assets window under their own filter. They are gathered from different locations on the operating system (and also from the Libraries).

  • Drag and drop fonts like any other resources
    Fonts can be used as text resources like any other kind of resource. Drag and drop them to automatically create fill projection. They can also be used in brushes or as input in Substance filters.

  • Text resource parameters
    When creating a text resource, you can tweak a few parameters to adjust the look of your text: vertical and horizontal alignment, automatic or manual size, line and character spacing, color, etc.

  • Wide range of characters and feature supported
    The Text resource supports right to left writing as well as ligatures. (To be able to write non latin characters a compatible font is required.)

  • Import custom fonts like regular resource
    You can import your own fonts files directly into your Library or project like any other resources. Some types of fonts are not supported however, for more information see this documentation page.

Note:

For more information about the Text resource, see the dedicated documentation page.

New import of Illustrator files (.Ai)

Following the support for .svg files, this new version also adds the ability to import Illustrator files (.ai).

  • Illustrator (.Ai) file support
    In this new version .ai files can now be imported and rendered in Painter to be used as resource in brushes, fill projections or as Substance image inputs.

  • .svg and .ai files share common settings
    SVG and Illustrator documents share similar settings, notably the resolution, crop area and scope selection parameters. This means that vectorial resource can be managed in a similar way.

  • Artboard selection
    Illustrator documents support artboard, when using an .ai file you can also choose between different artboards available via the dedicated setting.

  • Improved scope selection
    The scope selection window has been improved with the support of thumbnails, making it easier to browse and select only specific elements.
    For performance reasons thumbnails are off by default and can be enabled with the Show thumbnails checkbox.

Note:

Importing Illustrator (.ai) files is currently only supported on Windows and MacOS.

New Substance 3D Assets integration

A new window is available which embeds the Substance 3D Assets website directly inside Painter. This integration makes it easier to browse and download resources directly in your own library.

  • New Substance 3D Assets window
    A new dock is available in the interface to browse Substance 3D Assets. If the dock is not visible and closed it can be found again in the dock toolbar on the right of the interface.

  • Download manager
    You can see the assets currently being downloaded via the dedicated manager using the bottom left button of the window. Assets that may fail to download can be started again from this list.

  • Find your downloaded assets easily
    The button in the bottom right of the window opens a menu with a few actions to help navigate the website but also to shows were assets have been donwloaded.

Note:

Upon the first launch a login into your account will be necessary to download assets. This login is then be cached for future uses.  

Note:

The Substance 3D Assets dock is not available in the Steam version.

New layer stack module in Python API

This release sees the addition of the new layer stack module in our Python API. This API allows to control the layer stack of a project, opening the door to the creation of advanced layer stack plugins and custom tools.

  • New Layer stack API
    The new layerstack module allows to control the layer stack of a project in many ways. You can:

    • Query and set the selection of layers and effects.
    • Create new layers, folders and effects (including filters, anchor points, etc.).
    • Instantiate layers.
    • Get and set parameters of layers and effects, load resources into them.
    • Get and set Substance parameters.
  • Scoped modifications and pause of the engine
    Manipulating the layer stack could lead to long computations, this is why we also exposed the possibility to pause and unpause the engine from the API (like in the UI). We also made it possible to group modifications together, for both performance reasons but also to undo a single time multiple operations.

  • Basic color management
    With the exposition of the layer stack we needed to introduce the notion of color management in our API. A new colormanagement module has been added to create, tweak colors and choose the color space of bitmaps. (This part of the API isn't complete yet and will be expanded in future versions.)

  • Query export preset information
    Export presets are now exposed in our API, allowing to query the list of presets (both predefined and custom). Their content can also be retrieved in a similar format to our existing export textures API.

  • New possibilities ahead!
    This new part of the API allows to do a lot of new things, like saving and restoring a selection of layers or changing the random seed of all the resources in a project for example:

Note:

For more information on the API, see the documentation included with the application (via Help > Scripting documentation > Python API) which includes many code snippets to easily get started.

Note:

Examples of layer stack plugins can also be found in our online documentation.

Improved normal map painting

In this release we reworked the normal map painting workflow. We notably changed the way we accumulate and blend normal brush stamps. This changes were made to address issues related to painting flow maps.

  • Fixed accumulation issue
    Painting over and over an area in the normal channel will no longer saturate or clamp and create holes or artifacts. Switching the normal channel to RGB32F is also no longer needed.

  • Fixed undo breaking painted strokes
    Undoing a brush stroke no longer breaks other already painted strokes.

  • Transparency on zero alpha
    Brush stamps made with a texture with an alpha at zero will now draw as transparent. The example below shows a brush stamp (left) versus a planar projection (right).

Note:

For more information on painting flow map, see the documentation page.

Improved transform manipulators

Several improvements have been made to enhance the usage of the transform manipulators.

  • Precision mode with CTRL
    Pressing control while dragging on a manipulator will now enter into a new precision mode which allows more meticulous operations. This change applies to the translate, rotate and scale manipulators.
    Here is an example before and after pressing CTRL while dragging:

  • New scale behavior
    The scale intensity is now based on the current scale value itself and not on the scene size anymore. This makes relative changes easier to do, especially at small values. Combined with the precise mode it makes scaling a lot more pleasant.
    Another change is scaling down until 0 will no longer go into negative values. This avoid the issue of wanting to scale down a projection and flipping it by accident.

  • Improved surface manipulator rotation
    The surface decal manipulator is now a lot more stable when dragging around a surface. It doesn't increase its rotation when just doing back and forth translations.
    Here is the old behavior compared to the new one:

  • Camera aligned projection on drag and drop
    Drag and dropping a resource into the viewport allows to create a warp projection directly on the surface of the mesh. This projection was previously incorrectly rotated, it is now aligned to the camera.

A few other improvements have been added, notably:

  • Updated Tile Generator
    The Tile Generator blending mode parameter can now be changed and will modify the result as expected. The resource has also been updated to the latest version available in Substance 3D Designer.

  • Fixed banding/quality issues on some filters
    Several filters were stuck on 8 bit precision instead of 16 bit, leading to banding/artifacts when using them (like the histogram scan or directional blur). This is now fixed.

  • Color space in SBSAR output
    When the Legacy or OCIO color management workflow is enabled, the SBSAR export will now reference the color space names used in the project on the respective outputs.

  • Faster resource discovery
    With the introduction of the Text resource we added a new cache to make crawling of resources on the disk faster on next startup. This is quite notable when resources are installed on a HDD or when a library has gigabytes of resources. This new cache can be disabled with a command line, see the dedicated documentation page for more information.

Many thanks to the website is this arabic ? which was of great help during the development of this version.

Reference to artworks used in the medias above:

Tutorials

Release notes

10.0.0

Release date: 2024/05/16
Summary: Major release, edition of the layer stack with Python API, read native Illustrator files, integration of 3D Assets and new text resource

Added:

  • [Illustrator] Use Illustrator files with art boards in Painter
  • [Illustrator][SVG] Add previews in scope selection
  • [Substance 3D Assets] Browse, select and download 3D Assets directly in Painter
  • [Substance 3D Assets][UI] New panel
  • [Substance 3D Assets] Support environment maps and materials
  • [Substance 3D Assets] Allow to reload and navigate and open location folder in new Substance 3D Assets panel
  • [Substance 3D Assets] Addition of a download manager
  • [Text Resource] Allow to use embeddable fonts
  • [Text Resource] Allow to render a font/text on a mesh
  • [Text Resource] Display fonts from user and other shared paths in Assets panel with a new category
  • [Text Resource][Properties] Add support for advanced font properties
  • [Text Resource] Allow to search/view fonts in mini-shelves
  • [Text Resource] Add error message/dialog when importing an incompatible font
  • Miscellaneous
  • [Fill projection] Improve Scale manipulator behavior when using small values
  • [Manipulators] Add new precise mode when pressing CTRL shortcut
  • [Manipulators] Improve surface manipulator stability when translating
  • [Export] Add colorspace name in SBSAR outputs
  • [Performance] Improve library discovery time of assets on disk
  • [Substance] Update to Substance engine version 9.1.2
  • [Drag and Drop] Align decal rotation to camera when dropping in viewport
  • [Python] Edition of the layer stack
  • [Python] Allow to select layer, effect, mask, geo mask in UI
  • [Python] Allow to get/set layer blending modes
  • [Python] Allow to get/set fill layer projection settings
  • [Python] Allow to query Substance material color from a fill layer
  • [Python] Allow to query and set uniform colors and resources in layers and effects
  • [Python] Allow to create and edit text resources in layer stack
  • [Python] Allow to edit active channels on layers and effects
  • [Python] Allow to batch actions to have a single undo/redo
  • [Python] Allow to load/edit vectorial source parameters
  • [Python] Allow to edit layer and effects color properties with color management
  • [Python] Allow to query and create instanced layers
  • [Python] Allow to add color selection effect
  • [Python] Allow to control bitmap image color management
  • [Python] Allow to pause/unpause engine
  • [Python] Allow to navigate to siblings and parent nodes
  • [Python] Allow to create filter/generator effect
  • [Python] Allow to add level effect
  • [Python] Allow to add smart mask on a layer
  • [Python] Allow to create/edit anchor points
  • [Python] Allow to get/Set mask on layers
  • [Python] Allow to create compare mask effect
  • [Python] Allow to query and use presets from Substance resources
  • [Python] Allow to list presets and their values via internal_properties function for Substance resources
  • [Python] Allow to list predefined export presets
  • [Python] Allow to list export presets available in the library
  • [Python] Allow to retrieve the content of export presets

Fixed:

  • [Crash] Undoing "Remove shader instance" with Ctrl-Z
  • [Crash] Create a layer on empty stack if last selection was an effect
  • [SVG] Issue with custom cropped area value
  • [Auto-Unwrap] Recomputing only the packing without any change to UV orientation results in crash
  • [Drag and drop] Lag due to external resources are preloaded multiple times
  • [UI] Drag and drop resource thumbnail can hide warning message in layer stack
  • [Performance] Masked UV tiles are still computed
  • [USD] Wrong highlight for scope selection
  • [Resource] Bitmap image gets corrupted after painting in normal channel and saving project
  • [USD] Support left-handed vertex mesh ordering
  • [Substance] Reset to default always go back to zero for angle widget
  • [Engine] Painting with an SVG in a stencil doesn't work
  • [Engine] Normal map brush strokes break after an undo
  • [Content] Graphic to Material filter has incorrect alpha blending and color space
  • [Content] Blending modes on Tile Generator are not working
  • [Content] Histogram scan filter produces banding in some cases
  • [Content] Baked lighting stylized does not take painted height into account
  • [Python] Unexpected error when retrieving instanced layer information after shader change

Known Issues:

  • [Color Management] HDR color space conversions with ACE on Linux produce clamped colors
  • [Crash][Linux][AMD] Dragging and dropping resources in layer stack on Wayland OS
  • [Regression][UI] Right Click Menu is too small on HD screens
  • [Crash][Python] USD export triggered by TextureStateEvent
  • [Save] Spp project file is lost when "save as" fails
  • [MacOS Intel] Crash when importing some presets
  • [Illustrator] Cannot import Ai files after server crash without restarting Painter
  • [Import] Assets with same name but different extensions are overridden

Get help faster and easier

New user?