Partager via

CreateColorTransformA, fonction (icm.h)

  • Article

Crée une transformation de couleur que les applications peuvent utiliser pour effectuer la gestion des couleurs.

Syntaxe

HTRANSFORM CreateColorTransformA(
  LPLOGCOLORSPACEA pLogColorSpace,
  HPROFILE         hDestProfile,
  HPROFILE         hTargetProfile,
  DWORD            dwFlags
);

Paramètres

pLogColorSpace

Pointeur vers l’entrée LOGCOLORSPACEA.

hDestProfile

Gérez le profil de l’appareil de destination. La fonction détermine si le HPROFILE contient des informations de profil ICC (International Color Consortium) ou Windows Color System (WCS).

hTargetProfile

Gérez le profil de l’appareil cible. La fonction détermine si le fichier HPROFILE contient des informations de profil ICC ou WCS.

dwFlags

Spécifie les indicateurs pour utiliser la création de contrôle de la transformation. Consultez la section Notes.

Valeur de retour

Si cette fonction réussit, la valeur de retour est un handle de la transformation de couleur.

Si cette fonction échoue, la valeur de retour est NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si le profil cible est NULL, la transformation va de l’espace de couleurs logique source au profil de destination. Si le profil cible est donné, la transformation passe de l’espace de couleurs logique source au profil cible, puis au profil de destination. Cela permet d’afficher un aperçu de la sortie destinée à l’appareil cible sur l’appareil de destination.

Les valeurs dans dwFlags sont destinées uniquement à des indicateurs. Le module de gestion des couleurs doit déterminer la meilleure façon de les utiliser.

Windows Vista : trois nouveaux indicateurs ont été ajoutés et peuvent être utilisés avec dwFlags :

Indicateur Description
PRESERVEBLACK Si ce bit est défini, le moteur de transformation insère le GMMP de génération noire approprié comme dernier GMMP dans la séquence de transformation. Cet indicateur fonctionne uniquement dans une transformation WCS pure.
SEQUENTIAL_TRANSFORM Si ce bit est défini, chaque étape du pipeline de traitement WCS est effectuée pour chaque pixel de l’image et aucune transformation de couleur optimisée n’est générée. Cet indicateur fonctionne uniquement dans une transformation WCS pure. Restrictions : une transformation créée avec le jeu d’indicateurs SEQUENTIAL_TRANSFORM ne peut être utilisée que dans le thread sur lequel elle a été créée et uniquement pour un seul appel de traduction de couleur à la fois. COM doit être initialisé avant de créer la transformation séquentielle et doit rester initialisé pendant toute la durée de vie de l’objet transform.
WCS_ALWAYS Si ce bit est défini, même les transformations toutes ICC utilisent le chemin de code WCS.

Notes

SEQUENTIAL_TRANSFORM a été omis par inadvertance de l’en-tête icm.h dans le Kit de développement logiciel (SDK) Windows Vista. Si vous souhaitez utiliser l’indicateur SEQUENTIAL_TRANSFORM , définissez-le dans votre application comme suit :#define SEQUENTIAL_TRANSFORM 0x80800000

Pour plus d’informations, consultez Indicateurs de création de transformation CMM. Tous les indicateurs mentionnés ici sont pris en charge pour tous les types de transformations, à l’exception de FAST_TRANSLATE, qui fonctionne uniquement dans une transformation ICC-to-ICC pure.

La fonction CreateColorTransform est utilisée en dehors d’un contexte d’appareil. Les couleurs peuvent changer lors de la transformation d’un profil de couleur vers le même profil de couleur. Cela est dû à des erreurs de précision. Par conséquent, une transformation de couleur ne doit pas être effectuée dans ces circonstances.

Les balises B2Ax sont requises pour tout profil qui est la cible d’une transformation.

La prise en charge de la transformation WCS pour les profils Icc ColorSpace est limitée aux profils d’espace de couleurs RVB. Les types de profils ICC suivants ne peuvent pas être utilisés dans une transformation traitée CITE, soit une transformation MIXTE WCS/ICC, soit une transformation icc avec WCS_ALWAYS défini :

  • Profils ColorSpace non RVB
  • Profils NamedColor
  • profils n-canal (où n8 > )
  • Profils DeviceLink
  • Profils abstraits

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]
En-tête icm.h
Bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi