User Guide Cancel

All Engine Params - Shader API | Substance 3D Painter

Last updated on Jul 13, 2023

Substance 3D Painter

Open app

Substance 3D home
Home
Getting Started
1. Getting Started overview
2. Activation and licenses
3. System requirements
4. Project creation
5. Export
  1. Export overview
  2. Export window
  3. Export presets
    1. Export presets overview
    2. Predefined presets
    3. Creating export presets
6. Glossary
7. Performance
Interface
1. Assets
2. Substance 3D Assets
3. Color picker
4. Display settings
5. History
6. Layer stack
7. Main menu
8. Project configuration
9. Properties
10. Settings
11. Shader settings
  1. Shader settings overview
  2. Updating a shader
12. Texture Set
13. Toolbars
14. Viewport
15. Miscellaneous
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
7. Presets
  1. Presets overview
  2. Creating and saving presets
  3. Creating particles presets
  4. Photoshop brush presets (ABR)
8. Dynamic strokes
9. Advanced channel painting
10. Vector graphic (.svg & .ai)
11. Text resource
Effects
1. Effects overview
2. Generator
3. Paint
4. Fill
5. Levels
6. Compare Mask
7. Filter
8. Anchor Point
Baking
Content
1. Creating custom effects
2. Importing assets
Features
1. Automatic UV Unwrapping
2. Physical size
3. Smart Materials and Masks
4. Subsurface Scattering
5. Dynamic Material Layering
6. UV Reprojection
7. UV Tiles
  1. UV Tiles overview
  2. Image Sequence
8. Color Management
9. Post Processing
10. Iray Renderer
11. Plugins
12. Sparse Virtual Textures
13. Custom Shaders
14. SpaceMouse® by 3Dconnexion
15. Universal Scene Description (USD)
16. Send to
Technical Support
1. Performance Guidelines
2. Configuring Pens and Tablets
3. Exporting the log file
4. Exporting a DXDiag
5. Technical issues
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
  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
Pipeline and integration
1. Installation and preferences
2. Configuration
3. Resource management
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
  4. Parameters - Shader API
  5. Shaders - Shader API
Release notes
1. Release notes overview
2. All Changes
3. Version 10.1
4. Version 10.0
5. Version 9.1
6. Old versions

All Engine Params - Shader API

Engine parameters examples

Texture parameters

Substance Painter uses a Sparse Virtual Texture (SVT) system to display textures in the viewport.

For more information about this system, go to the online documentation.

This system has repercussions on how to write shader code. We are providing helpers to simplify its use with the SamplerSparse structure and texture lookup functions (see lib-sparse.glsl).

Basic usage:

// Defines the SamplerSparse structure 
import lib-sparse.glsl 
 
//: param auto TEXTURE_TAG 
uniform SamplerSparse uniform_tex;   // Texture sampler and its information

Texture parameters allow to use 'or' operator to define a fallback:

//: param auto TEXTURE_TAG_1 or TEXTURE_TAG_2 
uniform SamplerSparse uniform_tex; // if TEXTURE_TAG_1 exists then TEXTURE_TAG_1 else TEXTURE_TAG_2

Where TEXTURE_TAG is one of the described tags below.

Document's channels tags

All these textures are premultiplied and dilated to avoid seams problems.

Texture set channels

channel_ambientocclusion channel_anisotropyangle channel_anisotropylevel channel_basecolor channel_blendingmask channel_diffuse channel_displacement channel_emissive channel_glossiness channel_height channel_ior channel_metallic channel_normal channel_opacity channel_reflection channel_roughness channel_scattering channel_specular channel_specularlevel channel_transmissive

User channels

channel_user0 channel_user1 channel_user2 channel_user3 channel_user4 channel_user5 channel_user6 channel_user7

Mesh maps

texture_ambientocclusion : Ambient Occlusion map
texture_curvature : Curvature map
texture_id : ID map
texture_normal : Tangent space normal map
texture_normal_ws : World space normal map
texture_position : World space position map
texture_thickness : Thickness map

Additional texture parameters

Basic usage:

//: param auto TEXTURE_TAG 
uniform sampler2D uniform_tex;   // The texture itself 
 
//: param auto TEXTURE_TAG_size 
uniform vec4 uniform_tex_size;   // The size of the texture (width, height, 1/width, 1/height)

Texture parameters allow to use 'or' operator to define a fallback:

//: param auto TEXTURE_TAG_1 or TEXTURE_TAG_2 
uniform sampler2D uniform_tex; // if TEXTURE_TAG_1 exists then TEXTURE_TAG_1 else TEXTURE_TAG_2 
 
//: param auto TEX_TAG_1_size or TEX_TAG_2_size 
uniform vec4 uniform_tex_size; // if TEX_TAG_1 exists then TEX_TAG_1_size else TEX_TAG_2_size

Where TEXTURE_TAG is one of the described tags below.

texture_blue_noise : A blue noise texture
texture_environment : Environment map, mip-mapped, use lib-env.glsl to use this one

Other parameters

aspect_ratio : a float containing the viewport width / height ratio

//: param auto aspect_ratio 
uniform float uniform_aspect_ratio;

camera_view_matrix : a mat4 representing the transformation from world space to camera space

//: param auto camera_view_matrix 
uniform mat4 uniform_camera_view_matrix;

camera_view_matrix_it : inverse transpose version of camera_view_matrix

//: param auto camera_view_matrix_it 
uniform mat4 uniform_camera_view_matrix_it;

camera_vp_matrix_inverse : inverse of projection * camera_view_matrix matrix

//: param auto camera_vp_matrix_inverse 
uniform mat4 uniform_camera_vp_matrix_inverse;

environment_exposure : a float representing the envmap's exposure

//: param auto environment_exposure 
uniform float uniform_environment_exposure;

environment_max_lod : a float representing the envmap's depth of mip-map pyramid

//: param auto environment_max_lod 
uniform float uniform_max_lod;

environment_rotation : a float representing the envmap's rotation around up axis
the value is in the range [0,1] and should be maped to the range [0, 2*pi]

//: param auto environment_rotation 
uniform float uniform_environment_rotation;

facing : an integer indicating rendered faces (-1: back faces, 0: undefined, 1: front faces)
value of 0 means you can safely rely on glsl built-in variable gl_FrontFacing

//: param auto facing 
uniform int uniform_facing;

fovy : a float representing the camera field of view along Y axis

//: param auto fovy 
uniform float uniform_fovy;

is_2d_view : a bool indicating whether the rendering is performed for 2D view or not

//: param auto is_2d_view 
uniform bool uniform_2d_view;

is_perspective_projection : a bool indicating whether the projection is perspective or orthographic

//: param auto is_perspective_projection 
uniform bool uniform_perspective_projection;

main_light : a vec4 indicating the position of the main light in the environment

//: param auto main_light 
uniform vec4 uniform_main_light;

mvp_matrix : a mat4 representing the model view projection matrix

//: param auto mvp_matrix 
uniform mat4 uniform_mvp_matrix;

scene_original_radius : a float representing the radius of the scene's bounding sphere before its normalization

//: param auto scene_original_radius 
uniform float uniform_scene_original_radius;

screen_size : a vec4 containing screen size data (width, height, 1/width, 1/height)

//: param auto screen_size 
uniform vec4 uniform_screen_size;

world_camera_direction : a vec3 representing the world camera orientation

//: param auto world_camera_direction 
uniform vec3 uniform_world_camera_direction;

world_eye_position : a vec3 representing the world eye position

//: param auto world_eye_position 
uniform vec3 uniform_world_eye_position;

Get help faster and easier

New user?