User Guide Cancel

Lib SSS - 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

Lib SSS - Shader API

lib-sss.glsl

Public Functions: getSSSCoefficients

Import from library

import lib-sampler.glsl

The scalar SSS coefficient texture

//: param auto channel_scattering 
uniform SamplerSparse sss_tex; 
 
//: param auto scene_original_radius 
uniform float sssSceneScale; 
 
//: param custom { 
//:   "label": "Enable", 
//:   "default": true, 
//:   "group": "Subsurface Scattering Parameters", 
//:   "description": "<html><head/><body><p>Enable the Subsurface Scattering. It needs to be activated in the Display Settings and a Scattering channel needs to be present for these parameters to have an effect.</p></body></html>" 
//: } 
uniform bool sssEnabled;

Select whether the light penetrates straight through the material (translucent) or is diffused before starting to scatter (skin).

//: param custom { 
//:   "default": 1, 
//:   "label": "Scattering Type", 
//:   "widget": "combobox", 
//:   "values": { 
//:     "Translucent": 0, 
//:     "Skin": 1 
//:   }, 
//:   "group": "Subsurface Scattering Parameters", 
//:   "description": "<html><head/><body><p>Skin or Translucent/Generic. It needs to be activated in the Display Settings and a Scattering channel needs to be present for these parameters to have an effect.</p></body></html>" 
//: } 
uniform int sssType;

Global scale to the subsurface scattering effect

//: param custom { 
//:   "default": 0.5, 
//:   "label": "Scale", 
//:   "min": 0.01, 
//:   "max": 1.0, 
//:   "group": "Subsurface Scattering Parameters", 
//:   "description": "<html><head/><body><p>Controls the radius/depth of the light absorption in the material. It needs to be activated in the Display Settings and a Scattering channel needs to be present for these parameters to have an effect.</p></body></html>" 
//: } 
uniform float sssScale;

Wavelength dependency of the SSS of the material

//: param custom { 
//:   "default": [0.701, 0.301, 0.305], 
//:   "label": "Color", 
//:   "widget": "color", 
//:   "group": "Subsurface Scattering Parameters", 
//:   "description": "<html><head/><body><p>The color of light when absorbed by the material. It needs to be activated in the Display Settings and a Scattering channel needs to be present for these parameters to have an effect.</p></body></html>" 
//: } 
uniform vec3 sssColor;

Return the material SSS coefficients

vec4 getSSSCoefficients(float scattering) { 
  if (sssEnabled) { 
    vec3 sss = sssScale / sssSceneScale * scattering * sssColor; 
    return vec4(sss, sss == vec3(0.0) ? 0.0 : 1.0); 
  } 
  return vec4(0.0); 
} 
vec4 getSSSCoefficients(SparseCoord coord) { 
  if (sssEnabled) { 
    return getSSSCoefficients(getScattering(sss_tex, coord)); 
  } 
  return vec4(0.0); 
}

Get help faster and easier

New user?

Lib SSS - Shader API | Substance 3D Painter

Lib SSS - Shader API

lib-sss.glsl

Get help faster and easier

Ask the Community

Contact Us