RandomNoiseDitherer Class

Provides an IDitherer implementation for random noise dithering. This class applies a random white noise to the result. For other noise-like ditherers see the OrderedDitherer.BlueNoise property and the InterleavedGradientNoiseDitherer class.

Definition

Namespace: KGySoft.Drawing.Imaging
Assembly: KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 9.1.1

C#

public sealed class RandomNoiseDitherer : IDitherer

VB

Public NotInheritable Class RandomNoiseDitherer
	Implements IDitherer

C++

public ref class RandomNoiseDitherer sealed : IDitherer

F#

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

Inheritance: Object RandomNoiseDitherer

Implements: IDitherer

Remarks

The RandomNoiseDitherer generates some random white noise to the quantized source.

Tip

There are also a couple of ditherers with non-random noise-like patterns in this library. See also the OrderedDitherer.BlueNoise property and the InterleavedGradientNoiseDitherer class.

To get always the same result for the same source image and quantizer you can specify a seed when initializing a RandomNoiseDitherer instance. Please note though that specifying a seed prevents parallel processing, which makes performance worse on multi-core systems.

Examples

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 random noise dithering
Grayscale color shades	Quantizing with black and white palette, no dithering Quantizing with black and white palette and random noise dithering

Constructors

RandomNoiseDitherer(AutoStrengthMode, NullableInt32)	Initializes a new instance of the RandomNoiseDitherer class with a specific auto strength strategy.
RandomNoiseDitherer(Single, NullableInt32)	Initializes a new instance of the RandomNoiseDitherer class. See the online help for an example with images.

Extension Methods

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)