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