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