User Guide Cancel

Version 2.5 | 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.5

Substance Painter 2.5 introduces a lot of new features : from the support of the opacity in the brush settings (in addition to the flow) to the ability to bake additional map in 8K and much more.

Release date : 21 February 2017

Major features

New Brush opacity

There is now a new setting in the brush parameters when Painting in Substance Painter which is the opacity.
The opacity control the overall intensity of a brush stroke, contrary to the flow setting which control the intensity of each individual stamp inside a brush stroke. This means that it is now possible to paint and repaint a same area without creating overlapping values. To do so, set the flow to 100 and the opacity value to the intensity you prefer. Because of how the opacity works, it is not possible to link it to the pen pressure. For that kind of control the flow is still the best choice.

We also added a new modifier alongside this new parameter which is on the "A" key by default. Pressing this key will allow to continue the previous brush stroke instead of creating a new one. This means you can paint a uniform color with the opacity you want while keeping the possibly to move the camera for example. Another example would be to continue the copy that you were doing with the clone tool.

New baking at 8K and non-square resolutions

The baker have been improved to support resolutions up to 8192x8192 (8K plus anti-aliasing), meaning you can now export at 8K with 1:1 ratio with the additional maps.
We also added support for non-square resolutions. It is now possible possible to bake a texture of 4096x2048 for example. To do so, simply click on the "lock" icon next to the dropdown to select the resolution.

New support for Color Profile in the viewport

We added the support of LUT (textures) to control the rendering of the viewport in Substance Painter. To apply a profile, simply enable the "Color Profile" setting in the "Display settings" window and load the LUT in the dedicated slot. It work both with the OpenGL viewport (painting) and the IRay renderer. A few examples are available by default from common Camera presets to more Artistic effects. For more information, see the dedicated page of the documentation : Color Profile

New Substance engine compatible with Substance Designer 6

We added the support for Substance Designer 6, this means resources created with SD6 can be opened and used in Substance Painter 2.5 !
A good example is the ability to use the new text node of SD6 and integrate it into a substance. This way it is possible to create dynamic text and paint them directly without the need to leave the application. We included 10 fonts with each a different style by default to cover the most common use. You can find them in the "procedural" section of the shelf.

New content in the shelf

Alongside a few fixes and improvements with the new shelf, we also added a bunch of new filters to improve the painting and texturing. We also improved the behavior of already existing filter (like the "HSL"). We also added new templates when creating new projects (such as Unity 5 and Unreal Engine 4).

New scripting improvements with support for custom shader UI

With this release we added a way to script and control the shader parameters. We also added the support for using a custom UI instead of the default one, opening a lot of new possibilities such as animated shader.
For more details take a look at the scripting documentation available from the Help menu of the application.

Tutorial

The new major features are covered in our latest Twitch stream :

Release Notes

2.5.3

(Released 15 March 2017)

Fixed :

  • [Baker] Crash when baking with specific meshes

Known Issue :

  • [Mac] Particles can create texture corruption in some cases

2.5.2

(Released 14 March 2017)

Fixed :

  • [Tool] Wacom tablet don't work on Linux
  • [Tool] Black artifacts when using the smudge tool
  • [Bakers] Baking fail if Match By Name is used with a cage
  • [Bakers] Ambient Occlusion broken when baking with Normal Map only
  • [Shelf] Generic filters don't handle alpha properly (Contrast/Luminosity, Highpass, etc.)
  • [Viewport] Performance issue when loading a project with shadows enabled
  • [Viewport] Dithering issue in 3D View on MacOS
  • [Viewport] Particle previews incorrectly displayed when color profile is enabled
  • [Iray] Crash when switching project back to OpenGL if Iray failed to initialize
  • [IRay] Glossiness is ignored when rendering SpecGloss shader/mdl
  • [Shader] Spec/Gloss shader doesn't match Iray and SD
  • [Shader] sRGB conversion different from linear to sRGB LUT conversion
  • [Shader] Incorrect rendering when loading project with outdated shaders
  • [Shader] "pbr-coated" shader doesn't work anymore
  • [Export] Some channels are still exported even if not present in the texture set
  • [Layers] Blending mode "normal map inverse detail" doesn't work on grayscale channels
  • [UI] Issue on "Color selection window" with HDPI monitor and display zoom at 150%

Known Issue :

  • [Mac] Particles can create texture corruption in some cases

2.5.1

(Released 27 February 2017)

Fixed :

  • [Mac] Wacom tablet input broken in 3D and 2D view
  • [Bakers] Matching by name doesn't work anymore
  • [Bakers] "Average Normals" setting doesn't work anymore
  • [Iray] Incorrect rendering with missing baked normal map
  • [Iray] Color Profiles behave differently in comparison to OpenGL renderer
  • [Iray] Exporting render as bitmap doesn't include color profile correction
  • [Substance] Material filters don't work anymore
  • [Tool] Stroke opacity isn't stored in brush presets
  • [Tool] Clone Brush UV Alignment doesn't work anymore
  • [Export] Displacement channel should be centered in 0.5 when exporting in integer
  • [Template] Absolute path is stored in Templates
  • [TextureSet] Channel texture persist after removing the channel

