User Guide Cancel

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

With Substance Painter 2.6 our focus was to provide a way to manage the texture sets directly inside Substance Painter, without the need to make a new project or reimport your mesh with updated material names. We also wanted to provide a way to update resources used in projects, something we saw requested a lot in the past.

Release date : 27 April 2017

Major Features

New sample project "Meet Mat"

This new sample project offer a new shiny and adorable character named "Mat". It contains three texture sets ready to be painted on.
Participate in the Meet Mat contest with it to win some really cool prizes : https://www.allegorithmic.com/contest/meet-mat-2017-substance-3d-painting-contest

New scripting API with ability to update resources in projects

The scripting API of Substance Painter has been improved to add new functions that allow to replace resources in project with other versions. To demonstrate this new feature, a new plugin created with the scripting API has been added and allow to browse all the resources contained in a given project. Resources marked as red are detected as "outdated" and can be automatically replaced. This feature is not limited to "outdated" resources, any asset can be replaced with something else. This offer a lot of new possibility and show even more how Substance Painter is a non-destructive Painting tool !

The plugin is available on GitHub, don't hesitate to help if you see potential improvements : https://github.com/AllegorithmicSAS/painter-plugin-resources-updater

New ability to rename and reassign texture sets

It is now possible to change the name of a texture set directly inside Substance Painter. Renaming a texture set will affect the name of the textures that are exported on the disk (depending of the export preset used).
To rename a texture set, simply double click on its name to modify it or use right-click to open the context menu. It is also possible to add custom descriptions to give more information about what texture sets do. This can be really helpful when working on an UDIM project. Use the "settings" button to configure the way descriptions are displayed in the list.

Texture Sets can now be reassigned to different Mesh Materials. This means it is possible to recover Texture Sets previously disabled (because they were missing on the mesh) or even swap them. Simply click on the new "settings" button in the Texture Set List window and click on the "Reassign Texture Sets" entry. It will open a new window dedicated to managing the Texture Sets and how they are linked to the Mesh Materials. The management can be done by drag and dropping a texture set name where you want.

Tutorial

The new major features are covered in our latest video tutorial :

Release Notes

2.6.2

(Released 20 October 2017)

Added :

  • [Texture Set] Allow to delete disabled texture sets

  • [Shelf] Allow multiple users to write inside the same shelf folder

  • [Scripting] Be able to reload plugins folder

  • [Scripting] Add a required minimal API version in plugin metadata to ensure compatibility

  • [IRay] Export image dialog improvements

Fixed :

  • [Engine] Disappearing strokes issue, when changing resolution (4K>2K)
  • [Bakers] ID Map Baking fail with Match By Name enabled
  • [Bakers] Error messages are not explicit enough
  • [3D View] Tangent space is not synched with bakers
  • [Tool] Black artifacts when using the smudge tool
  • [Shader] Non-PBR shader doesn't work anymore
  • [Shader] "pbr-coated" is broken
  • [Shader] Coating Roughness of "pbr-coated" shader has no impact anymore
  • [Shader] Spec gloss shader doesn't match Iray and SD
  • [Shelf] Crash when loading two files with the same name but different extensions
  • [Shelf] Can't edit preset anymore in the shelves
  • [Shelf] Cannot set a custom preview for assets imported in the shelf
  • Resources loaded from the cache lose their usages
  • Saving a project before creating a template returns write permission errors
  • Incorrect project save if filename contains two periods
  • Importing files with multiple dots (.) in the filename causes issues

2.6.1

(Released 12 May 2017)

Added :

  • [TextureSet] Don't allow to reassign mesh materials to nothing

Fixed :

  • Crash when switching of TextureSet after replacing baked map
  • Crash when doing "Undo and Redo" after changing layer's blending mode
  • Crash or Freeze when using the "color selection" effect with big ID map
  • [Export] Texture Sets renamed are not sorted alphabetically in the export window
  • [TextureSet] Reset to default name doesn't check for unicity
  • [TextureSet] Renamed texture set become disabled after reopening project
  • [Shelf] Missing default templates content
  • [Shelf] Non-square textures are displayed as square
  • [Shader] Once a texture set is disabled the associated shader is destroyed
  • [Scripting] alg.baking.setTextureSetBakingParameters() doesn't work anymore
  • [Scripting] Typo in websocket tutorial
  • [Scripting] Various problems in AlgWidgets
  • [Log] Incorrect detection of available virtual memory in some cases

2.6.0

(Released 27 April 2017)

Added :

  • Add new sample project "Meet Mat"
  • [Plugin] New "Resources Updater" plugin
  • [TextureSet] Allow to rename and add a description to texture sets
  • [TextureSet] Allow to reassign materials
  • [TextureSet] Add a setting button in the texture set list window
  • [TextureSet] Show "disabled" texture sets at the bottom of the list
  • [Substance] Use additional maps at the current texture set resolution to improve performances
  • [Scripting] Allow to update a resource used in a project (material, generator, etc.)
  • [Scripting] Add a way to add/remove a shelf
  • [Scripting] Allow to query info from resource in projects
  • [Scripting] Allow to retrieve a list of available shelfs
  • [Scripting] Improve AlgWidget thumbnail tutorial
  • [Export] Disable/Enable bit depth based on file format support
  • [Log] Add plugin name to print in console
  • [Log] Remove error about hidden texture sets
  • Update "Welcome Screen" with new icons and text for samples

Fixed :

  • Crash when updating a mesh in specific projects
  • [Viewport] Symmetry plane inner color is not visible anymore
  • [Viewport] Some post-process effects are enabled when using the solo view
  • [Shaders] "over_premult" blending doesn't work properly
  • [Shaders] Warning about alpha-test with the default shader
  • [Shelf] Incorrect parsing of tags from Substances
  • [Shelf] MatFX Rust Weathering doesn't work properly
  • [Shelf] HSL filter is enabled on incorrect channels by default
  • [Shelf] Sharpen is enabled on Height/Normal channel by default
  • [Export] Vray export presets don't use an OpenGL normal map
  • [Tool] Imprecision issues with clone/smudge tool create artifacts

Get help faster and easier

New user?