BitmapDataExtensionsDrawInto(IReadableBitmapData, IReadWriteBitmapData, IAsyncContext, Rectangle, Point, IQuantizer, IDitherer) Method

public static bool DrawInto(
	this IReadableBitmapData source,
	IReadWriteBitmapData target,
	IAsyncContext? context,
	Rectangle sourceRectangle,
	Point targetLocation,
	IQuantizer? quantizer = null,
	IDitherer? ditherer = null
)

<ExtensionAttribute>
Public Shared Function DrawInto ( 
	source As IReadableBitmapData,
	target As IReadWriteBitmapData,
	context As IAsyncContext,
	sourceRectangle As Rectangle,
	targetLocation As Point,
	Optional quantizer As IQuantizer = Nothing,
	Optional ditherer As IDitherer = Nothing
) As Boolean

public:
[ExtensionAttribute]
static bool DrawInto(
	IReadableBitmapData^ source, 
	IReadWriteBitmapData^ target, 
	IAsyncContext^ context, 
	Rectangle sourceRectangle, 
	Point targetLocation, 
	IQuantizer^ quantizer = nullptr, 
	IDitherer^ ditherer = nullptr
)

[<ExtensionAttribute>]
static member DrawInto : 
        source : IReadableBitmapData * 
        target : IReadWriteBitmapData * 
        context : IAsyncContext * 
        sourceRectangle : Rectangle * 
        targetLocation : Point * 
        ?quantizer : IQuantizer * 
        ?ditherer : IDitherer 
(* Defaults:
        let _quantizer = defaultArg quantizer null
        let _ditherer = defaultArg ditherer null
*)
-> bool 

Parameters

source  IReadableBitmapData

The source IReadableBitmapData to be drawn into the target.

target  IReadWriteBitmapData

The target IReadWriteBitmapData into which source should be drawn.

context  IAsyncContext

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

sourceRectangle  Rectangle

A Rectangle that specifies the portion of the source to be drawn into the target.

targetLocation  Point

The target location. Target size will be always the same as the source size.

quantizer  IQuantizer  (Optional)

An IQuantizer instance to be used for the drawing. If not specified, then the drawing operation might automatically pick a quantizer based on target PixelFormat. This parameter is optional.
Default value: .

ditherer  IDitherer  (Optional)

The ditherer to be used for the drawing. Might be ignored if quantizer is not specified and target PixelFormat format has at least 24 bits-per-pixel size. 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. To reconfigure the degree of parallelism of an existing context, you can use the AsyncContextWrapper class.

Alternatively, you can use this method to specify the degree of parallelism for synchronous execution. For example, by passing AsyncHelper.SingleThreadContext to the context parameter the method will be forced to use a single thread only.

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

Reference