BitmapDataExtensionsClone(IReadableBitmapData, KnownPixelFormat, IQuantizer, IDitherer) Method

public static IReadWriteBitmapData Clone(
	this IReadableBitmapData source,
	KnownPixelFormat pixelFormat,
	IQuantizer? quantizer,
	IDitherer? ditherer = null
)

<ExtensionAttribute>
Public Shared Function Clone ( 
	source As IReadableBitmapData,
	pixelFormat As KnownPixelFormat,
	quantizer As IQuantizer,
	Optional ditherer As IDitherer = Nothing
) As IReadWriteBitmapData

public:
[ExtensionAttribute]
static IReadWriteBitmapData^ Clone(
	IReadableBitmapData^ source, 
	KnownPixelFormat pixelFormat, 
	IQuantizer^ quantizer, 
	IDitherer^ ditherer = nullptr
)

[<ExtensionAttribute>]
static member Clone : 
        source : IReadableBitmapData * 
        pixelFormat : KnownPixelFormat * 
        quantizer : IQuantizer * 
        ?ditherer : IDitherer 
(* Defaults:
        let _ditherer = defaultArg ditherer null
*)
-> IReadWriteBitmapData 

Parameters

source  IReadableBitmapData

An IReadableBitmapData instance to be cloned.

pixelFormat  KnownPixelFormat

The desired pixel format of the result.

quantizer  IQuantizer

An optional IQuantizer instance to determine the colors of the result. If and pixelFormat is an indexed format, then a default palette and quantization logic will be used.

ditherer  IDitherer  (Optional)

The ditherer to be used. Might be ignored if quantizer is not specified and pixelFormat represents an at least 24 bits-per-pixel size. This parameter is optional.
Default value: .

Return Value

Usage Note

If pixelFormat can represent a narrower set of colors, then the result will be automatically quantized to its color space, even if there is no quantizer specified. To use dithering a ditherer must be explicitly specified though.

If quantizer is specified but it uses more/different colors than pixelFormat can represent, then the result will eventually be quantized to pixelFormat, though the result may have a poorer quality than expected.

Color depth of wide-color formats (Format16bppGrayScale, Format48bppRgb, Format64bppArgb, Format64bppPArgb) can be preserved only between the same pixel formats if there is no quantizer specified. If pixel formats are different, then colors might be quantized to 32bpp ones during the operation.

Reference