Known Issue :

  • [Linux] Wacom tablet input don't work in 3D and 2D view
  • [Mac] Particles can create texture corruption in some cases
  • [Export] In very rare case, black rectangles can appear on AMD GPUs

2.5.0

(Released 21 February 2017)

Added :

  • Add support for AMD Radeon Pro and AMD FirePro GPUs
  • [Tool] Add support for stroke opacity
  • [Tool] Add a modifier that allow to continue the last brush stroke
  • [Iray] Update to support Pascal GPUs
  • [Viewport] Add support for Color Profiles (LUT)
  • [Substance] Integrate new framework (SD6 engine)
  • [UI] Increase "recent file" size list in File menu
  • [Import] Use category from substances to fill the prefix in the import dialog
  • [Bakers] Allow to bake 8K textures
  • [Bakers] Allow to bake non-square resolutions
  • [Bakers] Improve memory consumption when baking heavy high-poly meshes
  • [Shelf] Lock shelves (and projects) to forbid concurrent editing and avoid corruptions
  • [Shelf] Read category and keywords from substances to use them for filtering
  • [Shelf] Allow to exclude ressources from the result of a search query
  • [Shelf] Improved thumbnails time computation
  • [Shelf] Allow to embed presets in projects
  • [Shelf] Allow to quickly collapse/expand the tree-view with SHIFT
  • [Shelf] Allow to save thumbnails when assets are read only (local cache)
  • [Shelf] New content : new filters (transform, mirror, tri-planar, etc.)
  • [Shelf] New content : new LUTs profiles (classic and artistic, such as Film Noir, Vintage, etc.)
  • [Shelf] New content : 10 new Font Substances to quickly generate custom texts
  • [Shelf] New templates : Unity 5 and Unreal Engine 4
  • [Shelf] Improved HSL filter to be more artist friendly
  • [Shader] Add support for specular level channel in PBR shaders
  • [Shader] Add support for Dithering in Alpha Test shader
  • [Shader] Add support for parallax occlusion mapping in PBR shaders
  • [Shader] Allow to define custom UI for shader parameters
  • [MatLayering] Create new Mask channel for material layering workflow
  • [Scripting] Allow to write metadata in a SP project
  • [Scripting] Allow to export with a specific export preset
  • [Scripting] Allow to retrieve shader parameters as a JSON
  • [Scripting] Add support for WebSocket connections
  • [Scripting] Add the possibility to load shader instances
  • [Scripting] Add the possibility to create a new project
  • [Scripting] Allow to retrieve the url of the mesh imported in a project
  • [Scripting] Allow non square baking
  • [Scripting] Report errors when setting data via scripting API
  • [Substances] Add user-data tag to specify normal map format

Fixed :

  • Crash when picking color with substances
  • Crash when loading a non RGBA32f image as environment map
  • Crash related to painting on AMD GPUs
  • [Mesh] OBJ import doesn't recognize materials without mtl file
  • [Mesh] UDIM Texture set name generation can be incorrect on some meshes
  • [UI] Undo/Redo button in Viewer Setting steal focus and stop mouse scrolling
  • [UI] Some labels are incorrectly cropped in High-DPI
  • [Layer] Replace mode for paint effect has an incorrect behavior on Mask
  • [Layer] Subtract blending mode has an incorrect behavior with alpha
  • [Tool] Brush size becomes huge in 2D View when painting on UV borders
  • [Tool] Snapped straight line has erratic behavior with High-DPI
  • [Tool] Stencil resolution is sometimes incorrect
  • [Bakers] "Max Occluder Distance" values are clamped if "relative to bounding box" is "Off"
  • [Shader] Stack and auto param channel definitions don't match
  • [3D View] Inconsistent display of the normal channel depending of project setting
  • [Viewport] Some normal maps have clamped values which appear as artifacts
  • [Viewport] Post-effect are always disabled by default
  • [Export] Normal mixing setting is incorrect if normal channel is missing
  • [Export] Incorrect texture generation in some cases on AMD GPUs
  • [Export] Shader parameters are not exported properly if located inside a group
  • [Export] Editing an export preset in a custom shelf output a log error
  • [Shelf] Tree-view filtering does not match exactly the folder name
  • [Shelf] Renaming a shelf preset is hard to read
  • [Shelf] Shader resource imported in the Shelf isn't preserved after relaunching
  • [Shelf] Content : Weld tool preset is missing
  • [Shelf] Content : Tile Generator doesn't work properly
  • [Shelf] Content : Fixed incorrect mask on Rubber Tire Dirty smart material
  • [Shelf] Content : Fixed incorrect group name on Leather bag material
  • [Iray] Half of meshes are missing in Iray
  • [Linux] Crash when dragging a resource above the 3D View
  • [Mac] Preferences are reset at every launch on Sierra

Known Issue :

  • [Export] In very rare case, black rectangles can appear on AMD GPUs
  • [Iray] Color Profiles can behave in odd ways sometimes

Get help faster and easier

New user?