ShaderTweaks

Makes modifications to shader parameter values.

Shader parameters are identified by name, and can optionally be filtered by the name and type of the shader they belong to. Examples :

intensity : Chooses a parameter called intensity on the final shader in the network. Particularly convenient for lights, which often include only one shader.
diffuseTexture.filename: Chooses a parameter called filename on a shader called diffuseTexture.
dustLayer*.alpha : Chooses all parameters called alpha, on shaders whose name matches dustLayer* (any of Gaffer’s other standard wildcards may also be used to match the shader name).
{shaderType=image}.mipmap_bias : Chooses all parameters called mipmap_bias on shaders whose type is image.
diffuseTexture*{shaderType=image}.mipmap_bias : Chooses all parameters called mipmap_bias on shaders whose type is image and whose name matches diffuseTexture*.

Tip

Parameters can be dragged from the SceneInspector and dropped into the text field to fill the name automatically.

user

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

enabled

The on/off state of the node. When it is off, the node outputs the input scene unchanged.

filter

The filter used to control which parts of the scene are processed. A Filter node should be connected here.

shader

The type of shader to modify. This is actually the name of an attribute which contains the shader network.

ignoreMissing

Ignores tweaks targeting missing parameters. When off, missing parameters cause the node to error.

tweaks

The tweaks to be made to the parameters of the shader. Arbitrary numbers of user defined tweaks may be added as children of this plug via the user interface, or using the ShaderTweaks API via python.

localise

Turn on to allow location-specific tweaks to be made to inherited shaders. Shaders will be localised to locations matching the node’s filter prior to tweaking. The original inherited shader will remain untouched.