Fonction DrvDitherColor (winddi.h)

Article
03/04/2024

La fonction DrvDitherColor demande à l’appareil de créer un pinceau avec une palette d’appareils.

Syntaxe

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

Paramètres

[in] dhpdev

Gérez la structure PDEV qui décrit l’appareil physique par rapport aux palettes dont la couleur spécifiée doit être tergiversée.

[in] iMode

Détermine la palette sur laquelle il faut passer. Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
DM_DEFAULT	Le pilote doit 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 doit être au format 16bpp.
DM_MONOCHROME	Le pilote doit créer le dither pour l’espace de couleur monochrome ; autrement dit, le dither doit être retourné en tant que bitmap 1bpp.

[in] rgb

Spécifie la couleur RVB qui doit être tergiversée.

[in, out] pul

Pointeur vers l’emplacement de mémoire qui reçoit les informations de tramage. La mémoire doit avoir été allouée pour une image bitmap de format standard avec des dimensions de pinceau ditcé cxDither par cyDither. Ces dimensions sont membres de la structure DEVINFO . Le format bitmap est déterminé par le membre iDitherFormat de la structure DEVINFO.

Valeur retournée

La valeur de retour est DCR_DRIVER si les valeurs de trame ont été calculées par le pilote, DCR_SOLID si le moteur doit utiliser la meilleure approximation de couleur unie de la couleur, ou DCR_HALFTONE si le moteur doit créer une approximation en demi-teinte pour le pilote.

Remarques

Le résultat du dither est un ensemble d’index de couleur d’appareil stockés dans pul. Un pinceau créé à l’aide de ces couleurs pour son motif doit être une bonne approximation de la couleur rvb donnée.

DrvDitherColor est une fonction facultative appelée uniquement si cxDither et cyDither ne sont pas nuls. Les pilotes de périphériques monochromes, y compris la plupart des imprimantes raster, doivent utiliser le paramètre iMode pour indiquer à GDI comment obtenir de bons modèles d’échelle de gris.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

DEVINFO

DrvEnablePDEV

Partager via