Singularity/Library/PackageCache/com.unity.shadergraph@12.1.11/Documentation~/Dither-Node.md
2024-05-06 11:45:45 -07:00

1.6 KiB

Dither Node

Description

Dither is an intentional form of noise used to randomize quantization error. It is used to prevent large-scale patterns such as color banding in images. The Dither node applies dithering in screen-space to ensure a uniform distribution of the pattern. This can be adjusted by connecting another node to input Screen Position.

This Node is commonly used as an input to Alpha Clip Threshold on the Master Node to give the appearance of transparency to an opaque item. This is useful for creating geometry that appears to be transparent but has the advantages of rendering as opaque, such as writing depth or being rendered in deferred.

Ports

Name Direction Type Binding Description
In Input Dynamic Vector None Input value
Screen Position Input Vector 4 Screen Position Coordinates used to apply dither pattern
Out Output Dynamic Vector None Output value

Generated Code Example

The following example code represents one possible outcome of this node.

void Unity_Dither_float4(float4 In, float4 ScreenPosition, out float4 Out)
{
    float2 uv = ScreenPosition.xy * _ScreenParams.xy;
    float DITHER_THRESHOLDS[16] =
    {
        1.0 / 17.0,  9.0 / 17.0,  3.0 / 17.0, 11.0 / 17.0,
        13.0 / 17.0,  5.0 / 17.0, 15.0 / 17.0,  7.0 / 17.0,
        4.0 / 17.0, 12.0 / 17.0,  2.0 / 17.0, 10.0 / 17.0,
        16.0 / 17.0,  8.0 / 17.0, 14.0 / 17.0,  6.0 / 17.0
    };
    uint index = (uint(uv.x) % 4) * 4 + uint(uv.y) % 4;
    Out = In - DITHER_THRESHOLDS[index];
}