Partager via

WcsCreateIccProfile, fonction (icm.h)

  • Article

Convertit un profil WCS en profil ICC (International Color Consortium).

Syntaxe

HPROFILE WcsCreateIccProfile(
  HPROFILE hWcsProfile,
  DWORD    dwOptions
);

Paramètres

hWcsProfile

Handle dans le profil de couleur WCS qui est converti. Consultez la section Notes.

dwOptions

Valeur d’indicateur qui spécifie les options de conversion de profil.

Par défaut, les profils WCS d’origine utilisés pour la conversion sont incorporés dans le profil ICC de sortie dans une balise privée Microsoft, WcsProfilesTag (avec la signature « MS000 ». Cela produit un profil ICC compatible avec le logiciel ICC, tout en conservant les données de profil WCS d’origine disponibles pour le code conçu pour l’analyser.

Les valeurs possibles de ce paramètre sont les suivantes. Tous les bits non définis dans cette liste sont réservés et doivent être définis sur zéro :

Valeur Description
WCS_DEFAULT Spécifie que le nouveau profil ICC contient le profil WCS d’origine dans un WcsProfilesTag privé.
WCS_ICCONLY Spécifie que le nouveau profil ICC ne contient ni le WcsProfilesTag ni le profil WCS d’origine.

Valeur retournée

Si cette fonction réussit, la valeur de retour est le handle du nouveau profil de couleur.

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

Notes

Cette fonction peut être utilisée avec des chaînes ASCII ou Unicode.

La fonction CloseColorProfile doit être utilisée pour fermer le handle HPROFILE retourné lorsqu’il n’est plus nécessaire.

Les fichiers DMP, CAMP et GMMP du HPROFILE sont incorporés dans une balise privée dans le profil ICC créé.

Le profil ICC créé à l’aide de cette API verra sa balise de description de profil construite à partir des éléments ProfileName des profils WCS selon le modèle suivant : « Créé par Microsoft WCS à partir de DMP:[le DMP ProfileName], CAMP:[le PROFILNAME CAMP], GMMP:[le profil GMMPName] »

Lorsque WCS rencontre ce profil ICC (via OpenColorProfileW ou WcsOpenColorProfileW ), il extrait et utilise le ou les profils WCS contenus dans le WcsProfilesTag.

Les informations hors gamut dans les étiquettes gamut créées dans WCS utilisent la distance de couleur perceptive dans CIECAM02, qui est la racine carrée moyenne dans l’espace Jab CIECAM02. La distance dans les balises de gamut de profil ICC héritées est la racine carrée moyenne dans l’espace CIELAB. Il est recommandé d’utiliser l’espace CIECAM02 lorsqu’il est disponible pour fournir des métriques de distance plus précises.

WCS extrait et utilise le profil WCS d’origine au moyen d’un profil XML explicitement associé à un appareil, ou d’un profil ICC doté d’unWcsProfilesTag.

WcsProfilesTag est une balise de profil ICC privée Microsoft utilisée dans les profils créés par WcsCreateIccProfile pour contenir l’entrée des profils WCS dans WcsCreateIccProfile. Cette balise est conforme aux exigences de profil ICC pour les balises de profil. Les composants non XML de la balise doivent être dans l’ordre d’octets « Big-Endian », qui est standard pour les profils ICC. En outre, les données de balise doivent être alignées sur une limite de 4 octets (mesurées à partir du début du profil ICC). La structure de la balise est définie par le WcsProfilesTagType ci-dessous. Notez que les composants XML de la balise, les profils WCS contenus dans WcsProfileTag, sont laissés dans leur ordre d’octet natif, qui peut être soit petit-endien soit big-endian, car les analyseurs XML traitent correctement l’un ou l’autre.

La signature WcsProfilesTag est « MS00 ». Il s’agit de la signature de balise qui apparaîtra dans la table de balises de profils ICC pour le WcsProfilesTag.

La structure WcsProfilesTagType a la structure suivante :

Décalage d’octet Contenu
0-3 Signature de type MS10.
4-7 Réservé, doit être défini sur 0 (tradition ICC).
8-11 Décalage d’octet entre le début de la balise et les données CDMP.
12-15 Taille des données CDMP en octets.
16-19 Décalage d’octet entre le début de la balise et les données CAMP.
20-23 Taille des données CAMP en octets.
24-27 Décalage d’octet entre le début de la balise et les données GMMP.
28-31 Décalage d’octet entre le début de la balise et les données GMMP.
31-n Séquence d’octets (taille d’élément -32) [où la taille de l’élément correspond à la taille de balise enregistrée dans l’entrée de la table de balise de profil ICC pour cette balise.]

Il s’agit des profils XML WCS utilisés par WcsCreateIccProfile pour créer ce profil ICC. Les profils WCS sont triés : d’abord le DMP (obligatoire), suivi du CAMP (le cas échéant), suivi du GMMP (le cas échéant).

Spécifications

   
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