User Guide Cancel

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

Substance Painter 2018.2 adds long awaited features such as Subsurface Scattering painting that make texturing even easier than before.

Release date : 2 August 2018

Major Features

Subsurface scattering

Subsurface scattering is now supported in the realtime viewport and with the Iray renderer.
Subsurface scattering is a mechanism of light when penetrating an object or a surface. Instead of being reflected, like with metallic surfaces, a portion of the light is absorbed by the material and then scattered inside. Many materials in real life have subsurface scattering such as skin or wax.

Our Subsurface effect implementation match very closely both real-time implementations from other game engines as well as other offline renderers. Making it very easy to author scattering textures to use in other applications.

Above is an example with the well know Digital Emily 2 asset. Thanks to the USC Institute for Creative Technologies and members of the Wikihuman project for allowing us to demonstrate our renders with the Digital Emily 2 assets.
(Please note this comparison was made under similar but not exact lighting conditions which may explains visual differences.)

To add Subsurface Scattering in a project follow these few steps :

  1. Go to the Display Settings window and activate the Subsurface Scattering setting.
  2. Add a "Scattering" channel in the current texture set
  3. Use a fill layer or paint in white in the new channel to reveal the subsurface effect in the viewport.

A more detailed procedure can be found in the Subsurface Scattering documentation.

Note:

In order to support Subsurface Scattering in the realtime viewport the shaders in the projects have to be updated.
For custom shaders please refer to the documentation available in the help menu for to know what has changed in the shader API.

Manipulators for fill layers

Fill layers controls have been improved to offer manipulators. It is now easier to precisely place and control fill projections.

When using the UV projection a manipulator will appear in the 2D View :

  • Clicking outside the manipulator will rotate it.

  • Clicking on the square at the borders will scale/resize it.

  • Clicking inside the manipulator will translate it.

  • Use CTRL to affect multiple corner in symmetry.

  • Use SHIFT to constraint a transformation (translate, rotation or scale).

When using the Tri-Planar projection a manipulator will appear in the 3D View :

  • The dotted cube represent the global projection

  • Use the W, E or R keyboard shortcut to switch between the Translate, Rotate and Scale mode.

  • Use the T keyboard shortcut to switch between Local and World orientation for the manipulator.

  • Use SHIFT to constraint the transformation.

  • The Tri-Planar cube projection can also be modified in the advanced fill layer properties :

The contextual toolbar at the top of the viewport will also adapt depending of the current projection mode, offering additional tools and controls :

For more details, see the Fill Layer documentation.

Non-square and non-tilling support for Stencil and Projection tool

The stencil parameter and projection tool have been improved to support non-square resolutions and non-tilling behaviors.
The default parameter is now set to non-tilling by default. This parameter can be changed in the tool properties :

The tilling mode can be set as follow :

  • No Tiling (default)
  • Horizontal Tiling
  • Vertical Tiling
  • H and V Tiling (old behavior)

This new parameter can be saved in a tool or brush preset, making it easy to share with custom content.

Note:
  • The projection ratio will also adapt with Substance files that output non-square resolutions. The ratio will be computed directly from the output node.
  • With the projection tool if multiple channels have different ratios, the first ratio found will be applied to all the other channels.

Camera import and management

It is now possible to import custom cameras inside Substance Painter alongside the mesh import.
Cameras can be selected to look through them in the 3D viewport and used to render in Iray.

For more details, see the Camera Management documentation.

To import cameras into a project :

  1. Export the mesh for the project with cameras in the same file (with a supported format such as FBX, Alembic or glTF)

  2. Select the "import cameras" settings in the new project window (or project configuration).

  3. Switch to the desired camera with the dropdown in the viewport or by using the settings in the Display Settings.

The Camera Settings in the Display Settings window have been extended to control the Camera's properties.
It is possible to switch between cameras, see its ratio and lock its properties to avoid modifying it. A restore button can be used to revert the camera to its initial values.

