User Guide Cancel

Version 4.0 | Substance 3D Sampler

  1. Substance 3D home
  2. Home
  3. Getting Started
    1. Getting Started overview
    2. Activation and licenses
    3. System requirements
    4. Shortcuts
    5. Importing Resources
    6. Report a bug
    7. Project Management
    8. Export
      1. Export overview
      2. Export Window
      3. Default Presets
        1. Default Presets overview
        2. Arnold 5
        3. Blender Cycles/Eevee
        4. Corona Renderer
        5. Enscape - Revit
        6. Keyshot9+
        7. Lens Studio
        8. Spark AR Studio
        9. Unity HDRP Standard
        10. Unity HDRP Specular
        11. Unity Standard
        12. Unity Specular
        13. Unreal Engine 4
        14. Redshift
        15. V-Ray Next
      4. Managing custom presets
      5. Managing Presets
  4. Interface
    1. Interface overview
    2. The Home Screen
    3. 2D and 3D Viewport
    4. Sidebars
    5. Panels
      1. Panels overview
      2. Project panel
      3. Assets panel
      4. Layers panel
      5. Properties panel
      6. Viewer Settings panel
      7. Shader Settings panel
      8. Channel Settings panel
      9. Metadata panel
      10. Export panel
      11. Physical Size Panel
      12. Exposed Parameters Panel
      13. Resources
    6. Tools and Widgets
      1. Tools and Widgets overview
      2. Sliders
      3. Color Picker
    7. Preferences
      1. Preferences overview
      2. Normal Format
      3. Layer Resolution
  5. Filters
    1. Filters overview
    2. Custom Filters
    3. Compound Filters
    4. Generators
      1. Generators overview
      2. Atlas Scatter
      3. Brickwall
      4. Cloth Weave
      5. Decal
      6. Embossing
      7. Embroidery
      8. Floor Tiles
      9. Gravel
      10. Panel
      11. Parquet
      12. Pattern
      13. Pavement
      14. Perforate
      15. Quilt Stitch
      16. Splatter
      17. Stonewall
      18. Surface Relief
      19. Weave
    5. Adjustments
      1. Adjustments overview
      2. Blur
      3. Brightness/Contrast
      4. Colorize
      5. Color Replace
      6. Color Variation
      7. Equalize
      8. Fill
      9. Hue/Saturation
      10. Invert
      11. Sharpen
      12. Vibrance
    6. Tools
      1. Tools overview
      2. Atlas Creator
      3. Atlas Splitter
      4. Channels Generation
      5. Channel Switch
      6. Clone Stamp
      7. Crop tool
      8. Delight (AI Powered)
      9. Height to AO
      10. Height to Normal
      11. Image To Material
      12. Make it Tile
      13. Match
      14. Multiangle To Material
      15. Normal to Height
      16. Paint Wrap *missing*
      17. PBR Validate
      18. Perspective Correction
      19. Tiling
      20. Transform
      21. Warp
      22. Warp Transform
      23. Upscale
    7. HDRI Tools
      1. HDRI Tools overview
      2. Color Temperature Adjustment
      3. Exposure
      4. Exposure Preview
      5. HDR Merge
      6. Line Light
      7. Nadir Extract
      8. Nadir Patch
      9. Panorama Patch
      10. Plane Light
      11. Shape Light
      12. Sphere Light
      13. Straighten Horizon
    8. Wear and Finish
      1. Wear and Finish overview
      2. Corrode
      3. Cracks
      4. Dirt
      5. Discarded Gums
      6. Dust
      7. Erode
      8. Metal Finish
      9. Moss
      10. Oxidate
      11. Paint
      12. Rust
      13. Scratch
      14. Snow
      15. Stylization
      16. Water
      17. Varnish
  6. Technical Support
    1. Technical Support overview
    2. Exporting the log file
    3. Configuration
      1. Configuration overview
      2. Retrieving the installation path
      3. Update Checker
      4. NVIDIA Driver Settings
      5. 3D Capture set-up on Linux  
    4. Technical Issues
      1. Technical Issues overview
    5. Data or project issues
      1. Data or project issues overview
      2. Import Substance Alchemist projects in Substance 3D Sampler
    6. Filter issues
      1. Filter issues overview
      2. Image to Material and Delighter are missing
      3. Image to Material visual artefacts
    7. Interface issues
      1. Interface issues overview
      2. Fonts are not displayed correctly
      3. Main interface is transparent
    8. Performance issues
      1. Performance issues overview
      2. Color picker takes long time to open the first time
      3. Interface lags when interacting with the layer stack or other elements
    9. Stability issues
      1. Stability issues overview
      2. Crash when exporting a material
      3. Crash when using the Image to Material or Delighter
    10. Startup issues
      1. Startup issues overview
      2. Application doesn't start on Linux
      3. Crash at start up - Old OBS version
  7. Features and workflows
    1. Features and workflows overview
    2. 3D Capture
    3. Export parametric assets
    4. End to end Physical Size Workflow
    5. Generative Workflow
    6. Texture Import
    7. Texture Generators
    8. Use As Bitmap
    9. Adobe Standard Material
  8. Pipeline and integrations
    1. Pipeline and integrations overview
    2. Environment variables
    3. Substance Send-to
    4. HP Z Captis support
      1. HP Z Captis support overview
      2. Your first capture, step by step
      3. System requirements to use the HP Z Captis device
      4. FAQ for HP Z support in Sampler
      5. Known issues and limitations
  9. Scripting and Development
    1. Scripting and Development overview
    2. Manage installed plugins and scripts
    3. Create a Plugin with Python and QML
    4. Create a Script with Python
      1. Create a Script with Python overview
      2. Example Scripts
  10. 3D Capture
    1. 3D Capture equipment
    2. Camera settings - Exposure
    3. Camera settings - Focus
    4. 3D Capture lighting
    5. Cross-polarizing for 3D Capture
    6. Processing advanced 3D Captures
    7. Editing 3D Captured meshes
  11. Release Notes
    1. Release Notes overview
    2. All Changes
    3. Beta
    4. Version 4.5
    5. Version 4.4
    6. Version 4.3
    7. Version 4.2
    8. Version 4.1
    9. Version 4.0
    10. Version 3.4
    11. Version 3.3
    12. Old Versions
      1. Version 3.2
      2. Version 3.1
      3. Version 3.0
      4. Version 2020.3 (2.3)
      5. Version 2020.2 (2.2)
      6. Version 2020.1 (2.1)
      7. Version 2019.1
      8. Version 0.8.1
      9. Version 0.8.0
      10. Version 0.7.0
      11. Version 0.6.1
      12. 0.6.0
      13. 0.5.4
      14. 0.5.3
      15. 0.5.2
      16. 0.5.1
      17. 0.5.0
  12. FAQ
    1. FAQ  Overview

