EngDitherColor-Funktion (winddi.h)

Artikel
08/27/2023

Die EngDitherColor-Funktion gibt einen Standardmäßigen 8x8-Dither zurück, der der angegebenen RGB-Farbe entspricht.

Syntax

ENGAPI ULONG EngDitherColor(
  HDEV  hdev,
  ULONG iMode,
  ULONG rgb,
  ULONG *pul
);

Parameter

hdev

Handle mit dem Gerät. Dies ist der Handle, den GDI an DrvCompletePDEV übergeben hat.

iMode

Bestimmt die Palette, für die GDI dithern soll. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
DM_DEFAULT	Fordert an, dass GDI einen Dither für den nativen Standardfarbraum des Geräts erstellt. Wenn das Gerät beispielsweise mit 16bpp ausgeführt wird, hat das resultierende Dither ein 16bpp-Format.
DM_MONOCHROME	Fordert an, dass GDI den Dither für monochromen Farbraum erstellt; Das heißt, der Dither wird als 1-Bit-Bitmap zurückgegeben.

rgb

Gibt die RGB-Farbe an, die ditheriert werden soll. GDI ignoriert das hohe Byte dieses ULONG-Werts.

pul

Zeiger auf den Speicherspeicherort, an dem GDI die Ditheringinformationen zurückgibt. Der Treiber muss Arbeitsspeicher für eine Bitmap im Standardformat mit ditherierten Pinseldimensionen von 8x8 zugewiesen haben. Der Treiber muss auch die cxDither - und cyDither-Member der DEVINFO-Struktur auf 8 festlegen.

Rückgabewert

Der Rückgabewert ist DCR_DRIVER, wenn die Ditherwerte vom Treiber berechnet wurden, oder DCR_SOLID, wenn das Modul die beste Farbannäherung der Farbe verwenden soll.

Hinweise

EngDitherColor kann für Bitmaps aufgerufen werden, die mindestens 8bpp sind.

Anforderungen


Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

DrvRealizeBrush

Share via