Funzione CMCreateMultiProfileTransform (icm.h)
Accetta una matrice di profili o un singolo profilo di collegamento del dispositivo e crea una trasformazione del colore. Questa trasformazione è un mapping dallo spazio colori specificato dal primo profilo a quello del secondo profilo e così via fino all'ultimo.
Sintassi
HCMTRANSFORM CMCreateMultiProfileTransform(
PHPROFILE pahProfiles,
DWORD nProfiles,
PDWORD padwIntents,
DWORD nIntents,
DWORD dwFlags
);
Parametri
pahProfiles
Punta a una matrice di handle di profilo.
nProfiles
Specifica il numero di profili nella matrice.
padwIntents
Punta a una matrice di finalità di rendering. Ogni finalità di rendering è rappresentata da uno dei valori seguenti:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Per altre informazioni, vedere Finalità di rendering.
nIntents
Specifica il numero di finalità nella matrice di finalità. Può essere 1 o lo stesso valore di nProfiles.
dwFlags
Specifica i flag per utilizzare la creazione del controllo della trasformazione. Per informazioni dettagliate, vedere Flag di creazione della trasformazione CMM.
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è una trasformazione di colore nell'intervallo da 256 a 65.535. Poiché viene mantenuta solo la parola bassa della trasformazione, le trasformazioni valide non possono superare questo intervallo.
Se questa funzione ha esito negativo, il valore restituito è un codice di errore con un valore minore di 256. Quando il valore restituito è minore di 256, segnalando un errore, CMM deve usare SetLastError per impostare l'ultimo errore su un valore di errore valido come definito in Winerror.h.
Commenti
Ogni CMM è necessario per esportare questa funzione.
La matrice di finalità specifica la modalità di combinazione dei profili. La nfinalità viene usata per combinare il nprofilo nella matrice. Se viene specificata una sola finalità, viene usata per il primo profilo e tutti gli altri profili vengono combinati usando la finalità Match.
Gli handle di profilo usati per creare la trasformazione del colore possono essere chiusi dopo il completamento della chiamata a CMCreateMultiProfileTransform .
Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Intestazione | icm.h |