Funzione DrvDitherColor (winddi.h)

  • Articolo

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)

Vedi anche

DEVINFO

DrvEnablePDEV