Version 4.0

With Substance 3D Sampler 4.0, you can use real-world images to create 3D objects with automatic subject masking, texture mapping, and geometry decimation. This version introduces some UX improvements as new possibilities in the Python API.

Release date: 31 January, 2023

3D Capture

With Substance 3D Sampler 4.0, you can now create 3D objects from images.

We have integrated photogrammetry capabilities. Photogrammetry is the technical process of taking measurements from images. It is how Sampler creates 3D meshes from a series of photographs.

All you need to start is a series of photos which capture the visible surfaces of an object - a smart phone or DLSR camera works great.

Discover the step-by-step workflow here.

Highlights

Auto-masking

Remove the background of the object you wish to 3D capture. Create an auto-generated mask of the object after importing your images via the Mask tab.

Using masks has many advantages. It allows to detect features and reconstruct only non-masked areas.

Define your reconstruction area

Toggle Region of interest to activate a bounding box after aligning your images. Set and align the precise area you want to reconstruct.

Connected post-processing

Once your 3D object is reconstructed, optimize the result with automatic decimation, UV unwrapping and baking.

The post-processing helps you to adapt and optimize your mesh and textures to your needs and how you want to use it.

The result of the reconstruction can generate a mesh with millions of polygons and up to 16K textures. This often won’t be optimized for rendering, real-time or AR experience.

The post-processing step chains 4 steps automatically:

  • Decimation
  • UV unwrap
  • Reprojection
  • Baking

Export to major file formats

Export your reconstructed 3D objects in all standard file formats so you can use them wherever you need.

Viewport

2D and 3D viewports can be resized, swapped and stacked vertically.

Scripting

We splitted the export function into 4:

  • export materials: export_material
  • export environment lights: export_environment_light
  • export mesh with or without textures: export_mesh or export_3d_object

