Функция SetStretchBltMode устанавливает режим растяжения точечного рисунка в заданном контексте устройства.
Синтаксис
int SetStretchBltMode( HDC hdc, // дескриптор DC int iStretchMode // режим растяжения рисунка ); |
Параметры
hdc
[in] Дескриптор контекста устройства.iStretchMode
[in] Определяет режим растяжения. Этот параметр может быть одним из нижеперечисленных значений.
| Значение | Предназначение |
|---|---|
| BLACKONWHITE | Выполняет булеву операцию И (AND), используя коды цвета для ликвидируемых и существующих пикселей. Если точечный рисунок - одноцветный битовый образ, этот режим сохраняет черные пиксели за счет белых пикселей. |
| COLORONCOLOR | Удаляет пиксели. Этот режим удаляет все ликвидируемые строки пикселей, не пытаясь сберечь их информацию. |
| HALFTONE | Преобразует
пиксели исходного прямоугольника в
блоки пикселей в целевом
прямоугольнике. Среднее значение цвета
всего целевого блока пикселей
подбирается близким по значению к
цвету исходных пикселей.
После установки режима растяжения HALFTONE , приложение должно вызвать функцию SetBrushOrgEx, чтобы установить начало координат кисти. Если она завершается ошибкой, то происходит нарушение границ кисти Этот параметр не поддерживается в среде Windows 95/98/Me. |
| STRETCH_ANDSCANS | Такое же как и BLACKONWHITE. |
| STRETCH_DELETESCANS | Такое же как и COLORONCOLOR. |
| STRETCH_HALFTONE | Такое же как и HALFTONE. |
| STRETCH_ORSCANS | Такое же как и WHITEONBLACK. |
| WHITEONBLACK | Выполняет булеву операцию ИЛИ (OR), используя коды цвета ликвидируемых и существующих пикселей. Если точечный рисунок - одноцветный битовый образ, этот режим сохраняет белые пиксели за счет черных пикселей. |
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - предшествующий режим растяжения.
Если функция завершается с ошибкой, величина возвращаемого значения - нуль.
Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError. Это может быть значением следующим ниже.
| Значение | Предназначение |
|---|---|
| ERROR_INVALID_PARAMETER | Один или несколько введенных параметров неправильные. |
Замечания
Режим растяжения определяет, как система комбинирует ряды или столбцы точечного рисунка с существующими пикселями в устройстве отображения, когда приложение вызывает функцию StretchBlt.
Режимы BLACKONWHITE (STRETCH_ANDSCANS) и WHITEONBLACK (STRETCH_ORSCANS), обычно используются для, сбережения пикселей изображения в монохромных точечных рисунках. Режим COLORONCOLOR (STRETCH_DELETESCANS) обычно используется для, сбережения точечных рисунков цвет в цвет.
Режим HALFTONE медленнее и требует большей обработки исходного изображения, чем остальные три режима; но создает изображение более высокого качества.
|
Обратите внимание! также на то, что функция SetBrushOrgEx должна вызваться после того, как установка режима HALFTONE отменит смещение границ кисти. |
Дополнительные режимы растяжения могут бы также быть доступны в зависимости от возможностей драйвера устройства.
Смотри также
Обзор Точечные рисунки, Функции, используемые точечными рисунками, GetStretchBltMode, SetBrushOrgEx, StretchBlt
|
Размещение и совместимость SetStretchBltMode |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |