User Guide Cancel

Version 11.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. Output templates
        1. Output templates overview
        2. Default Output templates
          1. Default output templates
          2. Predefined output templates
          3. USD PBR Metal Roughness Preset
        3. Creating Output templates
    6. Glossary
  4. Interface
    1. Interface overview
    2. 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
    3. Substance 3D Assets
    4. Color picker
    5. Display settings
      1. Display settings overview
      2. Environment settings
      3. Camera settings
      4. Viewport settings
    6. History
    7. 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
    8. 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
    9. Project configuration
    10. Properties
    11. Settings
      1. Settings overview
      2. General preferences
      3. Shortcuts
      4. Libraries configuration
    12. Shader settings
      1. Shader settings overview
      2. Updating a shader
    13. Texture Set
      1. Texture Set overview
      2. Texture Set list
      3. Texture Set settings
      4. Texture Set reassignment
    14. Toolbars
    15. Viewport
      1. Viewport overview
      2. 2D view
      3. 3D view
      4. Camera management
    16. Miscellaneous
      1. Sliders
      2. Log
      3. Update checker
  5. Painting
    1. Painting overview
    2. Paint tools
      1. Paint tool overview
      2. Paint brush
      3. Eraser
      4. Projection
      5. Polygon fill
      6. Smudge tool
      7. Clone Tool
      8. Quick mask
    3. Path tools
      1. Path tool overview
      2. Paint along path
      3. Ribbon path
      4. Filled path
      5. Erase along path
      6. Smudge along path    
    4. Straight line   
    5. Lazy mouse 
    6. Symmetry
      1. Symmetry overview
      2. Mirror symmetry
      3. Radial symmetry
    7. 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
    8. 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
        1. Photoshop brush presets overview
        2. Exporting Brush Presets from Photoshop
        3. Importing Photoshop Brush Presets
        4. Photoshop Brush Parameters Compatibility
    9. Dynamic strokes
      1. Dynamic strokes overview
      2. Enabling Dynamic Stroke feature
      3. Dynamic Stroke Performances
      4. Creating custom Dynamic Strokes
    10. Advanced channel painting
      1. Channel painting overview
      2. Ambient Occlusion
      3. Flow Map
      4. Height Map
      5. Normal Map
    11. Vector graphic (.svg & .ai)
    12. 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. Mesh map settings
    4. 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 resource update
    2. Automatic UV Unwrapping
    3. Physical size
    4. Smart Materials and Masks
    5. Subsurface Scattering
      1. Subsurface Scattering overview
      2. Enabling Subsurface in a Project
      3. Subsurface Parameters
      4. Subsurface Material Type
    6. Dynamic Material Layering
    7. UV Reprojection
    8. UV Tiles
      1. UV Tiles overview
      2. Image Sequence
    9. Color Management
      1. Color management overview
      2. Color management with Adobe ACE - ICC
      3. Color management with OpenColorIO
    10. 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
    11. Iray Renderer
      1. Iray Renderer overview
      2. Iray Settings
      3. Viewer and MDL Settings
    12. Plugins
      1. Plugins overview
      2. Autosave
      3. Resources Updater
    13. Sparse Virtual Textures
    14. Custom Shaders
    15. SpaceMouse® by 3Dconnexion
    16. Universal Scene Description (USD)
    17. Send to
  10. Technical Support
    1. Performance Guidelines
      1. Performance guidelines overview
      2. Mesh and UV setup
      3. Layer management
      4. Project resources and settings
      5. Conflict with background applications
      6. GPU VRAM and Drivers
    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
        6. Viewport appears broken or unresponsive on Ubuntu
      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
        2. Paint Tool bleeds on other UV islands
      3. Project Issues
        1. Corrupted project file
        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. Add resource paths manually
        2. Editing resource paths manually
        3. Edit 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 11.1
    4. Version 11.0
    5. Version 10.1
    6. Old versions
      1. Version 10.0
      2. Version 9.1
      3. Version 9.0
      4. Version 8.3
      5. Version 8.2
      6. Version 8.1
      7. Version 7.4
      8. Version 7.3
      9. Version 7.2
      10. Version 2021.1 (7.1.0)
      11. Version 2020.2 (6.2.0)
      12. Version 2020.1 (6.1.0)
      13. Version 2019.3
      14. Version 2019.2
      15. Version 2019.1
      16. Version 2018.3
      17. Version 2018.2
      18. Version 2018.1
      19. Version 2017.4
      20. Version 2017.3
      21. Version 2017.2
      22. Version 2017.1
      23. Version 2.6
      24. Version 2.5
      25. Version 2.4
      26. Version 2.3
      27. Version 2.2

