KGy SOFT Drawing Libraries Help
Interleaved
Initializes a new instance of the InterleavedGradientNoiseDitherer class.
Definition
Namespace: KGySoft.Drawing.Imaging
Assembly: KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 9.1.1
Assembly: KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 9.1.1
C#
public InterleavedGradientNoiseDitherer(
float strength = 0f
)VB
Public Sub New (
Optional strength As Single = 0F
)C++
public:
InterleavedGradientNoiseDitherer(
float strength = 0f
)F#
new :
?strength : float32
(* Defaults:
let _strength = defaultArg strength 0f
*)
-> InterleavedGradientNoiseDithererParameters
- strength Single (Optional)
- The strength of the dithering effect between 0 and 1 (inclusive bounds).
Specify 0 to use an auto value for each dithering session based on the used quantizer.
See the Remarks section of the OrderedDitherer.ConfigureStrength method for more details and some examples regarding dithering strength. The same applies also for the InterleavedGradientNoiseDitherer class. This parameter is optional.
Default value: 0.
Examples
The following example demonstrates how to use the InterleavedGradientNoiseDitherer class.
C#
public static IReadWriteBitmapData ToDitheredInterleavedGradientNoise(IReadWriteBitmapData source, IQuantizer quantizer)
{
IDitherer ditherer = new InterleavedGradientNoiseDitherer();
// 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 image | Quantized and dithered image |
|---|---|
|
|
|
|
Exceptions
| ArgumentOutOfRangeException | strength must be between 0 and 1, inclusive bounds. |