Функция SetStretchBltMode (wingdi.h)

  • Статья

Функция SetStretchBltMode задает режим растягивания растрового рисунка в указанном контексте устройства.

Синтаксис

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] mode

Режим растяжения. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
BLACKONWHITE
 Выполняет логическую операцию AND, используя значения цвета для исключенных и существующих пикселей. Если растровое изображение является монохромным, в этом режиме черные пиксели сохраняются за счет белых пикселей.
COLORONCOLOR
 Удаляет пиксели. В этом режиме удаляются все исключенные строки пикселей, не пытаясь сохранить их сведения.
ПОЛУТОНАХ
 Сопоставляет пиксели из исходного прямоугольника в блоки пикселей в целевом прямоугольнике. Средний цвет по целевому блоку пикселей соответствует цвету исходных пикселей.

После настройки режима растягивания HALFTONE приложение должно вызвать функцию SetBrushOrgEx , чтобы задать источник кисти. Если это не удается сделать, происходит несоответствие кисти.
STRETCH_ANDSCANS
 То же, что и BLACKONWHITE.
STRETCH_DELETESCANS
 То же, что и COLORONCOLOR.
STRETCH_HALFTONE
 То же, что и HALFTONE.
STRETCH_ORSCANS
 То же, что и WHITEONBLACK.
WHITEONBLACK
 Выполняет логическую операцию OR, используя значения цвета для исключенных и существующих пикселей. Если растровое изображение является монохромным, этот режим сохраняет белые пиксели за счет черных пикселей.

Возвращаемое значение

Если функция выполнена успешно, возвращается значение предыдущего режима растяжения.

Если функция выполняется неудачно, возвращается нулевое значение.

Эта функция может возвращать следующее значение.

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один или несколько входных параметров недопустимы.

Комментарии

Режим растяжения определяет, как система объединяет строки или столбцы растрового изображения с существующими пикселями на устройстве отображения, когда приложение вызывает функцию 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

См. также раздел

Функции точечных рисунков

Общие сведения о точечных изображениях

GetStretchBltMode

SetBrushOrgEx

StretchBlt