Función DrvDitherColor (winddi.h)
La función DrvDitherColor solicita al dispositivo que cree un pincel anclado en una paleta de dispositivos.
Sintaxis
ULONG DrvDitherColor(
[in] DHPDEV dhpdev,
[in] ULONG iMode,
[in] ULONG rgb,
[in, out] ULONG *pul
);
Parámetros
[in] dhpdev
Controle la estructura PDEV que describe el dispositivo físico con cuyas paletas se debe atar el color especificado.
[in] iMode
Determina la paleta con la que se va a ditrar. Este parámetro puede ser uno de los valores siguientes:
| Valor | Significado |
|---|---|
| DM_DEFAULT | El controlador debe crear un dither para el espacio de color nativo predeterminado del dispositivo. Por ejemplo, si el dispositivo se ejecuta en 16bpp, el dither resultante debe tener un formato de 16bpp. |
| DM_MONOCHROME | El controlador debe crear el dither para el espacio de color monocromático; es decir, el dither debe devolverse como un mapa de bits de 1bpp. |
[in] rgb
Especifica el color RGB que se va a ditrar.
[in, out] pul
Puntero a la ubicación de memoria que recibe la información de dithering. La memoria debe haberse asignado para un mapa de bits de formato estándar con dimensiones de pincel dither cxDither por cyDither. Estas dimensiones son miembros de la estructura DEVINFO . El formato de mapa de bits viene determinado por el miembro iDitherFormat de la estructura DEVINFO.
Valor devuelto
El valor devuelto es DCR_DRIVER si el controlador ha calculado los valores de dither, DCR_SOLID si el motor debe usar la mejor aproximación de color sólido del color o DCR_HALFTONE si el motor debe crear una aproximación de tono medio para el controlador.
Comentarios
El resultado del dither es un conjunto de índices de color del dispositivo almacenados en pul. Un pincel creado con estos colores para su patrón debe ser una buena aproximación del color rgb dado.
DrvDitherColor es una función opcional que se llama solo si cxDither y cyDither no son cero. Los controladores de dispositivos monocromáticos, incluidas la mayoría de las impresoras ráster, deben usar el parámetro iMode para indicar a GDI cómo obtener buenos patrones de escala de grises.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |