User Guide Cancel

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

Substance 3D Painter 9.1 adds tangent control for the Path tool, support of the SVG file format, the ability to import and apply resources by drag and drop and support for translucency in the viewport.

Release date: 7 November 2023

Major features

 

New tangent controls and improvements for path tool

Banner Path tool

In this new version we continue the development of the Path tool (introduced in version 9.0) to add missing bits and features requested by the community.

  • Control path points tangents manually

    It is now possible to manually set the tangents of a specific point on a path. This allows to override the automatic behavior to create new shapes.

    Custom tangents

  • Edit path points via manipulators

    Sometimes, just slidings points on the surface of the object is not enough. The manipulators allow to move points beyond the surface. This can be very helptful to move several points at once for example in case they were too far from a surface after a mesh re-import.

    Path tangents translate manipulator

  • Toggle paths visibility individually

    Paths visibility can now be changed per path via the dedicated viewport panel. Disabling a path will remove its contributions from final textures without having to delete it.

    Path panel visibility

  • Copy and paste path positions and properties

    Copy and pasting paths has been extended to be able to only copy a path point positions or its properties. Syncing paths in different ways is now possible, making it easier to create complex effects (via the positions) or to share a specific look across different locations (via the properties).

    Gif showing how to copy and paste path properties

    Gif showing how to copy and paste path positions

Note:

For more information about the Path tool, see the dedicated documentation.

New support for translucency, transparency and absorption in viewport

Banner ASM

The Adobe Standard Material (ASM) shader, which is the default when creating a new project, has been updated to support Translucency, Transparency and Absorption properties. This means it is now possible to view the result of those rendering behaviors in the real-time viewport (as well as inside Iray renderer).

So authoring materials like glass, foliage or plastics with a thin absorption of light is now possible and directly viewable in the viewport. Exporting to other Substance 3D applications will also result into matching look thanks to the ASM definition.

  • New ASM shader settings

    The ASM shader has been updated to support new functionalities, which can be modified via the Shader settings window:

    • Transparency (opacity): is it not necessary anymore to switch to another shader to get transparent surfaces, like foliage. Instead, enable either the alpha test or alpha blending parameter under the Geometry > Opacity group. The usual settings, like dithering, are also available.
    • Translucency: this new property allows to create surfaces like glass, making shapes transparent while keeping the specular reflections. To use it add a Translucency channel in your project and enable the Translucency parameter under the Interior group.
    • Absorption: this new property allows to simulate light passing through an object and being absrobed which can be useful to simulate plastic or liquids in a better way than using sub-surface scattering. To use it enable the Absorption setting under the Interior group.
  • Improved shader settings UI and tooltips

    With the rework of the shader we took the opportunity to improve the UI of the parameters, as well as adding many new tooltips to more easily discorver how to activate them.

    The order of parameters should also match better other Substance 3D software, making it easier to do back and forth when trying out settings.

    ASM tooltips

  • New sample project to demo the Adobe Standard Material

    Manipulating the new ASM properties can be difficult at first, so a new sample project demonstrating several features of the shader has been added to make it easier to learn them.

    This project is called French Restaurant Table and can be found via the File > Open sample menu. It also uses a lot of little tricks, so it can be a great learning resource to discover new ways of texturing.

    Demo sample project

  • Translucency channel now defaults to a black color

    In order to make the new shader properties easier to use and avoid unexpected results in the viewport, the default color of the channel Translucency has been changed to black (instead of white).

    If this channel was already in use in your project, you can get the previous behavior by simply adding a fill layer at the bottom of your layer stack and setting the channel value to white. You might want to enable the setting Use translucency as scattering mask in the shader parameter as well to re-apply the contribution of the channel to the sub-surface scattering result.

New support for vector graphic files (SVG)

Banner SVG

This release adds the support of SVG files as resources that can be used in layers, paint tools, etc.

SVG file are quite handy to represent logos or shapes precisely while being very lightweight. In Painter they can be rendered at a desired resolution and easily updated, making them perfect for the non destructive workflow.

  • Import SVG files
    SVG files can be imported like any other resources, in projects, in libraries, etc. SVG up to version 1.1 can be imported, features from newer versions are unsupported.

    Import has also been made easier in this version as well (see below) so that using SVG files can be done by simply drag and dropping resources from outside Painter directly onto the mesh or the layer stack.

  • Dedicated SVG settings
    When using an SVG resource, a few settings are available to control its look:

    • Resolution: to either use an automatic one, one defined within the file or one a custom value.
    • Crop area: to define the specific region of the SVG canvas to use.
    • Scope: to select the whole content of the SVG or only some elements.
    SVG settings

  • New SVG tailored materials

    3 new resources have been added to help the use of SVG files when texturing:

    • Custom Spray Paint: allows to simulate a decal painted on a wall from a single input image.
    • Custom Sticker: to create a plastic sticker on a surface. It features several settings to simulate damage and folding.
    • Graphic to Material: allows to create several material properties from a single image input. This resource is automatically inserted when drag and dropping an SVG file into the viewport. This resource offers an easy way to share the transparency of its input across multiple channels, making it perfect for simple decals.
    SVG resources icons

    Graphic to material demo