We added a new function to import textures with a specific usage: import_textures

Sampler will now load at startup script and plugins stored on paths defined by two environment variables:

  • SAMPLER_PLUGIN_PATH
  • SAMPLER_SCRIPT_PATH

Tutorials

Release note

  1. 0.0 Banana

    (Released 31 January, 2022)

    Added

  • [3D Capture] Create 3D objects from images
  • [3D Capture] Dedicated 3D Capture wizard
  • [3D Capture] Import or generate black and white masks on your dataset
  • [3D Capture] Alignment result - view all matched features as a point cloud
  • [3D Capture] Alignment result - view and interact with cameras associated with each aligned photo
  • [3D Capture] Define the reconstruction area with a bounding box widget
  • [3D Capture] Scale, translate, and rotate on all axes the bounding box widget
  • [3D Capture] Define the geometry precision for the reconstructed mesh
  • [3D Capture] Optimize your mesh and textures by creating a new version
  • [3D Capture] Each of the versions is automatically decimated to the target faces number set
  • [3D Capture] The post-process step automatically unwraps, re-projects textures, and then bakes the normal height and AO information from the high-poly mesh
  • [3D Capture] Add the original result or a version to the Sampler project
  • [3D Capture] New Mesh Post-Process layer to automatically decimate, unwrap, reproject textures, and bake details of the underlying mesh layer
  • [3D Capture] New Mesh Transform layer to scale, rotate, or translate the underlying mesh layer
  • [Export] New Export window
  • [Export] Dedicated settings and UI depending on the asset type (material, environment light, mesh)
  • [Export] Export the mesh as USD, USDA, USDZ, glTF, glb, obj, fbx, stl
  • [Export] Define the material type when exporting Substance files (SBSAR, SBS)
  • [UI] Move cache settings to a new tab in the Preferences popup
  • [Application] 2D and 3D viewports can now be resized, swapped, and stacked vertically
  • [Application] New SAMPLER_RESOURCES_PATH environment variable to add extra starter assets
  • [Scripting] Added SAMPLER_PLUGIN_PATH and SAMPLER_SCRIPT_PATH environment variables to import plugins and scripts at startup
  • [Scripting] Added export functions for materials, environment lights, and 3d objects
  • [Scripting] Added identifier, default value, min and max values, labels, and enum values to parameters
  • [Scripting] Added import_textures function to enter a customized usage while importing images

Fixed

  • [Application] Crash when opening a recent project and saving in confirmation dialog
  • [Application] File dialog prevents opening .ssa files
  • [Application] File dialogs can appear on a background window on macOS
  • [Application] Potential crash when opening 3.2 projects
  • [Application] Selecting a file closes the File dialog before displaying warnings
  • [Exposed Parameters] Exporting parametric environment lights does not work
  • [Layers] "Click here to browse" link in layer stack doesn't work anymore
  • [Layers] Painting several images within the same layer sometimes does not work
  • [Layers] Setting an image in the layer properties does not update the image picker thumbnail
  • [Layers] Tweaking a Sampler asset added as a layer does not work
  • [Project] Unwanted asset update when opening a project
  • [Scripting] Browse to plugin folder sometimes fails on Windows
  • [Scripting] Crash when using 'open_project()' in a Python script
  • [Scripting] JPEG export is missing from the API
  • [Scripting] The log panel is not read-only
  • [Scripting] image_picker parameter value does not work
  • [UI] Missing asset icon for environment lights in the Project panel
  • [UI] Send to Designer Format Dropdown in the Preferences popup can be empty
  • [UI] Some buttons have an incorrect style
  • [UI] The label overlaps the buttons in Button Group widgets
  • [UI] Tooltip position is wrong for "Tools" in Set the physical size menu
  • [UI] When changing language, File menu is misaligned

Known issues

  • [3D Capture] When using masks, the texture projection may be broken
  • [3D Capture] Small artefacts may appear on your object if your scale in the Mesh transform is too small
  • [3D Capture] The exported mesh may be really small. Reset the scale of the Mesh transform and re-export
  • [Color Picker] Picking a color on a second monitor with a different resolution may not work
  • [Content] Shape light widget is not working in spherical projection mode
  • [Interoperability] Material with displacement sent to Stager will lose displacement controls

Get help faster and easier

New user?