BitBlt function (Windows).pdf

(173 KB) Pobierz
19.11.2017
BitBlt function (Windows)
EN
Ta zawartość nie jest dostępna w wymaganym języku. Wersja w języku angielskim znajduje się tutaj.
BitBlt function
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.
Syntax
C++
BOOL BitBlt(
_In_ HDC
_In_
int
_In_
int
_In_
int
_In_
int
_In_ HDC
_In_
int
_In_
int
_In_ DWORD
);
hdcDest,
nXDest,
nYDest,
nWidth,
nHeight,
hdcSrc,
nXSrc,
nYSrc,
dwRop
Parameters
hdcDest
[in]
A handle to the destination device context.
nXDest
[in]
The x-coordinate, in logical units, of the upper-left corner of the destination rectangle.
nYDest
[in]
The y-coordinate, in logical units, of the upper-left corner of the destination rectangle.
nWidth
[in]
The width, in logical units, of the source and destination rectangles.
nHeight
[in]
The height, in logical units, of the source and the destination rectangles.
hdcSrc
[in]
A handle to the source device context.
nXSrc
[in]
The x-coordinate, in logical units, of the upper-left corner of the source rectangle.
nYSrc
[in]
https://msdn.microsoft.com/pl-pl/library/windows/desktop/dd183370(v=vs.85).aspx
1/4
19.11.2017
BitBlt function (Windows)
The y-coordinate, in logical units, of the upper-left corner of the source rectangle.
dwRop
[in]
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
Meaning
Fills the destination rectangle using the color associated with index 0 in the physical
palette. (This color is black for the default physical palette.)
Includes any windows that are layered on top of your window in the resulting image. By
default, the image only contains your window. Note that this generally cannot be used for
printing device contexts.
Inverts the destination rectangle.
BLACKNESS
CAPTUREBL
T
DSTINVERT
MERGECOP
Y
Merges the colors of the source rectangle with the brush currently selected in
hdcDest,
by
using the Boolean AND operator.
MERGEPAI
NT
Merges the colors of the inverted source rectangle with the colors of the destination
rectangle by using the Boolean OR operator.
NOMIRROR
BITMAP
Prevents the bitmap from being mirrored.
NOTSRCCO
PY
Copies the inverted source rectangle to the destination.
NOTSRCER
ASE
Combines the colors of the source and destination rectangles by using the Boolean OR
operator and then inverts the resultant color.
PATCOPY
Copies the brush currently selected in
hdcDest,
into the destination bitmap.
PATINVERT
Combines the colors of the brush currently selected in
hdcDest,
with the colors of the
destination rectangle by using the Boolean XOR operator.
https://msdn.microsoft.com/pl-pl/library/windows/desktop/dd183370(v=vs.85).aspx
2/4
19.11.2017
BitBlt function (Windows)
PATPAINT
Combines the colors of the brush currently selected in
hdcDest,
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.
Combines the colors of the source and destination rectangles by using the Boolean AND
operator.
Copies the source rectangle directly to the destination rectangle.
SRCAND
SRCCOPY
SRCERASE
Combines the inverted colors of the destination rectangle with the colors of the source
rectangle by using the Boolean AND operator.
Combines the colors of the source and destination rectangles by using the Boolean XOR
operator.
Combines the colors of the source and destination rectangles by using the Boolean OR
operator.
Fills the destination rectangle using the color associated with index 1 in the physical
palette. (This color is white for the default physical palette.)
SRCINVERT
SRCPAINT
WHITENESS
 
Return value
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
BitBlt only does clipping on the destination DC.
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 following functions:
MaskBlt, PlgBlt,
and
StretchBlt.
BitBlt returns an error if the source and destination device contexts represent different devices. To transfer data
between DCs for different devices, convert the memory bitmap to a DIB by calling
GetDIBits.
To display the DIB to
the second device, call
SetDIBits
or
StretchDIBits.
https://msdn.microsoft.com/pl-pl/library/windows/desktop/dd183370(v=vs.85).aspx
3/4
19.11.2017
BitBlt function (Windows)
ICM: No color management is performed when blits occur.
Examples
For an example, see
Capturing an Image.
Requirements
Minimum supported client
Minimum supported server
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Header
Wingdi.h (include Windows.h)
Library
Gdi32.lib
DLL
Gdi32.dll
See also
Bitmaps Overview
Bitmap Functions
GetDeviceCaps
GetDIBits
MaskBlt
PlgBlt
SetDIBits
StretchBlt
StretchDIBits
© 2017 Microsoft
https://msdn.microsoft.com/pl-pl/library/windows/desktop/dd183370(v=vs.85).aspx
4/4

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika:

Zgłoś jeśli naruszono regulamin