Export (0) Print
Expand All
Expand Minimize

BitBlt (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function transfers pixels from a specified source rectangle to a specified destination rectangle, altering the pixels according to the selected raster operation (ROP) code.

BOOL BitBlt(
  HDC hdcDest, 
  int nXDest, 
  int nYDest, 
  int nWidth, 
  int nHeight, 
  HDC hdcSrc, 
  int nXSrc, 
  int nYSrc, 
  DWORD dwRop
);

Parameters

hdcDest
[in] Handle to the destination device context.
nXDest
[in] Specifies the logical x-coordinate of the upper-left corner of the destination rectangle.
nYDest
[in] Specifies the logical y-coordinate of the upper-left corner of the destination rectangle.
nWidth
[in] Specifies the logical width of the source and destination rectangles.
nHeight
[in] Specifies the logical height of the source and the destination rectangles.
hdcSrc
[in] Handle to the source device context.
nXSrc
[in] Specifies the logical x-coordinate of the upper-left corner of the source rectangle.
nYSrc
[in] Specifies the logical y-coordinate of the upper-left corner of the source rectangle.
dwRop
[in] Specifies a raster-operation code.

These codes define how the color data for the source rectangle is to be combined with the color data for the destination rectangle to achieve the final color.

The following list shows some common raster operation codes.

ValueDescription
BLACKNESSFills the destination rectangle using the color associated with index 0 in the physical palette.

This color is black for the default physical palette.

DSTINVERTInverts the destination rectangle.
MERGECOPYMerges the colors of the source rectangle with the specified pattern by using the Boolean AND operator.
MERGEPAINTMerges the colors of the inverted source rectangle with the colors of the destination rectangle by using the Boolean OR operator.
NOTSRCCOPYCopies the inverted source rectangle to the destination.
NOTSRCERASECombines the colors of the source and destination rectangles by using the Boolean OR operator and then inverts the resultant color.
PATCOPYCopies the specified pattern into the destination bitmap.
PATINVERTCombines the colors of the specified pattern with the colors of the destination rectangle by using the Boolean XOR operator.
PATPAINTCombines the colors of the pattern with the colors of the inverted source rectangle by using the Boolean OR operator.

The result of this operation is combined with the colors of the destination rectangle by using the Boolean OR operator.

SRCANDCombines the colors of the source and destination rectangles by using the Boolean AND operator.
SRCCOPYCopies the source rectangle directly to the destination rectangle.
SRCERASECombines the inverted colors of the destination rectangle with the colors of the source rectangle by using the Boolean AND operator.
SRCINVERTCombines the colors of the source and destination rectangles by using the Boolean XOR operator.
SRCPAINTCombines the colors of the source and destination rectangles by using the Boolean OR operator.
WHITENESSFills the destination rectangle using the color associated with index 1 in the physical palette.

This color is white for the default physical palette.

For the complete list of raster operations codes, see Ternary Raster Operations.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Code Example

The following code example shows how to use BitBlt to copy all of the pixels in one bitmap into another bitmap.

Note   To make the following code example easier to read, error checking is not included. This code example should not be used in a release configuration unless it has been modified to include secure error handling.
HBITMAP CopyBitmap( HBITMAP hbm) {
    HDC hdcSrc = CreateCompatibleDC(NULL);
    HDC hdcDst = CreateCompatibleDC(NULL);
    HBITMAP hbmOld, hbmOld2, hbmNew;
    BITMAP bm;
    GetObject(hbm, sizeof(bm), &bm);
    hbmOld = SelectObject(hdcSrc, hbm);
    hbmNew = CreateBitmap( bm.bmWidth, bm.bmHeight, bm.bmPlanes,
bm.bmBitsPixel,
            NULL);
    hbmOld2 = SelectObject(hdcDst, hbmNew);
    BitBlt(hdcDst, 0, 0, bm.bmWidth, bm.bmHeight, hdcSrc, 0, 0, SRCCOPY);
    SelectObject(hdcSrc, hbmOld);
    DeleteDC(hdcSrc);
    DeleteDC(hdcDst);
    return hbmNew;
}

Remarks

If a rotation or shear transformation is in effect in the source device context, BitBlt returns an error.

If other transformations exist in the source device context (and a matching transformation is not in effect in the destination device context), the rectangle in the destination device context is stretched, compressed, or rotated as necessary.

If the color formats of the source and destination device contexts do not match, the BitBlt function converts the source color format to match the destination format.

When an enhanced metafile is being recorded, an error occurs if the source device context identifies an enhanced-metafile device context.

Not all devices support the BitBlt function.

For more information, see the RC_BITBLT raster capability entry in the GetDeviceCaps function, as well as the MaskBlt and StretchBlt functions.

BitBlt returns an error if the source and destination device contexts represent different devices.

For information about blitting to displays with right-to-left orientations, see Creating Bitmaps.

In Windows CE 1.0 and 1.01, the dwRop parameter can only be assigned the following values:

  • SRCAND
  • SRCCOPY
  • SRCINVERT
  • SRCPAINT

In Windows CE 2.0 and later, the dwRop parameter can be any ROP3. For more information, see Creating Bitmaps.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

GetDeviceCaps | MaskBlt | StretchBlt | GDI Functions | Ternary Raster Operations


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show:
© 2014 Microsoft