The camera frame (and it's gate) is also taken into account, making it possible to view and paint via a very specific point of view. The frame and gate are displayed over the 3D Viewport and its opacity can be controlled in the Viewport Settings from the Display Settings window :

Layer stack behavior improvements

  • Drag and Drop Materials and Smart Materials onto the ID map :
    The drag and drop of content from the shelf into the viewport has been improved. By pressing CTRL while drag and dropping a material it is now possible to choose the ID color that will be used as a mask.
    A black mask with a color selection effect will be added to the new layer created in the layer stack. If the same material is drag and dropped onto an other ID color, the already existing layer will be updated and the ID colors will be combined..

  • Layer stack drag and drop scroll :
    Dragging layers around the layer stack is now with a small window.
    When a resource or a layer is dragged near the borders of the layer stack window, it will automatically start to scroll its content.

glTF and Alembic mesh import

New file formats are now supported for importing meshes and creating new projects :

  • glTF : This format was already available when exporting textures and can now be used during the import. If a glTF file contains textures they will be imported and placed inside the layer stack (for the metallic/roughness workflow).
  • Alembic : This format is widely used in the VFX / Animation industry to transfert meshes.
Note:

Substance Painter doesn't offer a way to control which frame of animation should be imported at the moment.
This means that when exporting an Alembic file the frame of reference to be used for painting on the asset has to be already set.

Substance integration improvements

The Substance integration inside Substance Painter has been improved with long awaited requests :

  • Visible If :
    The "Visible if" is a great feature of the Substance file format which allows to hide parameters based on conditions.
    This feature provides a more clear list of parameters and contextual settings, giving overall more easy to use materials and filters.
    For more details see the Substance Designer documentation.

  • Substance Presets
    Substance presets are an easy way to provide advanced tweaks and variations of materials. Many materials on Substance Source have presets, so give it a try !
    If a Substance file contains one or more presets, a new dropdown in the parameter list will be available. Select which preset to apply to update the parameters.

  • Substance Attributes
    Substance attributes are now displayed in the interface, making it easier to retrieve information about a specific file.
    Attributes can be viewed in two different location : above the parameters in the properties window or by right-clicking on an asset in the shelf.

New sample project "Jade Toad"

A new sample project named "JadeToad" is now included with Substance Painter. This sample project has the Subsurface Scattering effect enabled by default.
To find the project, use the File > Open Sample... menu entry.

Release Notes

2018.2.3

(Released September 25, 2018)

Fixed:

  • [2D View] 2D View is broken with some meshes when creating a new project
  • [Crash] Switching from UV projection to tri-planar projection leads to a crash
  • [RayCollider] Multiple crashes due to "RayCollider"
  • [Tool] Switching layers lose the modified brush properties
  • Brush settings are reseted when switching to the eraser

Known issues:

  • Computation freeze on AMD VEGA GPUs
  • Huion tablet issue with shortcuts on Windows OS

2018.2.2

(Released September 11, 2018)

Added:

  • Summary: Hotfix with content update, new scripting functionalities and being able to disable the auto update
  • [Content][Shelf] Add a Skin shelf preset
  • [Content][shelf] Conversion of 19 skin normals into materials for subsurface scattering
  • [Scripting] Create a project template from an open project
  • [Scripting] Get/Set export settings of an opened project
  • [Updates] Be able to disable the auto update pop-up from settings and environment variable
  • [Updates] Have a not display until next version on the maintenance outdated pop-up

Fixed:

  • [Camera] Wrong zoom by switching from orthographic to perspective
  • [Display] Some maps are displayed in linear instead of sRGB
  • [Viewports] Mesh focus does not behave properly
  • [2D View] Project with broken camera has disappearing UVs Shells
  • [SSS][Tooltip] subsurface scattering tooltips appear in the log
  • Some projects cannot be opened in 2018.2 and error message can't save a null substance package
  • [Mask] Paint tool color can be stuck in some cases when working in a mask
  • [Material] Maps not appearing in specific situations
  • [Proj][Tools] Manipulator active with a generator
  • [Substance] Missing Substance groups of parameters
  • [Scripting] Incorrect software name in documentation
  • [UDIMs] No information in log about UVs shells on multiple UVs tiles

Known issues:

  • Computation freeze on AMD VEGA GPUs
  • Huion tablet issue with shortcuts on Windows OS

2018.2.1

(Released August 3, 2018)

Fixed:

  • Missing subsurface scattering shader parameters from upgrading projects

Known Issues:

  • Computation freeze on AMD VEGA GPUs
  • Huion tablet issue with shortcuts on Windows OS

2018.2

(Released August 2, 2018)

Added:

  • Summary: Summer release, subsurface scattering Support, projection and fill improvements, camera import and selection, Alembic/glTF support, drag and drop on ID map, improved Substance format support and new content
  • [SSS][Viewport][Iray] Generic subsurface scattering
  • [SSS] Sync MDL and subsurface scattering parameters
  • [SSS] Added a new grayscale channel named "Scattering"
  • [SSS][Shader Settings] Scattering type parameter for subsurface scattering (skin or translucent)
  • [SSS][Shader Settings] Scattering scale parameter for subsurface scattering
  • [SSS][Shader Settings] Scattering color parameter for subsurface scattering
  • [SSS][Display Settings] Scattering Sample count for subsurface scattering
  • [Shader][Iray] Integrate subsurface scattering MDL for Iray
  • [Shader] Shader update via the resource updater
  • [Shader] Update change log API and documentation
  • [Tool Properties][Proj] New parameters for the triplanar projection
  • [Viewport][Proj] Control Fill Layer properties in 3D view directly with manipulators (triplanar projection)
  • [Shortcuts][Proj] New shortcuts Q, W, E, R, T for triplanar projection manipulators
  • [Viewport][Proj] Control Fill Layer properties in 2D view directly with manipulators (UV projection)
  • [Shortcuts][Proj] New shortcut Q for UV projection manipulators
  • [Contextual Toolbar][Proj] Control triplanar projection manipulators
  • [Contextual Toolbar][Proj] Control UV projection manipulators
  • [Tool Properties] Disable texture tiling with projection and Stencil tool
  • [Stencil] Use non-squared images with the projection tool/stencil
  • [Stencil] Allow control of tiling mode in Properties window
  • [Stencil] Zoom is not centered on a non-tiling stencil
  • [Cameras] Import cameras from Maya, Max, Blender, Modo, DAE
  • [Cameras][Viewport] Select and control imported cameras in viewport
  • [Cameras][Iray] Select and control imported cameras in Iray
  • [Cameras][UI][New project][Project configuration] "Import cameras" is checked by default
  • [Cameras][Shortcuts] Add shortcuts "<" and ">" to switch between cameras
  • [Cameras][Viewport] Add frame in viewport
  • [Cameras][Viewport Settings] Control of frame opacity
  • [Cameras][Camera Settings] Maximum focal length at 500mm
  • [Cameras][Camera Settings] Expose ratio
  • [Cameras][Camera Settings] Add a lock option
  • [Cameras][Camera Settings] Add a restore option
  • [Cameras][Camera Settings] Add focus distance attribute
  • [glTF] Import of a glTF file
  • [glTF] Import ambient occlusion map
  • [Alembic] Import Alembic 1 frame with static geometry
  • [Shelf] Drag and drop materials directly onto the mesh using ID maps with a modifier (CTRL/Command)
  • [Layer Stack] Automatic ID mask creation with drag and drop of materials on mesh with ID maps
  • [Layer Stack] Automatic scroll of layers with drag and drop across the layer stack
  • [UI][Tool Properties] Expose Substance's preset
  • [UI][Help menu] Improvement of the Help menu
  • [UI][New Project][Project Configuration] Reorganization of the window
  • [UI][New Project][Project Configuration] Replace "Mesh" term by "File"
  • [UI][Substance] Display Substance attributes in UI
  • [Shortcuts] "F4" switches between 2D and 3D view
  • [Shortcuts] New shortcuts for toggle stencil "N" and quick mask "U"
  • [Substance integration] Take into account 'visible if' statements in the Substance parameters
  • [Viewport] Shadows not forced to be computed after camera move
  • [Content] Update MeetMat with imported cameras
  • [Content] Add a sample with subsurface scattering enabled - JadeToad
  • [Content] Add a new PBR project template with subsurface scattering enabled
  • [Content] Updated export presets to add new Scattering channel
  • [Content][Shelf] Added subsurface scattering support for: pbr-metal-rough, pbr-metal-rough-alpha-test, pbr-coated, pbr-spec-gloss
  • [Content][Shelf] Added Scattering channel to 5 smart materials (marbles and skins)
  • [Content][Shelf] 1 new jade Material
  • [Content][Shelf] 1 new wax Material

Fixed:

  • [CMD] Different results using same command line with different versions
  • [TDR] If TdrLevel is set up you don't have any errors in your log
  • [Baker] Ambient occlusion map is flipped
  • [ID Map] Crashing when picking outside of 0-1 range
  • [Iray] Crash when switching texture sets and going back to Paint mode
  • [Viewport] Sync drop areas between viewports for drag and drop
  • [Engine] Moire artifact when tiling fill layers or painting small brush
  • [License] License service bad software version check
  • [License] Rework the way we handle authentication
  • [API] Call the `onNewProjectCreated` scripting API event even when creating with a template
  • [Shader] Compiled shader is not loaded from cache when shader file doesn't compile
  • [Shelf] Exporting HDR file from the shelf will output a file with clamped values
  • [Export] EXR export clamps RGB color values between 0-1
  • [Content] Procedural noise "3D Perlin Noise Fractal" is pixelated

Known Issues:

  • Computation freeze on AMD VEGA GPUs
  • Huion tablet issue with shortcuts on Windows OS

Get help faster and easier

New user?