На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

BitBlt



Функция BitBlt выполняет битовую-блочную передачу цветных данных, соответствуемых в прямоугольник пикселей из определенного исходного контекста устройства в контекст устройства расположения.

BOOL BitBlt(

HDC hdcDest, // РУЧКА в контекст устройства расположения int nXDest, // x-coordinate прямоугольника расположения верхнего левого угла int nYDest, // y-coordinate прямоугольника расположения верхнего левого угла int nWidth, // ширина прямоугольника расположения int nHeight, // высота прямоугольника расположения HDC hdcSrc, // ручка в исходный контекст устройства int nXSrc, // x-coordinate верхнего левого угла исходного прямоугольника int nYSrc, // y-coordinate верхнего левого угла исходного кода растровой операции прямоугольника DWORD dwRop //
);


Параметры

hdcDest

Идентифицирует контекст устройства расположения.

nXDest

Определяет логический x-coordinate верхнего левого угла прямоугольника расположения.

nYDest

Определяет логический y-coordinate верхнего левого угла прямоугольника расположения.

nWidth

Определяет логическую ширину исходных и прямоугольников расположения.

nHeight

Определяет логическую высоту источника и прямоугольники расположения.

hdcSrc

Идентифицирует исходный контекст устройства.

nXSrc

Определяет логический x-coordinate верхнего левого угла исходного прямоугольника.

nYSrc

Определяет логический y-coordinate верхнего левого угла исходного прямоугольника.

dwRop

Определяет растр-операцию кода. Эти коды определяют как цветные данные для исходного прямоугольника должны быть объединены цветными данными для прямоугольника расположения, чтобы достигать конечного цвета.
Следующее списка показывает немного общую растровую операцию кодировать:

Описание Величины
ЧЕРНОТА Заполняет прямоугольник расположения, использовавший цвет связывался индексом 0 в физической палитре. (Этот цвет черн для по умолчанию физической палитры.)
DSTINVERT ИНВЕРТИРУЕТ прямоугольник расположения.
MERGECOPY ОБЪЕДИНЯЕТ цвета исходного прямоугольника с определенным образцом используя Логического И оператора.
MERGEPAINT ОБЪЕДИНЯЕТ цвета инвертировать исходного прямоугольника с цветами прямоугольника расположения используя Логического ИЛИ оператора.
NOTSRCCOPY КОПИРУЕТ инвертировать исходный прямоугольник в расположение.
NOTSRCERASE КОМБАЙНАМ цвета источника и прямоугольники расположения используя Логического ИЛИ оператора затем инвертирует равнодействующий цвет.
PATCOPY КОПИРУЕТ определенный образец в побитовое отображение расположения.
PATINVERT ОБЪЕДИНЯЕТ цвета определенного образца с цветами прямоугольника расположения используя Логического оператора XOR.
PATPAINT ОБЪЕДИНЯЕТ цвета образца с цветами инвертировать исходного прямоугольника используя Логического ИЛИ оператора. Результат этой операции объединен цветами прямоугольника расположения используя Логического ИЛИ оператора.
SRCAND ОБЪЕДИНЯЕТ цвета исходных и прямоугольников расположения используя Логического И оператора.
SRCCOPY КОПИРУЕТ исходный прямоугольник непосредственно в прямоугольник расположения.
SRCERASE КОМБАЙНАМ инвертировать цвета прямоугольника расположения с цветами исходного прямоугольника используя Логического И оператора.
SRCINVERT ОБЪЕДИНЯЕТ цвета исходных и прямоугольников расположения используя Логического оператора XOR.
SRCPAINT ОБЪЕДИНЯЕТ цвета исходных и прямоугольников расположения используя Логического ИЛИ оператора.
БЕЛИЗНА Заполняет прямоугольник расположения, использовавший цвет связывался индексом 1 в физической палитре. (Этот цвет белый для по умолчанию физической палитры.)


Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Если вращение или преобразование сдвига - в силе в исходном контексте устройства, BitBlt возвращает ошибку. Если другие преобразования существуют в исходном контексте устройства (и сочетающееся преобразование - не в силе в контексте устройства расположения), прямоугольник в контексте устройства расположения протянут, сжат, или вращан как необходимый.
Если цветные форматы источника и контексты устройства расположения не сочетаются, функциональные преобразования BitBlt исходный цветной формат, чтобы соответствовать формату расположения.

Когда расширенный метафайл записывается, ошибка происходит если исходный контекст устройства идентифицирует контекст расширенного метафайла устройства.
Не все устройства поддерживают функцию BitBlt. Более подробно, смотри растровый вход возможности RC_BITBLT в GetDeviceCaps.
BitBlt ВОЗВРАЩАЕТ ошибку если исходные и контексты устройства расположения представляют другие устройства.

Смотри Также

GetDeviceCaps, MaskBlt, PlgBlt, StretchBlt


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz