EngDitherColor-Funktion (winddi.h)
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 |