Note:

For more information about the SVG format and settings, see the dedicated documentation.

New import of resources via drag and drop

Banner import drag and drop

This release make it possible to drag and drop an external file into different contexts of the application to automatically import a resource and use it. This new process allows to skip tedious steps related to importing files.

  • Import via drag and drop into the viewport

    Drag an external file into the viewport to be able to put it directly on the mesh. This action will automatically create a new layer. Depending on the nature of the resource (image, Substance material, Substance filter, etc.) the result will adapt accordingly.

  • Import via drag and drop into the layer stack
    The same way it is possible to drop external resource files into the viewport, dropping files into the layer stack allow to directly create layers or effects with the resource in it.

  • Import via drag and drop into a resource slot

    Importing a resource directly into a layer or a tool is also possible. If a fill layer or effect with the right setup already exists, simply drop an external file into one of the channel slot of the Properties window to import and apply it.

Note:

For more information on importing resources, see the dedicated documentation.

New resource drag and drop behaviors

Banner drag and drop

Drag and drop improvements are not limited to importing resources. Drag and dropping a resource from the Assets window can now be used to create new layers, effects and even masks on the fly.

  • Drag and drop many types of resources

    It is now possible to drag and drop types of resources directly into the viewport or the layer stack. The following type of resources can now be drag and dropped (almost) anywhere:

    • Alphas
    • Textures
    • Procedurals
    • Materials
    • Smart materials
    • Smart masks
    • Generators
    • Filters
    • Environment maps
  • Drop resources as new layer or effect

    By choosing where a resource is dropped, Painter will automatically create a new layer or a new effect:

    Drag drop in layer stack

  • Choose between Content or Mask effect stack while dragging

    When dragging a resource over a thumbnail Painter will automatically switch to the associated effect stacks. After that it becomes very easy to just drop the resource in a precise location inside that stack. This avoid the need to switch to the right stack beforehand.

    Effect stack switch

  • Create a new black mask on the fly

    A new icon appears on any layer without a mask while dragging a resource. When a resource is dropped on this ghost mask it will automatically create a new mask and add the new resource. It is a quick way to setup a new mask and avoid to cancel the drag and drop to add it manually.

    Drag and drop to create new mask

  • Drop in the viewport to create new layers

    Drag and dropping resources can also be done in the viewport to create new layers. Depending on the type of the resource, the result may change. A filter will create a paint layer in passthrough mode, while a smart mask will create a fill layer with a new mask.

    Drag and drop smart mask

    Drag and drop filter

  • Use keyboard modifiers for advanced behaviors

    When dropping a resource, maintaining the keyboard modifier CTRL or ALT can enable additional behaviors:

    • CTRL while dropping in the layer stack: create a new layer with the resource in a black mask. can be useful to force a material to be put into a mask for example. Or to skip the dropdown menu with an alpha.
    • ALT while dropping in the layer stack: only applies when dropping over a layer thumbnail. ALT will remove all the previous effects. This can be used as a quick way to try out different resources, notably smart masks, without having to manually remove them first.
    • CTRL while dropping in the viewport: create a new layer with the resource in a black mask. The resource will be put under a Color ID Selection effect which will be set based on the selection done in the viewport.
    • ALT while dropping in the viewport: same as before, will force a resource to be in decal projection mode.

Miscellaneous improvements

Banner misc

Several minor features and improvements have also been added in this release.

  • Lossless compression of 16bit images

    From now on, any images contained in a project with a bit depth of 16 will be compressed with a lossless algorithm, allowing to reduce their size without losing quality. This is in addition of the project file already compressing its own data.

    This change principally target bake textures which are usually the reason why project files can be very heavy on the disk. In average we saw projects being reduced by 30% to 50% in size on disk.

    This compression is applied automatically when saving any project (old or new) on resources not already compressed. It means that for old projects, saving for the first time in this new version could take a bit more time than usual. Saving time should be back to normal once this is done.

  • New UV set to UV set fill projection mode

    A new projection mode for fill layers/effects has been added named UV set to UV set projection. It can be used to project a texture based on different UVs available on the mesh inside the project. It can be used to perform more advanced texture transfert without the need to rely on external tools.

    UV set 0 is the default UV used for painting by Painter. If additional UV sets are available, they will be available inside the dropdown from the setting Source:

    UV set projection

  • Temporal Anti-Aliasing is enabled by default on any new project

    When creating a new project, the Temporal Anti-Aliasing setting available in the Display Settings window is now enabled by default in order to improve the quality of the rendering in the viewport.

  • New Python API improvements

    The Python API recived a few additions in this release:

    • Painter can be closed/shutdown via Python with the new substance_painter.application.close() function.
    • The main viewport camera can now be modified via the API. This includes its position, rotation but also its other properties like Field of View, Aperture, etc. To make it easier to position the camera regarding the mesh, the API now also exposes the scene bounding box.
    • Exporting the project mesh, with triangulation or not and displacement or not, is now possible via the export module.
    • The project export textures path can now also be retrieved from the API.
  • New send to After Effects (beta)

    A new send to action is available to export a mesh and its texture to After Effects, making it convenient to iterate on visual effects. This feature requires the access to After Effects version 24.1 beta minimum.

