Fonction ColorMatchToTarget (wingdi.h)

Article
08/27/2023

La fonction ColorMatchToTarget vous permet d’afficher un aperçu des couleurs telles qu’elles apparaissent sur l’appareil cible.

Syntaxe

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Paramètres

hdc

Spécifie le contexte de l’appareil pour l’aperçu, généralement l’écran.

hdcTarget

Spécifie le contexte de l’appareil cible, généralement une imprimante.

action

Constante qui peut avoir l’une des valeurs suivantes.

Valeur	Signification
CS_ENABLE	Mappez les couleurs à la gamme de couleurs de l’appareil cible. Cela permet la vérification des couleurs. Toutes les commandes de dessin suivantes sur le contrôleur de domaine affichent les couleurs telles qu’elles apparaissent sur l’appareil cible.
CS_DISABLE	Désactivez la vérification des couleurs.
CS_DELETE_TRANSFORM	Si la gestion des couleurs est activée pour le profil cible, désactivez-la et supprimez la transformation concaténée.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE.

Remarques

ColorMatchToTarget peut être utilisé pour vérifier les couleurs d’un périphérique de sortie de couleur sur un autre périphérique de sortie de couleur. Si vous définissez le paramètre uiAction sur CS_ENABLE, toutes les commandes de dessin suivantes sur le contrôleur de domaine affichent les couleurs telles qu’elles apparaissent sur l’appareil cible. Si uiAction est défini sur CS_DISABLE, la vérification est désactivée. Toutefois, la transformation de couleur actuelle n’est pas supprimée du contrôleur de domaine. Il est juste inactif.

Lorsque ColorMatchToTarget est appelé, la transformation de couleur de l’appareil cible est effectuée en premier, puis la transformation vers l’appareil en préversion est appliquée aux résultats de la première transformation. Il est principalement utilisé pour vérifier les conditions de mappage de gamut. Avant d’utiliser cette fonction, vous devez activer WCS pour les deux contextes d’appareil.

Cette fonction ne peut pas être mise en cascade. Alors que le mappage des couleurs à la cible est activé en définissant uiAction sur CS_ENABLE, les modifications apportées à l’espace de couleurs ou à la méthode de mappage de gamuts sont ignorées. Ces modifications prennent ensuite effet lorsque le mappage de couleurs à la cible est désactivé.

Note Une fuite de mémoire ne se produit pas si une application ne supprime pas de transformation à l’aide de CS_DELETE_TRANSFORM. La transformation est supprimée lorsque le contexte de l’appareil (DC) est fermé ou lorsque l’espace de couleur de l’application est supprimé. Toutefois, si la transformation ne va pas être réutilisée, ou si l’application n’effectue plus de correspondance de couleurs sur le contrôleur de domaine, elle doit supprimer explicitement la transformation pour libérer la mémoire qu’elle occupe.

Le paramètre uiAction ne doit être défini sur CS_DELETE_TRANSFORM que si la gestion des couleurs est activée avant l’appel de la fonction ColorMatchToTarget .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Share via