User Guide Cancel

Version 8.3 | 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 8.3

Substance 3D Painter 8.3 introduces a brand new baking mode, USD files import and support for physical size in UV projection mode.

Release date: 10 January 2023

Major feature

New baking mode

The old baking window has been replaced by a dedicated mode with several new features, notably with viewport visualization such as the display of the cage and matching errors.

  • Accessing and switching between modes
    Baking is now a new and separate mode in addition to the already existing painting and rendering modes of the application. To get to the baking mode, simply use the little croissant icon in the contextual toolbar. Switching between modes can also be done otherwise: by using the mode menu or the keyboard shortcuts. To get back to another mode, simply use the dedicated icon of the mode (Additionally, the Bake Mesh maps button inside the Texture Set settings can still be used to get into the new mode).

  • New mode interface
    The traditional baking window has been transformed into a mode with dedicated docks, notably:

    • Texture Set list can be used to define which parts of the project will be baked.
    • Mesh Map Bakers allows to select between the common baking settings and the baker settings. It is also where you can specify which baker process will be launched.
    • Mesh Map Settings is where all the baker and common settings are located and can be modified, depending on the selection from the two previous window.
    • Baking Log regroups different information about the baking process, notably error messages.
    • Baking visualization: this panel sits in the viewport and controls several options related to the display of the low and high poly meshes.

  • Start and cancel the baking process directly from the viewport
    The button to launch or cancel the baking process now sits at the bottom of the viewport. A little arrow can also be used to specify the baking mode: based on the Texture Set list selection or by using the currently active Texture Set.

  • Display high-poly mesh in viewport
    When specifying a high-poly mesh in the baking settings, it will now be loaded in the viewport as well (unless the dedicated visualization setting is disabled). This allows to check whether the low and high poly mesh geometry match well.

  • Display cage mesh in viewport with missed areas as error
    The cage mesh can also be displayed in the viewport. When not using a dedicated mesh file, an implicit cage will be displayed instead and it will react to the Max Frontal Distance parameter. When adjusting the cage size, any part of the high-poly mesh that is outside the cage will be shown as red by default, allowing to easily find part of the mesh that will be missed by the baking process.

  • Look around mesh while loading and baking
    Loading meshes and baking no longer freezes the application, meaning it is possible to interact with the viewport during those operations. This can be useful to investigate the baking in progress, identify issues early and cancel the bake, helping save time in the end. Similarily, the most visible Texture Set in the viewport will now be baked first which will help check out results on specific areas in advance.

  • Neutral material and viewport settings
    To help focus on the baking results and look for issues if any arise, the baking mode doesn't display painted textures, instead using a neutral material. This neutral material's settings can be adjusted in the Baking visualization panel inside the viewport.

  • Display hard edges with missing UV seams
    One source of artifacts when baking is the presence of hard edges that don't have UV seams. This can lead to visible lines and break the smoothness of shading. For this purpose, a visualization settings has been added to highlight them both in the 3D and 2D view as they are very easy to miss otherwise.

  • Synchronize and unsynchronize parameters
    The new sync action allows to specify which part of the Baking settings are synchronized across Texture Sets. Otherwise it would be tedious to configure settings multiple times in identical ways. Sometimes it is useful to have Texture Sets with dedicated settings and keeping them unsynchronized is preferred. For example, keeping the Common settings separated now allows to use a Max Frontal Distance, Resolution and/or list of high-poly meshes which would be different per Texture Set.

  • Matching by name checker
    The Matching by name tab in the Baking Log can help find errors in the matching process before baking, making it easier to notice meshes that won't match. Meshes that match are grouped together while other will be isolated and displayed in red.

Note:
There are many more new settings in this new mode. To learn more about see the dedicated documentation page.

New import and export of USD files

This new version adds the support of the Universal Scene Description (USD) file format. It is now possible to start a Painter project, exporting meshes and textures using a USD format, which makes for a more consistent workflow across applications.

  • Import USD file with variants, skinning and at a specific frame
    A USD file format can be used when creating a project or re-importing a mesh inside a project. USD files can often be complex scenes, therefore a scope and variant selector is also available to only import a subset of the file.

  • Export USD as a new file or linked to the original USD used in the project
    When your texturing is ready, you can use the File > Export textures window to export your USD file alongside your texture files. Simply enable the setting Export USD asset to do so. This will generate several USD files that can be easily integrated into a pipeline afterward. If you used a non-USD file or a USD-file without UVs, this will export a new USD geometry file in addition to texture maps and USD material file.
    Additionally, it is also possible to use the File > Export mesh to export the project geometry as a USD file.

