Функция EngDitherColor (winddi.h)

Функция EngDitherColor возвращает стандартный индикатор 8x8, который приблизительно соответствует указанному цвету RGB.

Синтаксис

ENGAPI ULONG EngDitherColor(
  HDEV  hdev,
  ULONG iMode,
  ULONG rgb,
  ULONG *pul
);

Параметры

hdev

Дескриптор устройства. Это дескриптор, который GDI передает в DrvCompletePDEV.

iMode

Определяет палитру, к которому должен применяться GDI. Этот параметр может иметь одно из следующих значений:

Значение	Значение
DM_DEFAULT	Запрашивает, чтобы GDI создавал устройство для собственного цветового пространства устройства по умолчанию. Например, если устройство работает со значением 16bpp, результирующий dither имеет формат 16bpp.
DM_MONOCHROME	Запрашивает, чтобы GDI создавал дизер для монохромного цветового пространства; то есть dither возвращается в виде растрового изображения 1bpp.

rgb

Задает цвет RGB, который должен быть размечен. GDI игнорирует высокий байт этого значения ULONG.

pul

Указатель на расположение памяти, в котором GDI возвращает сведения о спадах. Драйвер должен иметь выделенную память для растрового изображения стандартного формата с размерами кисти 8x8. Драйвер также должен задать для элементов cxDither и cyDither структуры DEVINFO значение 8.

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

Возвращаемое значение DCR_DRIVER, если значения dither были вычислены драйвером, или DCR_SOLID, если подсистема должна использовать наилучшее приближение цвета сплошного цвета.

Комментарии

EngDitherColor можно вызвать для растровых изображений, которые имеют значение 8bpp или выше.

Требования

Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys

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

DrvRealizeBrush