Функция SetStretchBltMode (wingdi.h)
Функция SetStretchBltMode задает режим растягивания растрового рисунка в указанном контексте устройства.
Синтаксис
int SetStretchBltMode(
[in] HDC hdc,
[in] int mode
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] mode
Режим растяжения. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Выполняет логическую операцию AND, используя значения цвета для исключенных и существующих пикселей. Если растровое изображение является монохромным, в этом режиме черные пиксели сохраняются за счет белых пикселей. |
|
Удаляет пиксели. В этом режиме удаляются все исключенные строки пикселей, не пытаясь сохранить их сведения. |
|
Сопоставляет пиксели из исходного прямоугольника в блоки пикселей в целевом прямоугольнике. Средний цвет по целевому блоку пикселей соответствует цвету исходных пикселей.
После настройки режима растягивания HALFTONE приложение должно вызвать функцию SetBrushOrgEx , чтобы задать источник кисти. Если это не удается сделать, происходит несоответствие кисти. |
|
То же, что и BLACKONWHITE. |
|
То же, что и COLORONCOLOR. |
|
То же, что и HALFTONE. |
|
То же, что и WHITEONBLACK. |
|
Выполняет логическую операцию OR, используя значения цвета для исключенных и существующих пикселей. Если растровое изображение является монохромным, этот режим сохраняет белые пиксели за счет черных пикселей. |
Возвращаемое значение
Если функция выполнена успешно, возвращается значение предыдущего режима растяжения.
Если функция выполняется неудачно, возвращается нулевое значение.
Эта функция может возвращать следующее значение.
| Код возврата | Описание |
|---|---|
|
Один или несколько входных параметров недопустимы. |
Комментарии
Режим растяжения определяет, как система объединяет строки или столбцы растрового изображения с существующими пикселями на устройстве отображения, когда приложение вызывает функцию StretchBlt .
Режимы BLACKONWHITE (STRETCH_ANDSCANS) и WHITEONBLACK (STRETCH_ORSCANS) обычно используются для сохранения пикселей переднего плана в монохромных растровых изображениях. Режим COLORONCOLOR (STRETCH_DELETESCANS) обычно используется для сохранения цвета в цветовых растровых изображениях.
Режим HALFTONE работает медленнее и требует больше обработки исходного изображения, чем в трех других режимах; но создает изображения более высокого качества. Кроме того, обратите внимание, что setBrushOrgEx необходимо вызывать после настройки режима HALFTONE, чтобы избежать неправильного сосогласования кисти.
Дополнительные режимы растяжения также могут быть доступны в зависимости от возможностей драйвера устройства.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |