|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| Windows 95: 16-bit coordinates only
|
|
|
BitBlt
The BitBlt function performs a bit-block transfer of the color data corresponding to a
rectangle of pixels from the specified source device context into a destination
device context.
BOOL BitBlt(
HDC hdcDest,
| // handle to destination device context
| int nXDest,
| // x-coordinate of destination rectangle's upper-left corner
| int nYDest,
| // y-coordinate of destination rectangle's upper-left corner
| int nWidth,
| // width of destination rectangle
| int nHeight,
| // height of destination rectangle
| HDC hdcSrc,
| // handle to source device context
| int nXSrc,
| // x-coordinate of source rectangle's upper-left corner
| int nYSrc,
| // y-coordinate of source rectangle's upper-left corner
| DWORD dwRop
| // raster operation code
| );
|
|
Parameters
hdcDest
Identifies the destination device context.
nXDest
Specifies the logical x-coordinate of the upper-left corner of the destination
rectangle.
nYDest
Specifies the logical y-coordinate of the upper-left corner of the destination
rectangle.
nWidth
Specifies the logical width of the source and destination rectangles.
nHeight
Specifies the logical height of the source and the destination rectangles.
hdcSrc
Identifies the source device context.
nXSrc
Specifies the logical x-coordinate of the upper-left corner of the source
rectangle.
nYSrc
Specifies the logical y-coordinate of the upper-left corner of the source
rectangle.
dwRop
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:
Value
| Description
| BLACKNESS
| Fills the destination rectangle using the color associated with index 0 in the
physical palette. (This color is black for the default physical palette.)
| DSTINVERT
| Inverts the destination rectangle.
| MERGECOPY
| Merges the colors of the source rectangle with the specified pattern by using
the Boolean AND operator.
| MERGEPAINT
| Merges the colors of the inverted source rectangle with the colors of the
destination rectangle by using the Boolean OR operator.
| NOTSRCCOPY
| Copies the inverted source rectangle to the destination.
| NOTSRCERASE
| Combines the colors of the source and destination rectangles by using the
Boolean OR operator and then inverts the resultant color.
| PATCOPY
| Copies the specified pattern into the destination bitmap.
| PATINVERT
| Combines the colors of the specified pattern with the colors of the
destination rectangle by using the Boolean XOR operator.
| PATPAINT
| Combines 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.
| SRCAND
| Combines the colors of the source and destination rectangles by using the
Boolean AND operator.
| SRCCOPY
| Copies the source rectangle directly to the destination rectangle.
| SRCERASE
| Combines the inverted colors of the destination rectangle with the colors of
the source rectangle by using the Boolean AND operator.
| SRCINVERT
| Combines the colors of the source and destination rectangles by using the
Boolean XOR operator.
| SRCPAINT
| Combines the colors of the source and destination rectangles by using the
Boolean OR operator.
| WHITENESS
| Fills the destination rectangle using the color associated with index 1 in the
physical palette. (This color is white for the default physical palette.)
|
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
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 GetDeviceCaps.
BitBlt returns an error if the source and destination device contexts represent
different devices.
See Also
GetDeviceCaps, MaskBlt, PlgBlt, StretchBlt
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
