User Guide Cancel

Version 2017.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 2017.3

Substance Painter 2017.3 focus on new advanced export preset with the support of Adobe Project Felix and the open format glTF. This new release also focus on the user experience by improving the interface and adding an autosave plugin.

Release date : 28 September 2017

Major Features

Adobe Standard Material export preset

One of the new exporter we include in this release is the support of the Adobe Standard Material, to be used with Adobe Dimension (previously Adobe Project Felix). We let you export the scene mesh and its textures to be imported into Project Felix in one click. To access it, simply choose "Adobe Standard Material" in the export textures window. For more information, see : http://www.adobe.com/products/dimension.html

You can also check out our blog post about it : https://www.allegorithmic.com/blog/new-dimension-substance-ecosystem

glTF 2.0 export preset

We also added support for the glTF file format, with the export of the scene mesh and the PBR textures (metallic/roughness). To access it, simply choose "glTF PBR Metal Roughness" in the export textures window. glTF is an open-source file format directed by the Khronos group. You can view your glTF file from within Windows 10 or simply use a WebGL viewer such as Babylon.

For more information, see : https://github.com/KhronosGroup/glTF

Autosave plugin

In this release we also included a new plug-in that has the possibility to create backups of the currently opened project. It creates a backup file on the side of the currently opened project.
Because of this, we also added a "Save As Copy" entry in the File menu. The autosave can be stopped by disabling the plugin itself, its settings can be accessed via the configure panel. When the delay of the warning time is reached, a progress bar will appear below the button in the main toolbar, allowing to snooze it for a few minutes if needed (handy if you want to finish something before the backup).

If a backup is created but the project has not been saved (aka Untilted), the backup will be stored inside the Documents/Allegorithmic/Substance Painter/autosave folder. Otherwise, the backup will be next to the project itself (unless the path is overridden by the configuration panel).

Improved gradient filter

The gradient filter has been completely revamped. Acting in a much more similar way to the gradient map node available in Substance Designer. It now supports up to 10 different colors, with the possibility to specify where the color is located inside the gradient, opening a lot of new doors. This allows to create more advanced color patterns but also to remap heigh maps and create new shapes.

The main slider (color quantity) defines the number of total color that are used to create the gradient. The button just below defines the color blending mode (sRGB or Linear). This is important if you want to have a proper blending between colors. For example blending a pure red and a pure green should give a nice yellow in-between. This won't be the case if the button is disabled (it will give a dark brown instead). When remapping the height or any other grayscale channels this button should be disabled to avoid doing the gamma conversion.

The button on top allow to replace the result of the filter with the gradient itself, to visualize the gradient in the 2D view.

Interface and behavior improvements

In this release the tabs of the different docks of the application are now located on the top instead of the bottom of their respective windows. This choice was made to help the readability of the interface but also to be more consistant with other application. Following this change is the introduction of the little cross next to the tab title to easily close it. It is also possible to right-click on the tab to bring a context menu (that allow to close or undock the window). A shortcut to undock the window is to simply drag and drop the tab outside of the window area.

It is now also possible to open projects by simply drag and dropping them into the viewport from the file explorer. This also works with mesh files : drag and dropping a mesh file in an empty viewport will open the new project window, but doing it on an already open project will open the project configuration dialog, allowing to quickly update a mesh.

Note : if you have issus with the drag and drop, be sure to check our FAQ on the subject.

Performance improvements

This version of Substance Painter also include a new and strong performance improvement regarding the way we manage the GPU memory (VRam). Uniform colors (such as fill layers) are now compressed into smaller textures, accelrating their transfert between the main memory and the GPU memory but also reducing their memory footprint and their computation time. This should be especially visible when opening huge projects and when reaching the limits of the GPU memory.

Release Notes

2017.3.3

(Released 01 December 2017)

Fixed :

  • [Steam] Version checker pop-up shouldn't be visible at launch
  • [Export] PSD files have their groups locked when opened in Photoshop CS6

2017.3.2

(Released 20 November 2017)

Added :

  • [UI] Improve new version dialog and add changelog
  • [UI] Indicate if maintenance is expired in new version dialog
  • [License] Update license system to handle Maintenance dates
  • [Export] Rename Adobe Standard Material to Adobe Dimension

