This documentation is for the old version. Go to the latest Graphics Mill docs

Bitmap.Draw Method (IntPtr, RectangleF, RectangleF, CombineMode, Single, InterpolationMode)

Draws current bitmap on given Windows GDI device context (represented as handle to device context, i.e. HDC).

Namespace: Aurigma.GraphicsMill
Assembly: Aurigma.GraphicsMill (in Aurigma.GraphicsMill.dll)

Syntax

Visual Basic

Public Sub Draw ( _
	hdc As IntPtr, _
	destinationRectangle As RectangleF, _
	sourceRectangle As RectangleF, _
	combine As CombineMode, _
	opacity As Single, _
	interpolationMode As InterpolationMode _
)

public void Draw(
	IntPtr hdc,
	RectangleF destinationRectangle,
	RectangleF sourceRectangle,
	CombineMode combine,
	float opacity,
	InterpolationMode interpolationMode
)

Parameters

hdc: Type: System.IntPtr
Target handle to device context (on which current bitmap should be drawn).

destinationRectangle: Type: System.Drawing.RectangleF
Destination rectangle (see Remarks section).

sourceRectangle: Type: System.Drawing.RectangleF
Source rectangle (see Remarks section).

combine: Type: Aurigma.GraphicsMill.Transforms.CombineMode
Algorithm of images blending (plain pixels copying, alpha blending, bitwise operations, etc).

opacity: Type: System.Single
A number in range [0, 1] specifying total opacity of the image. If 0, image is completely transparent, if 1, image is completely opaque.

interpolationMode: Type: Aurigma.GraphicsMill.Transforms.InterpolationMode
Algorithm of resizing. Using this parameter you can select between speed and quality of resizing.

Remarks

Pixels from source rectangle of current bitmap are drawn to destination rectangle on the given HDC. If source rectangle dimensions differ from dimensions of destination rectangle, pixels are resized to have the same size as destination rectangle.

Note

If bitmap has pixel format which is not GDI-compatible (e.g. extended pixel formats, CMYK, etc) method will automatically create a copy converted to the Format32bppArgb. That's why you always get it drawn, but if you are going to call this method multiple times, it is recommended to convert it to some GDI-compatible format (like Format32bppArgb) to increase the performance.

If you want method to calculate width and height automatically, you can pass 0 to these arguments. It will be calculated with the following way:

If both width and heigth (both for source and destination rectangles) are 0, it will take source image dimensions (Width and Height properties). This way no resize will be done during drawing.
If only one of arguments is 0, it will calculate this argument to save proportion. For example, source image is 800x600, and you pass 400 as width and 0 as height. Height will be calculated to preserve aspect ratio of the image, i.e. it will be equal to 300.

All coordinates are measured in units specified with Unit property of the source bitmap.

Bitmap.Draw Method (IntPtr, RectangleF, RectangleF, CombineMode, Single, InterpolationMode)

Syntax

Parameters

Remarks

See Also

Reference

Manual