GetPS2ColorSpaceArray, fonction (icm.h)

Article
08/24/2023

Récupère le tableau d’espaces de couleurs PostScript Niveau 2 à partir d’un profil de couleur ICC.

Syntaxe

BOOL GetPS2ColorSpaceArray(
  HPROFILE hProfile,
  DWORD    dwIntent,
  DWORD    dwCSAType,
  PBYTE    pPS2ColorSpaceArray,
  PDWORD   pcbPS2ColorSpaceArray,
  PBOOL    pbBinary
);

Paramètres

hProfile

Spécifie un handle pour le profil ICC à partir duquel récupérer le tableau d’espace de couleur PostScript Level 2.

dwIntent

Spécifie l’intention de rendu souhaitée pour le tableau d’espaces de couleurs. Ce champ peut prendre l’une des valeurs suivantes :

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Pour plus d’informations, consultez Rendu des intentions.

dwCSAType

Spécifie le type de tableau d’espaces de couleurs. Consultez Identificateurs de type d’espace de couleur.

pPS2ColorSpaceArray

Pointeur vers une mémoire tampon dans laquelle le tableau d’espaces de couleurs doit être placé. Si le pointeur pBuffer a la valeur NULL, la fonction retourne la taille requise de la mémoire tampon dans l’emplacement de mémoire pointé par pcbSize.

pcbPS2ColorSpaceArray

Pointeur vers une variable contenant la taille de la mémoire tampon en octets. Au retour, il contient le nombre d’octets copiés dans la mémoire tampon.

pbBinary

Pointeur vers une variable booléenne. Si la valeur est TRUE, les données copiées peuvent être binaires. Si la valeur est FALSE, les données doivent être encodées en ASCII85. Au retour, l’emplacement de mémoire pointé vers pbBinary indique si les données retournées sont binaires (TRUE) ou ASCII85 (FALSE).

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE. Elle retourne également TRUE si le paramètre pBuffer a la valeur NULL et si la taille requise pour la mémoire tampon est copiée dans pcbSize.

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

Notes

Si le tableau d’espaces de couleurs n’est pas disponible dans le profil, la fonction GetPS2ColorSpaceArray génère un tableau d’espaces de couleurs PostScript Niveau 2 à l’aide du contenu du profil. Ce tableau peut ensuite être utilisé comme opérande pour l’opérateur setcolorspace PostScript Level2.

Cette méthode ne prend pas en charge les profils WCS.

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
Bibliothèque	Mscms.lib
DLL	Mscms.dll

Partager via