Funzione CMGetPS2ColorRenderingIntent (icm.h)

  • Articolo

Recupera la finalità di rendering dei colori postscript di livello 2 da un profilo.

Sintassi

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

Parametri

hProfile

Specifica il profilo da utilizzare.

dwIntent

Specifica la finalità di rendering desiderata da recuperare. I possibili valori sono i seguenti:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Per altre informazioni, vedere Finalità di rendering.

lpBuffer

Punta a un buffer in cui deve essere inserita la finalità di rendering dei colori. Se il puntatore è NULL, la funzione restituisce le dimensioni necessarie per questo buffer in *lpcbSize.

lpcbSize

Punta a una variabile che specifica le dimensioni del buffer. In caso di restituzione, la variabile contiene il numero di byte effettivamente copiati nel buffer.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE. Restituisce anche TRUE se viene chiamato con lpBuffer impostato su NULL e le dimensioni del buffer richiesto vengono copiate in lpcbSize.

Se questa funzione ha esito negativo, il valore restituito è FALSE. In questo caso, CMM deve chiamare SetLastError per impostare l'ultimo errore su un valore di errore valido definito in Winerror.h.

Commenti

Questa funzione è facoltativa per tutti i cmm.

Se un CMM non supporta questa funzione, Windows usa il CMM predefinito per ottenere la finalità di rendering dei colori.

Se il tag non è presente nel profilo indicato da hProfile, il CMM lo crea. La finalità di rendering risultante può essere usata come operando per l'operatore findcolorrendering di livello 2 PostScript.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h

Vedi anche