Função DrvDitherColor (winddi.h)
A função DrvDitherColor solicita que o dispositivo crie um pincel dithered em uma paleta de dispositivos.
Sintaxe
ULONG DrvDitherColor(
[in] DHPDEV dhpdev,
[in] ULONG iMode,
[in] ULONG rgb,
[in, out] ULONG *pul
);
Parâmetros
[in] dhpdev
Manipule para a estrutura PDEV que descreve o dispositivo físico em relação a cujas paletas a cor especificada deve ser dithered.
[in] iMode
Determina a paleta com a qual dither. Esse parâmetro pode usar um dos valores a seguir:
| Valor | Significado |
|---|---|
| DM_DEFAULT | O driver deve criar um dither para o espaço de cores nativo e padrão do dispositivo. Por exemplo, se o dispositivo estiver em execução em 16bpp, o dither resultante deverá estar em um formato de 16bpp. |
| DM_MONOCHROME | O driver deve criar o dither para espaço de cor monocromático; ou seja, o dither deve ser retornado como um bitmap de 1bpp. |
[in] rgb
Especifica a cor RGB que deve ser dithered.
[in, out] pul
Ponteiro para o local de memória que recebe as informações de dithering. A memória deve ter sido alocada para um bitmap de formato padrão com dimensões de pincel dithered cxDither por cyDither. Essas dimensões são membros da estrutura DEVINFO . O formato bitmap é determinado pelo membro iDitherFormat da estrutura DEVINFO.
Retornar valor
O valor retornado será DCR_DRIVER se os valores de dither tiverem sido calculados pelo driver, DCR_SOLID se o mecanismo deve usar a melhor aproximação de cores sólidas da cor ou DCR_HALFTONE se o mecanismo deve criar uma aproximação de meio tom para o driver.
Comentários
O resultado do dither é um conjunto de índices de cor do dispositivo armazenados em pul. Um pincel criado usando essas cores para seu padrão deve ser uma boa aproximação da cor rgb fornecida.
DrvDitherColor é uma função opcional que é chamada somente se cxDither e cyDither forem diferentes de zero. Drivers de dispositivo monocromáticos, incluindo a maioria das impressoras de varredura, devem usar o parâmetro iMode para informar à GDI como obter bons padrões de escala cinza.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winddi.h (inclua Winddi.h) |