Custom Filters


Substance Custom Filters

You can import directly your Substance Filters made with Substance Designer via the Substance Designer icon on the Layer Stack controls.

How to create a Substance Filter?

Substance filters must be built in a specific way in Substance Designer to work correctly once imported in Substance Alchemist.

The input and output nodes of the filter must have the identifier or usage defined.

It is possible to use either the usage or the identifier (the usage has the priority).

Format

Export your filter as a Substance Archive file (.sbsar)

You can expose a parameter of your filter and parametrize your filter. See how-to here

Create a filter to modify images

Images nameUsage
Scan1scan1
Scan2scan2
......


Create a filter to modify channels


Channel nameUsage
Base Colorbasecolor 
Diffusediffuse
Specularspecular
Specular Levelspecularlevel
Metallicmetallic
Roughnessroughness
Glossinessglossiness
Normalnormal
Heightheight
Ambient OcclusionambientOcclusion
Opacityopacity



When creating a custom filter for Substance Alchemist, you need to add the following userdata in your Substance graph:

alchemist::type=filter;

If in your package, you have one graph to process images (scan1 to scanX) and one graph to process material (PBR channels), Substance Alchemist is able to choose the correct graph depending where the filter is inserted in the layer stack.

On your "image" graph, add the following userdata:

alchemist::type=filter;alchemist::variation::type=multi

On your "material" graph, add the following userdata:

alchemist::type=filter;alchemist::variation::type=material


Specific parameters

Specific parameters are globally managed by the application. It's a way to use global parameters of the application, the project, the layer stack in your custom filters.

Normal format

Control of the normal format over the application. Set to DirectX in Substance Alchemist 

parameter identifier: normalformat, normal_format, $normalformat, $normal_format 

Input Count

When you want to modify images (scan1 to scanX), you can use the number of images in the layer stack by using the Image Count parameter.

parameter identifier: input_count

parameter type: integer1

Material Input

If you want to display a material slot in the layer stack like the atlas scatter or the splatter:

  • Add a new set of Input nodes (Base Color, Normal, ... )
  • All Input nodes of the background (bottom material in the layer stack) should be in the Group Material1
  • All Input nodes of the first material you want to add on top should be in the Group Material2 and etcetera if you want several material slots.
  • Add a material input parameter:
    • parameter identifier: material_input
    • parameter type: integer1

Workflow Type

If you want to display/hide some parameters based on the workflow of your project (PBR Metalic/Roughness or PBR Specular/Glossiness), you can the Workflow Type parameter

parameter identifier: workflow_type

parameter_type: integer1, dropdown list

options:

  • 0: PBR Metallic/Roughness
  • 1: PBR Specular/Glossiness