BitmapDataExtensionsQuantize(IReadWriteBitmapData, IQuantizer) Method
Namespace: KGySoft.Drawing.ImagingAssembly: KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 9.1.1
public static void Quantize(
this IReadWriteBitmapData bitmapData,
IQuantizer quantizer
)
<ExtensionAttribute>
Public Shared Sub Quantize (
bitmapData As IReadWriteBitmapData,
quantizer As IQuantizer
)
public:
[ExtensionAttribute]
static void Quantize(
IReadWriteBitmapData^ bitmapData,
IQuantizer^ quantizer
)
[<ExtensionAttribute>]
static member Quantize :
bitmapData : IReadWriteBitmapData *
quantizer : IQuantizer -> unit
- bitmapData IReadWriteBitmapData
- An IReadWriteBitmapData instance to be quantized.
- quantizer IQuantizer
- An IQuantizer implementation to be used for quantizing the specified bitmapData.
In Visual Basic and C#, you can call this method as an instance method on any object of type
IReadWriteBitmapData. When you use instance method syntax to call this method, omit the first parameter. For more information, see
Extension Methods (Visual Basic) or
Extension Methods (C# Programming Guide).
This method adjusts the degree of parallelization automatically, blocks the caller, and does not support cancellation or reporting progress. You can use
the
Quantize(IReadWriteBitmapData, IQuantizer, ParallelConfig) overload to configure these, while still executing the method synchronously. Alternatively, use
the
BeginQuantize or
QuantizeAsync (in .NET Framework 4.0 and above) methods to perform the operation asynchronously.
This method quantizes the specified bitmapData in place (its original content will be overwritten). To return a new instance
use the Clone extension method instead.
If the KnownPixelFormat or the palette of bitmapData is not compatible with the colors of the specified quantizer, then
the result may not be correct.
If bitmapData has already the same set of colors that the specified quantizer, then it can happen
that calling this method does not change the bitmapData at all.
- To use predefined colors or custom quantization functions use the static methods of the PredefinedColorsQuantizer class.
See the Remarks section of its members for details and examples. - To use an optimized palette of a specified number of colors adjusted for bitmapData see the OptimizedPaletteQuantizer class.