Improved support of physical size in UV mode

Support of Substance materials with embedded physical sizes has been extended to UV based projections.

  • Physical size in UV mode
    It is now possible to set the Scale mode to Physical size instead of Tiling in fill layer and fill effects using UV projection mode. The size of the UV is computed automatically based on the average size of the triangles from the UV unwrapping.

  • Automatically switch to physical size
    A new project setting has been added to automatically set the scale setting to physical size when creating a material (when drag and dropping a resource for the Asset window, for example). This allows to use consistent sizing across a project without having to switch settings manually every time a new Fill layer is created. To enable it in an existing project, go to Edit > Project configuration and enable Switch fill layer scaling to Physical size when assigning materials. This setting can also be enabled when creating a new project.

Platform support information

With this release we raised the minimum supported version of Painter on Steam to Ubuntu 20.04.

Tutorials

To discover and learn about the new Baking mode, check out our latest tutorial:

Release Notes

(Released: January 10, 2023)
Summary: Major release with new baking mode, new import and export of USD files, and physical size support for UV projection

Added:

  • [Baking Mode] New baking mode dedicated to baking process
  • [Baking Mode] Set shortcut to switch to baking mode to F8
  • [Baking Mode] Add Start and Cancel baking button in the viewport
  • [Baking Mode] Add baking selection in Texture Set list
  • [Baking Mode] Add new Mesh Map Bakers window to select bakers
  • [Baking Mode] Add new Mesh Map Settings window to edit baking settings
  • [Baking Mode] Add new Baking Log window to follow baking process
  • [Baking Mode] Add baking parameters and undo actions to history window
  • [Baking Mode] Add breadcrumbs in Mesh Map Settings
  • [Baking Mode] Add mesh maps thumbnails in the Mesh Map Bakers window
  • [Baking Mode] Add visualization settings collapsible menu in 3D viewport
  • [Baking Mode] Add visualization setting to show/hide the high-poly mesh
  • [Baking Mode] Add visualization setting to show/hide the cage mesh and wireframe
  • [Baking Mode] Add visualization setting to show/hide the low-poly mesh
  • [Baking Mode] Add visualization setting to show hard edges without UV seams as errors
  • [Baking Mode] Inform in viewport about mesh and bake errors if Baking Log is not visible
  • [Baking Mode] Add action to synchronize baker settings across all Texture Sets
    In the Mesh Map Bakers window, each baker (as well as the common settings) can be synced across Texture Sets by clicking on the link icon next to their name. This action will open a window which allows to select which Texture Sets will share the same parameters.
  • [Baking Mode] Add actions to copy and paste baker settings
    In the Mesh Map Bakers window are available actions to copy and past each baker settings across Texture Sets either via the dedicated menu at the top of the window or the right-click contextual menu.
  • [Baking Mode] Add button in Baking Log to jump from error to the right settings
    When a baker fails or a mesh doesn't load properly, an error message appears in the Baking Log. A button next to the message allows to change the Mesh Map Bakers and Mesh Map Settings window to show the related settings. This help isolate more easily the source of an issue to be able to fix it.
  • [Baking Mode] Add menus to manage Texture Sets and Baker selections
    In both the "Texture Set list" and "Mesh Map Bakers" window have been added a little action menu to help copy, invert selections.
  • [Baking Mode] Split baker selection list per Texture Set
  • [Baking Mode] Split common settings per Texture Set
  • [Baking mode] Load high-poly and cage meshes without freezing the interface
  • [Baking Mode] Use the viewport progress bar to show mesh loading
  • [Baking Mode] Add mesh loading state in Baking Log
  • [Baking Mode] Allow to turn around mesh in viewport during baking
  • [Baking Mode] Set baking order based on current mesh viewport visibility
  • [Baking Mode] Display implicit baking cage in viewport
    When not using a custom cage mesh file, an automatic cage mesh will be generated and displayed in the viewport. Its size will we based on the Max Frontal Distance parameter from the baking common settings. The cage mesh is used to indicate how far the matching between the low and high poly will go.
  • [Baking Mode] Show matching list of mesh names for Matching By Name in Baking Log
  • [Baking Mode] Use neutral material to display 3D model in viewport
  • [Baking Mode] Disable engine computation while in baking mode
  • [Baking Mode] Display a warning when quitting the app while a bake is in progress
  • [Bakers] Update anti-aliasing setting labels
    The anti-aliasing setting values have been renamed to "Supersampling" and with an explicit multiplier number to clarify their behavior.
  • [Bakers] Update bakers to version 2.5.7.
  • [USD] Import and export Universal Scene Description (USD) files
  • [USD] Add USD options to the New Project window when selecting a USD file
  • [USD] Add new Scope and Variants selection window
    When importing a USD file, clicking on the change button in the New Project or Project Configuration window allow to select which part and variants of a USD file to import.
  • [USD] Add subdivision levels option
    When creating a new project with a USD mesh file that contains subdivisions, it is possible to select the level of subdivisions using a slider. The project will be created with the subdivided mesh. The level can be modifier via Project Configuration.
  • [USD] Import USD skinned meshes at specific frame
    When creating a new project with a USD mesh file that contains animation, it is possible to select the frame using a slider which reflects the embedded timeline sequence. The frame can be modifier via Project Configuration.
  • [USD][Export] Add an option to export USD files
    New Export USD check box added to Export textures window. When it is checked, it allows to export USD files as well as texture maps using any template.
  • [USD][Export] Add USD file format to mesh export
  • [USD] Rename the existing "USD PBR Metal Roughness" export preset to be more explicit
    The USD export template previously known as 'USD PBR Metal Roughness' is still accessible via Export textures > Output template > USDz (Apple AR).
  • [Auto Unwrap] Add Lock orientation for packing
    New option for auto-unwrap settings which allows to preserve the orientation of existing UV islands when using the packing feature. It can be accessed via New project > Auto-unwrap options > UV island orientation.
  • [Physical Size] Add setting to automatically use Physical Size in fill effect/layer
    A new option to automatically switch to physical size scale when using a material with embedded physical size has been added. It can be enabled per project via New project or via Edit > Project configuration > Physical size > Switch fill layer scaling to Physical size when assigning materials.
  • [Physical Size] Expose physical size for UV projection
    Physical size scaling is now available for UV projections - it enable auto-resizing for a material based on the physical size of a mesh. It can be selected via Scale > Physical size in the Fill layer or effect Properties window.
  • [Scripting][Python] Allow to query the application version
  • [Scripting][JavaScript] Update API to match new baking parameters
  • [Scripting][Python] Baking module: edit baking parameters
  • [Scripting][Python] Baking module: launch/cancel baking
  • [Scripting][Python] Baking module: select curvature method
  • [Scripting][Python] Baking module: selection of bakers/uv tiles
  • [Scripting][Python] Baking module: synchronize baker settings across all Texture Sets
  • [SVT] Enable sparse hardware support on AMD GPUs
    Hardware acceleration for the Sparse Virtual Textures system can now be enabled with AMD GPUs. This setting is automatically enabled in the general preferences.
  • [Projection] Rename Cylindrical projection parameters
    The parameter "Cylinder Cap Culling" has been renamed to "Backface Culling" to better represent its action. The associated tooltip as been adjusted accordingly.
  • [Project] Save application version in project and retrieve it via scripting
    Since version 8.2, the version of the application is now stored inside the spp file when saving.
    This version number can be retrieved with the function last_saved_substance_painter_version() in the project module of the Python API.
    For project made before 8.2, the returned value will be null.
  • [Import] Improve general import time of 3D models
    We improved the general import time of meshes. For example reducing the waiting time when loading high-poly meshes for baking. This optimization applies in particular to the loading of OBJ files.

Fixed:

  • [Crash] Changing channels on filter with specific stack
  • [Mac][M1] Crash when creating a fill layer and leaving the layer stack
    This issue can be fixed by updating to Mac OS 13 (Ventura).
  • [Scripting][Python] Crash when using ui.add_dock_widget() with wrong type
  • [Baking] Incomplete error message in log when a bake fails
  • [Baking] Memory is not freed when baking is finished
  • [Engine] Texture cache doesn't update when changing effect visibility
  • [Export] 2DView exports randomly uniform map
  • [Project] Memory allocation error when saving project with big mesh
  • [Viewport] TAA causes artifacts when painting in some cases

Known Issues:

  • [Color Management] HDR color space conversions with ACE on Linux produce clamped colors
  • [Layer Stack] Input source not saved per layer
  • [Export] 2D View exports randomly uniform map

 Adobe

Get help faster and easier

New user?