Tutorials

Release notes

9.1.0

(Released: November 07, 2023)
Summary: Major release introducing SVG and transparency support, as well as drag and drop and path tool improvements

Added:

  • [SVG] Allow to import vectorial files (SVG)
  • [SVG][UI] Add support for SVG-specific properties
  • [SVG] Add an option to easily preserve original image proportions
  • [SVG] Allow to automatically use alpha of SVG with transparency
  • [Interop] Allow to send a textured mesh to After Effects (Ae 24.1 beta)
  • [Interop] Add settings for Send to After Effects
  • [QoL][Assets][UI] Auto-import asset when drag and dropping into UI slot
  • [QoL] Allow to drag and drop external assets into the layer stack
  • [QoL][Layer Stack] Drag and drop textures from Assets Panel into the Layer Stack
  • [QoL][Viewport] Allow to drag and drop generator, filters on the mesh
  • [QoL][Viewport] Allow to drop external assets onto the mesh
  • [QoL][Projection] Add new UV set to UV set projection mode
  • [QoL] Drag and drop Smart Masks as new layers in viewport and Layer Stack
  • [QoL] Add selector for Generators with multiple outputs when used in mask
  • [QoL] Allow to drag and drop single channel images over a fill effect
  • [QoL][Layer stack] Use CTRL/ALT modifiers with drag and drop to specify where/how to create effects/layer
  • [Path] Toggle paths visibility individually in path panel
  • [Path] Allow to use transformation manipulators for path points
  • [Path] Allow to control tangents per vertex manually
  • [Path] Copy/paste path properties
  • [Path] Introduce an empty shortcut for break tangent button
  • [Shader] Add support for Opacity & Translucency in ASM shader
  • [Shader] Add support for Absorption color channel with ASM shader
  • [Shader] Improve ASM shader parameters tooltips
  • [Shader] Change Translucency channel default color to black
  • [Display settings] Enable Temporal Anti-Aliasing by default
  • [Display settings] Enable Sub-surface scattering setting by default
  • [Substance] Add support for ColorSpace property from graph input/output
  • [Substance] Update Substance engine to version 9.0.3
  • [UI] Make contextual toolbar button accessible even if the app window is small
  • [Auto Unwrap] Control UV Tiles number with Texel Density
  • [Baking] Deactivate GPU raytracing on AMD GPUs by default
  • [Performance] Apply lossless compression on 16bit images to reduce project footprint
  • [Python] Allow to manipulate the default Camera in 3D View
  • [Python] Expose the ability to export mesh via scripting
  • [Content][Samples] Add new sample project "French Restaurant Table"
  • [Content] Update Substance logo alpha to new version
  • [Content] Add three SVG focused material filters (Custom Sticker, Custom Spray and Graphic to Material)

Fixed:

  • [Crash] Changing manipulator size when not using symmetry tool
  • [Crash] [Layer stack] Creating layer when nothing is selected
  • [Project] Mesh maps can be corrupted after a removing unused resources
  • [Project] Resource corruption after re-importing or re-baking image
  • [Assets] Reloading an asset removes it from Favorites
  • [Import] Can not import resources when there is "No result found" in asset panel
  • [UI] Contextual toolbar arrow does not appear in some cases
  • [Substance] Side by side button for boolean values is not supported
  • [Level] Wrong channel label when used in mask
  • [Export][glTF] glTF/GLB files exported from Painter do not have a physical size unit
  • [Content] Blur filter intensity is clamped to 16
  • [Content] Color Match filter "target color" image input is not visible

Known issues:

  • [Color Management] HDR color space conversions with ACE on Linux produce clamped colors
  • [Crash][Linux] with Linux Wayland on AMD when drag and dropping resource in the Layer Stack
  • [Crash][Mac] Changing Anisotropic filtering value on Monterey OS
  • [Crash] Exr used as image input
  • [Crash] Using 16K environment map
  • [Auto Unwrap] UI issue for texel density control
  • [Regression][UI] Right Click Menu is too small on hd screen
  • [Python] Crash exporting USD triggered by TextureStateEvent
  • [QoL] Drag and drop of Alpha resource in decal mode creates UV projection in mask

 

Get help faster and easier

New user?