Функция SetStretchBltMode

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz