CImage::PlgBlt
Performs a bit-block transfer from a rectangle in a source device context into a parallelogram in a destination device context.
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
HBITMAP hbmMask = NULL
) const throw( );
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
int xSrc,
int ySrc,
int nSrcWidth,
int nSrcHeight,
HBITMAP hbmMask = NULL,
int xMask = 0,
int yMask = 0
) const throw( );
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
const RECT& rectSrc,
HBITMAP hbmMask = NULL,
const POINT& pointMask = CPoint(
0, 0 )
) const throw( );
Parameters
hDestDC
A handle to the destination device context.pPoints
A pointer to an array of three points in logical space that identify three corners of the destination parallelogram. The upper left corner of the source rectangle is mapped to the first point in this array, the upper-right corner to the second point in this array, and the lower left corner to the third point. The lower-right corner of the source rectangle is mapped to the implicit fourth point in the parallelogram.hbmMask
A handle to an optional monochrome bitmap that is used to mask the colors of the source rectangle.xSrc
The x-coordinate, in logical units, of the upper left corner of the source rectangle.ySrc
The y-coordinate, in logical units, of the upper left corner of the source rectangle.nSrcWidth
The width, in logical units, of the source rectangle.nSrcHeight
The height, in logical units, of the source rectangle.xMask
The x-coordinate of the upper left corner of the monochrome bitmap.yMask
The y-coordinate of the upper left corner of the monochrome bitmap.rectSrc
A reference to a RECT structure specifying the coordinates of the source rectangle.pointMask
A POINT structure indicating the upper left corner of the mask bitmap.
Return Value
Nonzero if successful, otherwise 0.
Remarks
If hbmMask identifies a valid monochrome bitmap, PlgBit uses this bitmap to mask the bits of color data from the source rectangle.
This method applies to Windows NT, versions 4.0 and later only. See PlgBlt in the Windows SDK and CImage Limitations with Earlier Operating Systems for more detailed information.
Requirements
Header: atlimage.h