Udostępnij za pośrednictwem


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

See Also

Reference

CImage Class

CImage::BitBlt

CImage::MaskBlt

Other Resources

CImage Members