InterleavedGradientNoiseDitherer Class


InterleavedGradientNoiseDitherer Class	KGy SOFT Drawing Libraries Help

Provides an IDitherer implementation for applying an interleaved gradient noise pattern to the dithered result. For other noise-like ditherers see the OrderedDitherer.BlueNoise property and the RandomNoiseDitherer class.
See the Remarks section for details and some examples.

Inheritance Hierarchy

SystemObject
KGySoft.Drawing.ImagingInterleavedGradientNoiseDitherer

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

Syntax

C++

Copy

public sealed class InterleavedGradientNoiseDitherer : IDitherer

Public NotInheritable Class InterleavedGradientNoiseDitherer
	Implements IDitherer

public ref class InterleavedGradientNoiseDitherer sealed : IDitherer

[<SealedAttribute>]
type InterleavedGradientNoiseDitherer =  
    class
        interface IDitherer
    end

The InterleavedGradientNoiseDitherer type exposes the following members.

Constructors

	Name	Description
	InterleavedGradientNoiseDitherer	Initializes a new instance of the InterleavedGradientNoiseDitherer class. See the Examples section for some examples.

Top

Extension Methods

	Name	Description
	InitializeAsync	Gets an IDitheringSession instance potentially asynchronously that can be used to dither the result of the specified IQuantizingSession applied to the specified source. If ditherer is a known ditherer that can be evaluated quickly, then this method might be executed synchronously. This method is available in.NET Framework 4.0 and above. (Defined by DithererExtensions.)

Top

Remarks

Note
The noise generated by the InterleavedGradientNoiseDitherer is not random but based on a formula so using the same source image, quantizer and strength produces always the same result (similarly to the BlueNoise ditherer, which is based on ordered dithering). To dither images with real random noise use the RandomNoiseDitherer, which applies white noise to the quantized source.

The following table demonstrates the effect of the dithering:

Original image	Quantized image
Color hues with alpha gradient	Quantizing with system default 8 BPP palette, no dithering Quantizing with system default 8 BPP palette and interleaved gradient noise dithering
Grayscale color shades	Quantizing with black and white palette, no dithering Quantizing with black and white palette and interleaved gradient noise dithering

Reference

KGySoft.Drawing.Imaging Namespace

KGySoft.Drawing.ImagingIDitherer

KGySoft.Drawing.ImagingOrderedDitherer

KGySoft.Drawing.ImagingErrorDiffusionDitherer

KGySoft.Drawing.ImagingInterleavedGradientNoiseDitherer