Fixed :

  • [Mac] Painting leads to black squares and texture corruptions
  • [Engine] Cache can sometimes disappear in the Viewport
  • [Engine] Blocky artifacts appear when memory compression trigger
  • [Baking] Strange error messages when baking specific meshes
  • [Export] PSD are incorrectly written and are not recognized properly by Photoshop
  • [Layers] It shouldn't be possible to copy/paste layer across multiple projects
  • [Substance] UserData color space for Normal input is flipped in some cases
  • [Shelf] Micro-normal in generators outputs inverted curvature
  • [Shelf] HSL filter also affect alpha channel
  • [Linux] Installation on Centos fails because of missing dependencies
  • Installer doesn't remove all resources from previous install in certain cases

2017.3.1

(Released 26 October 2017)

Added :

  • [Export] Allow to export the mesh from a project
  • [Shelf] Remove "Sub-Shelf" from the tabs titles
  • Save post-process settings in templates
  • Make the TDR message more understandable
  • Improve Settings window to report errors

Fixed :

  • Crash when deleting several sub-shelves
  • Crash when switching from a level to something else during an engine computation
  • [Mac] Crash on Intel GPU during engine computations
  • [Mac][Viewport] Bad performances when dithering is enabled
  • [Mac] MacOS 10.13 is recognized as "Unknown version" in the log file
  • [Baker] Baking with a cage doesn't work anymore
  • [Layers] Ctrl + C shortcut (copy action) doesn't work anymore
  • [Layers] Pasting layers doesn't refresh UI with anchor's references
  • [Anchor] Duplicate or Copy/Paste Layer with References breaks links
  • [Export] 8K export can crash or deadlock application in some cases
  • [Export] Multiple issues in generated glTF file format
  • [Import] Re-importing a mesh with the same filename doesn't work anymore
  • [Plugin] Auto-save window always appear on top of everything
  • [UI] Infinite loop when you Press "Escape" on the TDR Dialog
  • [UI] Reset UI display a second title bar on the shelf window

2017.3

(Released 28 September 2017)

Added :

  • [Export] Allow to export mesh and textures for Adobe Project Felix

  • [Export] Allow to export into glTF file format

  • [Engine] Optimize textures size in VRAM by using block compression

  • [Viewport] Be able to drag and drop a mesh or project in the viewport

  • [UI] Improve warning message about TDR

  • [UI] Log should be displayed only upon request

  • [UI] Allow to clear the content of the log window

  • [UI] Display warnings and errors in the status bar

  • [UI] Display Tabs on top as in web browsers

  • [UI] Improve "not paintable" context and messages

  • [UI] Add a “save as copy” action in the file menu

  • [Layer] Set default tiling setting to 1 by default

  • [Shelf] Improved gradient filter to support 10 dynamic colors

  • [Shelf] Add a space in the default query of the mini-shelf

  • [Shelf] Add a 'Open in explorer' action for local resources in the shelf

  • [Shelf] Add template and shader for Adobe Material Standard (Project Felix)

  • [Shelf] Increase max tiling to 128 in Material Layering shaders

  • [Shelf] Added sobel curvature for micro-details of Mask Generators

  • [Plugin] Add autosave plugin with customizable time interval

  • [Scripting] Add a "save as copy" function

Fixed :

  • [UI] Layout is broken at the first launch

  • [Export] PSD generated at export has format errors

  • [Export] EXR always exports 8 bits height map

  • [Export] Crash when exporting corrupted Additional maps

  • [Import] Hard edges are not preserved on low poly meshes in some cases

  • [Import] Improved error messages when importing meshes with issues

  • [Bakers] ID Map Baking fail with Match By Name enabled

  • [Viewport] Tangent space is not synched with bakers

  • [Effect] Moving back a layer doesn't restore an anchor's reference

  • [Effect] Refresh issue when creating a link in between two Masks with anchors

  • [Effect] Masks anchors above mask shouldn't be listed

  • [Effect] Extract Alpha setting from Anchors doesn't work

  • [Engine] Mask inverts itself after first brush stroke

  • [Engine] Crash when switching Texture Set on specific project

  • [Shelf] Crash when deleting a preset which is in a project

  • [Shelf] Typo in advanced Tri-Planar filter

  • [Shelf] MG Mask Builder AO Noise Scale doesn't work properly

  • [Shelf] MG Mask Builder has inverted curvature parameters

  • [Shelf] Imported alphas generate a material sphere preview instead of a flat one

 Adobe

Get help faster and easier

New user?

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online