Version 11.1

Substance 3D Painter 11.1 brings the new Ribbon path tool with dedicated content, symmetry on fill layers and effects, physics size for displacement and the support of Vulkan graphics API.

Release date: November 18, 2025

Note

This version of Painter switches the graphics API from OpenGL to Vulkan. This change may impact which GPUs are supported by the application, notably for baking with GPU-based raytracing.

For more information check out our system requirements page.

Major features

new Ribbon tool

The Ribbon path is a new tool in the path tool family. A Ribbon will transform and repeat a texture along a path without any cuts, with extra control for the start and the end, as well as options for sharp corners.

This new tool opens the door to new behavior such as putting text along paths, placing perfect gradient along a path, and easily creating your own advanced trims to wrap around a mesh.
In short, the ribbon is a cleaner tool for more precise drawing with paths.

  • New Ribbon tool available next to the other path-like tools
    The new Ribbon tool is available next to the other path like tools in the interface. It can be selected either from the toolbar or from the path type shortcuts.

  • The Ribbon is a continuous path that works across all kinds of surfaces
    ItThe Ribbon is a tool that allows to repeat or stretch a texture along a path. It works across any kind of surfaces and geometry, even when mesh parts are not connected.

  • Making repeating patterns and gradients
    This new tool can repeat images in various ways with no seams or cuts, which is suitable for gradients and clean patterns.

  • Stretch images with custom start and end
    The stretch between offsets setting allows to isolate parts of an image to use them as start and end sections on a path, while the middle section is stretched along the rest of the path. This can come in handy to quickly use simple bitmaps and place them along a path without distortions, like arrows.

  • Different corner types available
    When breaking tangents to create corners, several shapes are available depending on the needs - from classic break to smooth turning.

  • Stretching and tiling controls
    Images can easily be repeated or stretched along a Ribbon path, either automaticaly or manually.

  • Text along path
    Font resources can be used directly on a Ribbon path. Text automatically adjusts to the path to deform along it curves. Alignments settings can be used to better adapt text for any situations.

  • Aspect ratio and non-square resources
    Non-square resources are automatically adjusted to fit to the Ribbon path's length, which makes it ideal for elongated patterns, such as repeating decorations and trims.

  • Compatible with Substance dynamic strokes workflow
    Ribbon paths are also compatible with the Substance based dynamic stroke system, making it possible to create complex results. One notable example is the ability to have custom start/ends and left/right corners.
    Two new tool presets named Custom Ribbon Grayscale and Custom Ribbon Material are also provided to make this functionality easily accessible.

  • Compatible with symmetry
    Like other types of tools, the Ribbon path is also compatible with the symmetry feature.

  • Blending modes when self-overlapping
    When a Ribbon path crosses over itself, it can lead to unexpected results. The dedicated blending mode for the Alpha, Normal and Height channel can help to achieve better results.

Additional improvements have been made across all path tools:

  • Separate size and opacity per vertex on paths
    Adjusting the size and opacity per vertex on a path is now possible and not tied to the pressure parameter anymore. These two properties are now handled separately with dedicated sliders in the interface.

  • Parameters grouping in the Properties window
    Most tools in Painter now have collapsible groups for their parameters. This change makes it easier to hide parameters on the fly and reduce the length of the window.

Note

For more information on the Ribbon tool, check out the dedicated documentation page.

For more information on dynamic strokes, check out the dedicated documentation page.

New content and categories for Ribbon tool

