CmGetPS2ColorRenderingIntent, fonction (icm.h)

Article
02/26/2024

Récupère l’intention de rendu des couleurs PostScript niveau 2 à partir d’un profil.

Syntaxe

BOOL CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  LPBYTE   lpBuffer,
  LPDWORD  lpcbSize
);

Paramètres

hProfile

Spécifie le profil à utiliser.

dwIntent

Spécifie l’intention de rendu souhaitée à récupérer. Peut avoir l’une des valeurs suivantes :

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Pour plus d’informations, consultez Rendu des intentions.

lpBuffer

Pointe vers une mémoire tampon dans laquelle l’intention de rendu des couleurs doit être placée. Si le pointeur a la valeur NULL, la fonction retourne la taille requise pour cette mémoire tampon dans *lpcbSize.

lpcbSize

Pointe vers une variable spécifiant la taille de la mémoire tampon. Au retour, la variable contient le nombre d’octets réellement copiés dans la mémoire tampon.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE. Elle retourne également TRUE si elle est appelée avec lpBuffer définie sur NULL et si la taille de la mémoire tampon requise est copiée dans lpcbSize.

Si cette fonction échoue, la valeur de retour est FALSE. Dans ce cas, la CMM doit appeler SetLastError pour définir la dernière erreur sur une valeur d’erreur valide définie dans Winerror.h.

Remarques

Cette fonction est facultative pour toutes les machines virtuelles.

Si une CMM ne prend pas en charge cette fonction, Windows utilise la CMM par défaut pour obtenir l’intention de rendu des couleurs.

Si la balise n’est pas présente dans le profil indiqué par hProfile, la CMM la crée. L’intention de rendu résultante peut être utilisée comme opérande pour l’opérateur findcolorrendering PostScript Level 2.

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

Partager via