Поделиться через


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

Функция DrvDitherColor запрашивает у устройства создание кисти, обтекаемой палитрой устройства.

Синтаксис

ULONG DrvDitherColor(
  [in]      DHPDEV dhpdev,
  [in]      ULONG  iMode,
  [in]      ULONG  rgb,
  [in, out] ULONG  *pul
);

Параметры

[in] dhpdev

Дескриптор структуры PDEV, описывающей физическое устройство, палитры которого должны быть рассечены по заданному цвету.

[in] iMode

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

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

[in] rgb

Задает цвет RGB, который должен быть размечен.

[in, out] pul

Указатель на расположение памяти, которое получает сведения о перемыках. Память должна быть выделена для растрового изображения стандартного формата с размерами кисти cxDither от cyDither. Эти измерения являются членами структуры DEVINFO . Формат растрового изображения определяется элементом iDitherFormat структуры DEVINFO.

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

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

Комментарии

Результатом dither является набор цветовых индексов устройства, хранящихся в пуле. Кисть, созданная с использованием этих цветов для своего узора, должна быть хорошим приближением заданного цветового rgb.

DrvDitherColor — это необязательная функция, которая вызывается только в том случае, если cxDither и cyDither не являются нулевыми. Драйверы монохромных устройств, включая большинство растровых принтеров, должны использовать параметр iMode , чтобы сообщить GDI, как получить хорошие серые шаблоны.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть winddi.h (включая Winddi.h)

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

DEVINFO

DrvEnablePDEV