This release includes 75 new tool presets which take advantage of the new Ribbon capabilities. To make the presets easier to discover, new preset categories have been added in the Properties window.

  • New preset categories shortcuts in Properties window
    A series of new buttons now sits at the top of the Properties window when using any path tools. Each button gives access to tool presets, sorted per categories. The favorites category regroups presets you chose.

    Clicking on one of the buttons will give a quick access to some pre-selected presets. Clicking on Show more in Assets will reveal more path tool presets in the Assets window.

  • Quick switch between presets
    To make switching between presets easier, clicking on a preset no longer deselect the currently edited path.

  • New content
    75 new tool presets dedicated to the Ribbon tool have been added in this version as part of the default content. These presets are available directly inside the Assets window under the brush section or via the new categories shortcuts in the Properties window.
    These presets include:

    • Apparel: Improved seam puckering and topstitches presets, as well as zippers and fabric tears.
    • Basic: Simple strokes such as lines and dashes, but also gradients and the Custom Ribbon presets based on the Dynamic Stroke system.
    • Grunge: 3 types of cracks to simulate damages on various kind of surfaces.
    • Hard surface: Grip patterns, panel and shutlines detailing, tapes and welding to use or mechanical objects.
    • Organic: Bandages, both clean and dirty, to wrap around skin and other surfaces.
    • Paint: brush based gradients and gouaches presets.
    • Text: Quick presets to setup text along a path with the Ribbon with different alignments modes and stretching.
  • New tool keyword for searching in Assets window
    Typing "ribbon", "paint", "path" or even "smudge" in the Assets window is now possible and can help find presets which will match the corresponding tool.

New symmetry for fill layers and effects

Fill layers and effects now support symmetry with their 3D projection modes. It can be enabled via the symmetry menu in the contextual toolbar or via the newly added symmetry section in the Properties window.

  • Symmetry on fill layers
    When using 3D based projection modes in fill effects and layers, symmetry can now be enabled. Both mirror and radial symmetry are available.

  • Enable symmetry via the contextual toolbar or the Properties window
    Symmetry can be activated via the contextual toolbar menu, similar to paint tools, or via the Properties window with the new dedicated section.

  • Flip input resource for Texts and Logos
    Fill layer and effects symmetry also benefit from a new options than allows to flip the input images or the X/Y axes. This allows to mirror a text for example but still make it readable on both sides.

  • Improved symmetry settings interface
    The interface of the symmetry settings has been reworked to be easier to read and quicker to use. Axes sliders each have their own line for example, which helps to be more precise. The radial display has also been downsized to occupy less space.

For more information about the symmetry, see the dedicated documentation page.

Physical size for displacement

Displacement can now be defined with a specific unit. This change makes it easier to align and match the displaced geometry across other applications.

  • New scale unit option in displacement settings
    In the Shader settings window, when adjusting the displacement intensity, there is a new scale unit settings available. This setting offers the following options:

    • Normalized: default, matches the previous behavior of Painter. This size is based on the mesh bounding box inside the current project.
    • Scene: uses the units stored inside the mesh file as the reference point.
    • Physical size (cm): uses the project's unit defined in the Project configuration window.

New Vulkan graphics backend for Windows and Linux

In continuation of the work started in our previous version, which switched from OpenGL to Metal on Mac OS, this new version now uses Vulkan on Windows and Linux platforms.

  • Vulkan graphics API is now used instead of OpenGL on Windows and Linux
    Painter now uses the Vulkan graphics API for rendering in the viewport and computing textures. This switch should improve the general performance of the application. It will also make it easier to integrate new functionalities in the future.

  • GPU raytracing for baking via Vulkan
    DirectX raytracing (DRX) and Optix have been replaced in favor of raytracing via the Vulkan graphics API in our bakers. This change means that GPU based raytracing is now available on AMD GPUs as well as on the Linux operating system.
    Switching to Vulkan also improve baking render times, especially at high resolutions.

Miscellaneous

Additional features and improvements have been added in this version:

  • Substance resolution override
    When using Substance resources in Tools and Fill layers/effects, a new Resolution parameter group is available. These settings can be used to change the default resolution selected by the application.
    This can be useful to either increase or reduce the resolution a Substance is generated at, for quality or performance reasons.

    The available settings are:

    • Resolution: define the mode and context used to compute the resolution. Default is Auto, but it can set to Texture Set or Custom.
    • Factor: additional control over the resolution,  to create relative differences. For example: using half of the resolution of a given context.
    • Output size: the final resolution computed based on the previous settings.

  • Performance improvements on single big triangle
    Until now, Painter would struggle on very low poly meshes or meshes with very big and/or long triangles. This is no longer the case. Working with single quad meshes, for example to create tiling textures, should not be a problem anymore.

  • Improved default brush shape
    The default brush shape has been updated with new settings to control its size and roundness while taking into account the hardness behavior.

