Share via

Función DrvDitherColor (winddi.h)

  • Artículo

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)

Consulte también

DEVINFO

DrvEnablePDEV