DrvDitherColor-Funktion (winddi.h)

Artikel
03/04/2024

Die DrvDitherColor-Funktion fordert das Gerät auf, einen Pinsel für eine Gerätepalette zu erstellen.

Syntax

ULONG DrvDitherColor(
  [in]      DHPDEV dhpdev,
  [in]      ULONG  iMode,
  [in]      ULONG  rgb,
  [in, out] ULONG  *pul
);

Parameter

[in] dhpdev

Handle für die PDEV-Struktur, die das physische Gerät beschreibt, für dessen Paletten die angegebene Farbe dithered werden soll.

[in] iMode

Bestimmt die Palette, für die die Abzweigung ausgeführt werden soll. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
DM_DEFAULT	Der Treiber sollte einen Dither für den nativen Standardfarbraum des Geräts erstellen. Wenn das Gerät beispielsweise mit 16bpp ausgeführt wird, sollte der resultierende Dither im 16bpp-Format vorliegen.
DM_MONOCHROME	Der Treiber sollte den Dither für monochromen Farbraum erstellen. Das heißt, der Dither sollte als 1bpp-Bitmap zurückgegeben werden.

[in] rgb

Gibt die RGB-Farbe an, die ditheriert werden soll.

[in, out] pul

Zeiger auf den Speicherort des Arbeitsspeichers, der die Ditheringinformationen empfängt. Arbeitsspeicher muss für eine Bitmap im Standardformat mit ditherierten Pinselabmessungen cxDither by cyDither zugewiesen worden sein. Diese Dimensionen sind Elemente der DEVINFO-Struktur . Das Bitmapformat wird durch den iDitherFormat-Member der DEVINFO-Struktur bestimmt.

Rückgabewert

Der Rückgabewert ist DCR_DRIVER, wenn die Ditherwerte vom Treiber berechnet wurden, DCR_SOLID, wenn die Engine die beste Volltonfarbenangleichung der Farbe verwenden soll, oder DCR_HALFTONE, wenn die Engine eine Halbtonangleichung für den Treiber erstellen soll.

Hinweise

Das Ergebnis des Dithers ist eine Reihe von Gerätefarbindizes, die in pul gespeichert sind. Ein Pinsel, der mit diesen Farben für sein Muster erstellt wurde, sollte eine gute Näherung der angegebenen Farbe RGB sein.

DrvDitherColor ist eine optionale Funktion, die nur aufgerufen wird, wenn cxDither und cyDither ungleich null sind. Monochrome Gerätetreiber, einschließlich der meisten Rasterdrucker, sollten den iMode-Parameter verwenden, um GDI mitzuteilen, wie gute Graustufenmuster abgerufen werden.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	winddi.h (einschließlich Winddi.h)

Weitere Informationen

DEVINFO

DrvEnablePDEV

Freigeben über