User Guide Cancel

All Custom 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 Custom Params - Shader API

Custom parameters sample shader

Please note that all custom tweaks need at least a default value.

Group your parameters by adding a group value.

Hide a parameter in the UI by setting a visible value to false .

Add a tooltip on the parameter by setting a description value.

Color parameters

//: param custom { "default": 0, "label": "Color RGB", "widget": "color" } 
uniform vec3 u_color_float3; 
//: param custom { "default": 1, "label": "Color RGBA", "widget": "color" } 
uniform vec4 u_color_float4;

Spinboxes parameters

//: param custom { "default": 0, "label": "Int spinbox" } 
uniform int u_spin_int1; 
//: param custom { "default": 0, "label": "Int2 spinbox" } 
uniform ivec2 u_spin_int2; 
//: param custom { "default": 0, "label": "Int3 spinbox" } 
uniform ivec3 u_spin_int3; 
//: param custom { "default": 0, "label": "Int4 spinbox" } 
uniform ivec4 u_spin_int4; 
//: param custom { "default": 0, "label": "Float spinbox" } 
uniform float u_spin_float1; 
//: param custom { "default": 0, "label": "Float2 spinbox" } 
uniform vec2 u_spin_float2; 
//: param custom { "default": 0, "label": "Float3 spinbox" } 
uniform vec3 u_spin_float3; 
//: param custom { "default": 0, "label": "Float4 spinbox" } 
uniform vec4 u_spin_float4;

Slider parameters

//: param custom { "default": 0, "label": "Int slider", "min": 0, "max": 10 } 
uniform int u_slider_int1; 
//: param custom { "default": 0, "label": "Int slider", "min": 0, "max": 10, "step": 2 } 
uniform int u_slider_int1_stepped; 
//: param custom { "default": 0, "label": "Int2 slider", "min": 0, "max": 10 } 
uniform ivec2 u_slider_int2; 
//: param custom { "default": 0, "label": "Int3 slider", "min": 0, "max": 10 } 
uniform ivec3 u_slider_int3; 
//: param custom { "default": 0, "label": "Int4 slider", "min": 0, "max": 10 } 
uniform ivec4 u_slider_int4; 
//: param custom { "default": 0, "label": "Float slider", "min": 0.0, "max": 1.0 } 
uniform float u_slider_float1; 
//: param custom { "default": 0, "label": "Float2 slider", "min": 0.0, "max": 1.0 } 
uniform vec2 u_slider_float2; 
//: param custom { "default": [0.2, 0.5, 0.8], "label": "Float3 slider", "min": 0.0, "max": 1.0 } 
uniform vec3 u_slider_float3; 
//: param custom { "default": 0, "label": "Float4 slider", "min": 0.0, "max": 1.0, "step": 0.02 } 
uniform vec4 u_slider_float4_stepped;

Bool parameters

//: param custom { "default": false, "label": "Boolean" } 
uniform bool u_bool;

Sampler parameters

The texture is defined by its name in the shelf and must be in the Textures or Environments category.

//: param custom { "default": "", "default_color": [1.0, 1.0, 0.0, 1.0], "label": "Texture" } 
uniform sampler2D u_sampler1; 
//: param custom { "default": "texture_name", "label": "Texture" } 
uniform sampler2D u_sampler2; 
//: param custom { "default": "texture_name", "label": "Texture", "usage": "texture" } 
uniform sampler2D u_sampler3; 
//: param custom { "default": "texture_name", "label": "Texture", "usage": "environment" } 
uniform sampler2D u_sampler4;

Combobox parameters

//: param custom { 
//:   "default": -1, 
//:   "label": "Combobox", 
//:   "widget": "combobox", 
//:   "values": { 
//:     "Value -1": -1, 
//:     "Value 0": 0, 
//:     "Value 10": 10 
//:   } 
//: } 
uniform int u_combobox;

Shader entry point

vec4 shade(V2F inputs) 
{ 
  // We simply return the value of the RGB color picker 
  return vec4(u_color_float3, 1.0); 
}

Adobe

Get help faster and easier

New user?