GdipDrawImagePointsRect

 

 

Description

Draws an image at a specified location.

Syntax

GpStatus WINGDIPAPI GdipDrawImagePointsRect(

    GpGraphics *graphics,

    GpImage *image,

    GDIPCONST GpPointF *points,

    INT count,

    REAL srcx,

    REAL srcy,

    REAL srcwidth,

    REAL srcheight,

    GpUnit srcUnit,

    GDIPCONST GpImageAttributes* imageAttributes,

    DrawImageAbort callback,

    VOID * callbackData

);

PowerBASIC Syntax

DECLARE FUNCTION GdipDrawImagePointsRect ( _

    BYVAL graphics AS DWORD, _

    BYVAL pImage AS DWORD, _

    BYREF pPoints AS PointF, _

    BYVAL count AS LONG, _

    BYVAL srcx AS SINGLE, _

    BYVAL srcy AS SINGLE, _

    BYVAL srcwidth AS SINGLE, _

    BYVAL srcheight AS SINGLE, _

    BYVAL srcUnit AS LONG, _

    BYVAL imageAttributes AS DWORD, _

    BYVAL pcallback AS DWORD, _

    BYVAL callbackData AS DWORD _

) AS LONG

Parameters

 

graphics

[in] Pointer to the Graphics object.

image

[in] Pointer to an Image object that specifies the image to be drawn.

points

[in] Pointer to an array of PointF structures that specify the area, in a parallelogram, in which to draw the image.

count

[in] Long integer value that specifies the number of elements in the destPoints array.

srcx

[in] Simple precision value that specifies the x-coordinate of the upper-left corner of the portion of the source image to be drawn.

srcy

[in] Simple precision value that specifies the y-coordinate of the upper-left corner of the portion of the source image to be drawn.

srcwidth

[in] Simple precision value that specifies the width of the portion of the source image to be drawn.

srcheight

[in] Simple precision value that specifies the height of the portion of the source image to be drawn.

srcunit

[in] Element of the Unit enumeration that specifies the unit of measure for the image. The default value is UnitPixel.

imageAttributes

[in] Pointer to an ImageAttributes structure that specifies the color and size attributes of the image to be drawn. The default value is NULL.

callback

[in] Callback method used to cancel the drawing in progress. The default value is NULL.

callbackData

[in] Pointer to additional data used by the method specified by the callback parameter. The default value is NULL.

Remarks

The value of the count parameter must equal 3 to specify the coordinates of the upper-left corner, upper-right corner, and lower-left corner of the parallelogram. The coordinate of the lower-right corner is calculated using the three given coordinates, the width, and the height of the image. The portion of the source image to be drawn is scaled to fit the parallelogram.

 

Valid HTML 4.01 Transitional