Export (0) Print
Expand All

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( );

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.

Nonzero if successful, otherwise 0.

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.

Header: atlimage.h

Community Additions

ADD
Show:
© 2014 Microsoft