CmCreateMultiProfileTransform, fonction (icm.h)

Article
08/24/2023

Accepte un tableau de profils ou un profil de liaison d’appareil unique et crée une transformation de couleur. Cette transformation est un mappage de l’espace de couleurs spécifié par le premier profil à celui du deuxième profil, et ainsi de suite, au dernier.

Syntaxe

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

Paramètres

pahProfiles

Pointe vers un tableau de handles de profil.

nProfiles

Spécifie le nombre de profils dans le tableau.

padwIntents

Pointe vers un tableau d’intentions de rendu. Chaque intention de rendu est représentée par l’une des valeurs suivantes :

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Pour plus d’informations, consultez Intentions de rendu.

nIntents

Spécifie le nombre d’intentions dans le tableau d’intentions. Peut être 1 ou la même valeur que nProfiles.

dwFlags

Spécifie les indicateurs à utiliser pour la création de contrôle de la transformation. Pour plus d’informations, consultez Indicateurs de création de transformation CMM.

Valeur retournée

Si cette fonction réussit, la valeur de retour est une transformation de couleur dans la plage de 256 à 65 535. Étant donné que seul le mot faible de la transformation est conservé, les transformations valides ne peuvent pas dépasser cette plage.

Si cette fonction échoue, la valeur de retour est un code d’erreur dont la valeur est inférieure à 256. Lorsque la valeur de retour est inférieure à 256, signalant une erreur, la CMM doit utiliser SetLastError pour définir la dernière erreur sur une valeur d’erreur valide, comme défini dans Winerror.h.

Notes

Chaque CMM est nécessaire pour exporter cette fonction.

Le tableau d’intentions spécifie la façon dont les profils doivent être combinés. La nièmeintention est utilisée pour combiner le nièmeprofil dans le tableau. Si une seule intention est spécifiée, elle est utilisée pour le premier profil et tous les autres profils sont combinés à l’aide de l’intention De correspondance.

Les descripteurs de profil utilisés pour créer la transformation de couleur peuvent être fermés une fois l’appel à CMCreateMultiProfileTransform terminé.

Configuration requise


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

Partager via