Funzione GetPS2ColorSpaceArray (icm.h)

  • Articolo

Recupera la matrice di spazi di colore PostScript Livello 2 da un profilo di colore ICC.

Sintassi

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

Parametri

hProfile

Specifica un handle per il profilo ICC da cui recuperare la matrice di spazio dello spazio a livello 2 postScript.

dwIntent

Specifica la finalità di rendering desiderata per la matrice dello spazio dei colori. Questo campo può accettare uno dei valori seguenti:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Per altre informazioni, vedere Finalità di rendering.

dwCSAType

Specifica il tipo di matrice di spazi colori. Vedere Identificatori del tipo di spazio dei colori.

pPS2ColorSpaceArray

Puntatore a un buffer in cui deve essere posizionata la matrice dello spazio dei colori. Se il puntatore pBuffer è impostato su NULL, la funzione restituisce le dimensioni necessarie del buffer nella posizione di memoria a cui punta pcbSize.

pcbPS2ColorSpaceArray

Puntatore a una variabile contenente le dimensioni del buffer in byte. In caso contrario, contiene il numero di byte copiati nel buffer.

pbBinary

Puntatore a una variabile booleana. Se impostato su TRUE, i dati copiati potrebbero essere binari. Se impostato su FALSE, i dati devono essere codificati come ASCII85. In caso contrario, il percorso di memoria a cui punta pbBinary indica se i dati restituiti in realtà sono binari (TRUE) o ASCII85 (FALSE).

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE. Restituisce anche TRUE se il parametro pBuffer è NULL e le dimensioni necessarie per il buffer vengono copiate in pcbSize.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Se la matrice dello spazio dei colori non è disponibile nel profilo, la funzione GetPS2ColorSpaceArray compila una matrice di spazi a livello 2 PostScript usando il contenuto del profilo. Questa matrice può quindi essere usata come operando per l'operatore setcolorspace PostScript Level2.

Questo metodo non supporta i profili WCS.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche