OrderedDithererBlueNoise Property

KGy SOFT Drawing Libraries Help
Gets an OrderedDitherer using a fixed 64x64 blue noise pattern of 256 different values.
See the Examples section for some examples.

Namespace:  KGySoft.Drawing.Imaging
Assembly:  KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 7.0.0-preview.2

public static OrderedDitherer BlueNoise { get; }

Property Value

Type: OrderedDitherer

Note Note
Generating random blue noise patterns is a very resource intensive operation but this method uses a pregenerated fix pattern, which is very fast. To dither images with real random noise use the RandomNoiseDitherer, which applies white noise to the quantized source.

The following example demonstrates how to use the ditherer returned by this property:
public static IReadWriteBitmapData ToDitheredBlueNoise(IReadWriteBitmapData source, IQuantizer quantizer)
    IDitherer ditherer = OrderedDitherer.BlueNoise;

    // a.) this solution returns a new bitmap data and does not change the original one:
    return source.Clone(quantizer.PixelFormatHint, quantizer, ditherer);

    // b.) alternatively, you can perform the dithering directly on the source bitmap data:
    source.Dither(quantizer, ditherer);
    return source;

The example above may produce the following results:

Original imageQuantized and dithered image

Color hues with alpha gradient
Color hues with alpha gradient

Grayscale color shades with different bit depths
Grayscale color shades

Grayscale color shades with black and white palette using blue noise dithering
Quantizing with black and white palette

Tip Tip
See the Remarks section of the OrderedDitherer class for more details and examples.
See Also