Funzione DrvDitherColor (winddi.h)
La funzione DrvDitherColor richiede al dispositivo di creare un pennello dithered su una tavolozza del dispositivo.
Sintassi
ULONG DrvDitherColor(
[in] DHPDEV dhpdev,
[in] ULONG iMode,
[in] ULONG rgb,
[in, out] ULONG *pul
);
Parametri
[in] dhpdev
Handle per la struttura PDEV che descrive il dispositivo fisico in base alle cui tavolozze deve essere ditherato il colore specificato.
[in] iMode
Determina la tavolozza da cui eseguire la dithering. Questo parametro può essere uno dei valori seguenti:
| Valore | Significato |
|---|---|
| DM_DEFAULT | Il driver deve creare un dither per lo spazio colore nativo e predefinito del dispositivo. Ad esempio, se il dispositivo è in esecuzione a 16bpp, il dither risultante deve essere in formato 16bpp. |
| DM_MONOCHROME | Il driver deve creare il dither per lo spazio colore monocromatico; ovvero, il dither deve essere restituito come bitmap di 1bpp. |
[in] rgb
Specifica il colore RGB da dithering.
[in, out] pul
Puntatore alla posizione di memoria che riceve le informazioni di dithering. La memoria deve essere stata allocata per una bitmap in formato standard con dimensioni pennello dithering cxDither da cyDither. Queste dimensioni sono membri della struttura DEVINFO . Il formato bitmap è determinato dal membro iDitherFormat della struttura DEVINFO.
Valore restituito
Il valore restituito è DCR_DRIVER se i valori dither sono stati calcolati dal driver, DCR_SOLID se il motore deve utilizzare la migliore approssimazione del colore a tinta unita o DCR_HALFTONE se il motore deve creare un'approssimazione mezzotona per il driver.
Commenti
Il risultato del dither è un set di indici di colore del dispositivo archiviati in pul. Un pennello creato usando questi colori per il motivo deve essere una buona approssimazione del colore rgb specificato.
DrvDitherColor è una funzione facoltativa chiamata solo se cxDither e cyDither sono diversi da zero. I driver di dispositivo monocromatici, inclusa la maggior parte delle stampanti raster, devono usare il parametro iMode per indicare a GDI come ottenere modelli di scala grigia validi.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winddi.h (include Winddi.h) |