Fonction EngDitherColor (winddi.h)
La fonction EngDitherColor retourne un dither 8x8 standard qui se rapproche de la couleur RVB spécifiée.
Syntaxe
ENGAPI ULONG EngDitherColor(
HDEV hdev,
ULONG iMode,
ULONG rgb,
ULONG *pul
);
Paramètres
hdev
Gérez l’appareil. Il s’agit du handle que GDI a passé à DrvCompletePDEV.
iMode
Détermine la palette sur laquelle GDI doit faire l’objet d’une requête. Ce paramètre peut être l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| DM_DEFAULT | Demande à GDI de créer un dither pour l’espace de couleurs par défaut natif de l’appareil. Par exemple, si l’appareil s’exécute à 16bpp, le dither résultant est au format 16bpp. |
| DM_MONOCHROME | Demande que GDI crée le dither pour l’espace de couleur monochrome ; autrement dit, le dither est retourné sous la forme d’une bitmap 1bpp. |
rgb
Spécifie la couleur RVB qui doit être tergiversée. GDI ignore l’octet élevé de cette valeur ULONG.
pul
Pointeur vers l’emplacement de mémoire dans lequel GDI retourne les informations de tramage. Le pilote doit avoir alloué de la mémoire pour une bitmap de format standard avec des dimensions de pinceau de 8x8. Le pilote doit également définir les membres cxDither et cyDither de la structure DEVINFO sur 8.
Valeur retournée
La valeur de retour est DCR_DRIVER si les valeurs de trame ont été calculées par le pilote, ou DCR_SOLID si le moteur doit utiliser la meilleure approximation de couleur unie de la couleur.
Remarques
EngDitherColor peut être appelé pour les bitmaps de 8bpp ou plus.
Configuration requise
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |