BitmapDataExtensionsClone(IReadableBitmapData, IAsyncContext, KnownPixelFormat, IQuantizer, IDitherer, NullableRectangle) Method

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

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

public:
[ExtensionAttribute]
static IReadWriteBitmapData^ Clone(
	IReadableBitmapData^ source, 
	IAsyncContext^ context, 
	KnownPixelFormat pixelFormat, 
	IQuantizer^ quantizer, 
	IDitherer^ ditherer = nullptr, 
	Nullable<Rectangle> sourceRectangle = nullptr
)

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

Parameters

source  IReadableBitmapData

An IReadableBitmapData instance to be cloned.

context  IAsyncContext

An IAsyncContext instance that contains information for asynchronous processing about the current operation.

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: .

sourceRectangle  NullableRectangle  (Optional)

A Rectangle that specifies the portion of the source to be cloned, or to clone the whole source. This parameter is optional.
Default value: .

Return Value

Usage Note

This method blocks the caller thread but if context belongs to an async top level method, then the execution may already run on a pool thread. Degree of parallelism, the ability of cancellation and reporting progress depend on how these were configured at the top level method.

When reporting progress, this library always passes a DrawingOperation instance to the generic methods of the IAsyncProgress interface.

Reference