Tutorials

Here is the latest tutorial that covers our new feature:

Release Notes

11.1.0

Release date: 2025/11/18
Summary: This update is a major release, it contains the new Ribbon tool with dedicated new content, symmetry support for fill layers, physical size parameter for displacement, improved performance through the updated bakers, full Vulkan support for Windows and Linux and other improvements.


Added:

  • New ribbon tool
  • [Tool] Add new Ribbon tool to make seamless paths
  • [Ribbon] Add Ribbon preset shortcuts in Properties window
  • [Ribbon] Allow to change the opacity of the Ribbon per vertex on the path
  • [Ribbon] Allow to change the size of the Ribbon per vertex on the path
  • [Ribbon] Remove begin/end defined in a Substance when paths are closed
  • [Ribbon] Remove Path/Material preview in properties window for Paint/Eraser/Smudge path tools
  • [Ribbon] Add blending modes for the alpha and some channels when self-overlapping
  • Fill symmetry
  • [Fill] Add support for symmetry on fill layers and effects
  • [Fill][UI] Expose symmetry settings in properties window for fill layer and effects
  • [Fill] Rework symmetry settings UI in both viewport menu and properties window
  • [Fill] Properly reorient normal textures when projecting in warp mode
  • Physical size displacement
  • [Displacement] Use physical size as displacement unit
  • Performance improvement
  • [Performance] Improve rendering of small brush strokes on big triangles
  • [Performance] Improve Shader compilation time
  • [Performance] Full Vulkan support for Windows and Linux
  • [Performance] Updated bakers with faster GPU rendering and support of AMD raytracing
  • [UI] Re-organize tools properties into groups and collapse some by default
  • [Engine] Update Substance Engine to version 9.2.5
  • [Substance] Expose resolution override for Substance resources in Tools and Fills
  • [Export] Update Mesh Maps export preset to export grayscale textures
  • Python
  • [Baking][Python] Indicate in changelog breaking changes following bakers update
  • [Python] Expose fill symmetry settings in Python
  • Content and new content
  • [Content] Add 75 new tool presets for the Ribbon tool
  • [Content] Update gradient builder resource to be compatible with Ribbon

Fixed:

  • [Crash] Loading another project while path snapping is enabled can crash
  • [Crash] Right click in Path panel with info from another session in clipboard can crash
  • [UI] Interface scrolls up in tool properties when creating a path
  • [UI] Mouse cursor disappear when path viewport visualization is hidden
  • [Path] Copy/pasting different Tool properties in Path panel lead to unstable properties
  • [Tool] Eraser and Smudge tool presets do not always update channel selection
  • [Tool] Painted value is gray but UI shows white after loading colored tool preset in mask
  • [Tool] Preset created from mask retains channels values loaded from another preset
  • [Substance] Normal color space override defined in graph is not taken into account
  • [Content] Default brush shape resource uses an outdated Substance

Known Issues:

  • Shader instance history not tracked properly
  • [Ribbon] Performance issue with UV Tiles
  • [Ribbon] Path can overlap itself unexpectedly after a corner in some cases
  • [Ribbon] Tangents create unwanted loop when point is moved closely to the path ends
  • [Crash][Ribbon] Creating very long texts in Ribbon can crash
  • [Tool] Material preview does not work when projection is used in a mask
  • [Baking] AO setting "Self Occlusion" is ignored with several Texture Sets and "match by name" enabled
  • [Baking] AO with normal has artifacts at edges because of missing padding
  • [Color Management] HDR color space conversions with ACE on Linux produce clamped colors
  • [Regression][UI] Right-click Menu is too small on HD screens
  • [Crash][Python] USD export triggered by TextureStateEvent
  • [Engine] Painting with Clone tool in normal channel shift colors incorrectly
  • [Python] Ghost widget appears deleted by script still functioning

Adobe, Inc.

Get help faster and easier

New user?