На главную

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 | Скачать Вниз

StretchBlt



The StretchBlt function copies a bitmap from a source rectangle into a destination rectangle, stretching or compressing the bitmap to fit the dimensions of the destination rectangle, if necessary. Windows stretches or compresses the bitmap according to the stretching mode currently set in the destination device context.

BOOL StretchBlt(

HDC hdcDest, // handle of destination device context
int nXOriginDest, // x-coordinate of upper-left corner of dest. rect.
int nYOriginDest, // y-coordinate of upper-left corner of dest. rect.
int nWidthDest, // width of destination rectangle
int nHeightDest, // height of destination rectangle
HDC hdcSrc, // handle of source device context
int nXOriginSrc, // x-coordinate of upper-left corner of source rectangle
int nYOriginSrc, // y-coordinate of upper-left corner of source rectangle
int nWidthSrc, // width of source rectangle
int nHeightSrc, // height of source rectangle
DWORD dwRop // raster operation code
);


Parameters

hdcDest

Identifies the destination device context.

nXOriginDest

Specifies the x-coordinate, in logical units, of the upper-left corner of the destination rectangle.

nYOriginDest

Specifies the y-coordinate, in logical units, of the upper-left corner of the destination rectangle.

nWidthDest

Specifies the width, in logical units, of the destination rectangle.

nHeightDest

Specifies the height, in logical units, of the destination rectangle.

hdcSrc

Identifies the source device context.

nXOriginSrc

Specifies the x-coordinate, in logical units, of the upper-left corner of the source rectangle.

nYOriginSrc

Specifies the y-coordinate, in logical units, of the upper-left corner of the source rectangle.

nWidthSrc

Specifies the width, in logical units, of the source rectangle.

nHeightSrc

Specifies the height, in logical units, of the source rectangle.

dwRop

Specifies the raster operation to be performed. Raster operation codes define how Windows combines colors in output operations that involve a brush, a source bitmap, and a destination bitmap.

See the BitBlt function for a list of common raster operation codes.



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

StretchBlt stretches or compresses the source bitmap in memory and then copies the result to the destination rectangle. The color data for pattern or destination pixels is merged after the stretching or compression occurs.
When an enhanced metafile is being recorded, an error occurs (and the function returns FALSE) if the source device context identifies an enhanced-metafile device context.
If the specified raster operation requires a brush, Windows uses the brush currently selected into the destination device context.

The destination coordinates are transformed by using the transformation currently specified for the destination device context; the source coordinates are transformed by using the transformation currently specified for the source device context.
If the source transformation has a rotation or shear, an error occurs.
If destination, source, and pattern bitmaps do not have the same color format, StretchBlt converts the source and pattern bitmaps to match the destination bitmap.

If StretchBlt must convert a monochrome bitmap to a color bitmap, it sets white bits (1) to the background color and black bits (0) to the foreground color. To convert a color bitmap to a monochrome bitmap, it sets pixels that match the background color to white (1) and sets all other pixels to black (0). The foreground and background colors of the device context with color are used.
StretchBlt creates a mirror image of a bitmap if the signs of the nWidthSrc and nWidthDest parameters or of the nHeightSrc and nHeightDest parameters differ. If nWidthSrc and nWidthDest have different signs, the function creates a mirror image of the bitmap along the x-axis. If nHeightSrc and nHeightDest have different signs, the function creates a mirror image of the bitmap along the y-axis.

Not all devices support the StretchBlt function. For more information, see the GetDeviceCaps function.

See Also

BitBlt, GetDeviceCaps, MaskBlt, PlgBlt, SetStretchBltMode


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

StretchBlt



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

BOOL StretchBlt(

HDC hdcDest, // РУЧКА контекста устройства расположения int nXOriginDest, // x-coordinate верхнего левого угла dest. rect.
int nYOriginDest, // y-coordinate верхнего левого угла dest. rect.
int nWidthDest, // ширина прямоугольника расположения int nHeightDest, // высота прямоугольника расположения HDC hdcSrc, // ручка исходного контекста устройства int nXOriginSrc, // x-coordinate верхнего левого угла исходного прямоугольника int nYOriginSrc, // y-coordinate верхнего левого угла исходного прямоугольника int nWidthSrc, // ширина исходного прямоугольника int nHeightSrc, // высота исходного кода растрового действия прямоугольника DWORD dwRop //
);


Параметры

hdcDest

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

nXOriginDest

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

nYOriginDest

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

nWidthDest

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

nHeightDest

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

hdcSrc

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

nXOriginSrc

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

nYOriginSrc

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

nWidthSrc

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

nHeightSrc

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

dwRop

Определяет растровое действие, которое нужно выполняться. Растровые коды действия определяют как цвета комбайнов Окна в выходных действиях, которые включают щетку, исходное побитовое отображение, и побитовое отображение расположения.

Смотри функцию BitBlt для списка общих растровых кодов действия.



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

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

Замечания

StretchBlt ПРОТЯГИВАЕТ или сжимает исходное побитовое отображение в память затем копирует результат в прямоугольник расположения. Цветные данные для образца или пикселей расположения объединены после того, как растяжение или сжатие произойдут.
Когда расширенный метафайл записывается, ошибка происходит (и функция возвращает ЛОЖЬ) если исходный контекст устройства идентифицирует контекст расширенного метафайла устройства.
Если определенная растровая операция требует щетку, Windows использует щетку к настоящему времени выбранную в контекст устройства расположения.

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

Если StretchBlt должен преобразовать монохромное побитовое отображение в цветное побитовое отображение, это устанавливает белым битам (1) в цвет фона и черные биты (0) в цвет переднего плана. Чтобы преобразовывать цветное побитовое отображение в монохромное побитовое отображение, это устанавливает пиксели, которые соответствуют цвету фона в белые (1) и комплекты все другие пиксели на черный (0). Передний план и цвета фона контекста устройства с цветом использованы.
StretchBlt СОЗДАЕТ зеркальное отражение побитового отображения если признаки nWidthSrc и параметров nWidthDest или nHeightSrc и параметров nHeightDest отличаться. Если nWidthSrc и nWidthDest имеет другие знаки, функция создает зеркальное отражение побитового отображения вдоль x-axis. Если nHeightSrc и nHeightDest имеет другие знаки, функция создает зеркальное отражение побитового отображения вдоль y-axis.

Не все устройства поддерживают функцию StretchBlt. Более подробно, смотри функцию GetDeviceCaps.

Смотри Также

BitBlt, GetDeviceCaps, MaskBlt, PlgBlt, SetStretchBltMode


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