Funzione WcsCreateIccProfile (icm.h)

  • Articolo

Converte un profilo WCS in un profilo CPI (International Color Consortium).

Sintassi

HPROFILE WcsCreateIccProfile(
  HPROFILE hWcsProfile,
  DWORD    dwOptions
);

Parametri

hWcsProfile

Handle per il profilo colore WCS convertito. Vedere la sezione Osservazioni.

dwOptions

Valore del flag che specifica le opzioni di conversione del profilo.

Per impostazione predefinita, i profili WCS originali usati per la conversione sono incorporati nel profilo DELL'output in un tag privato Microsoft , WcsProfilesTag (con firma "MS000". Questo produce un profilo CPI compatibile con il software CPI, ma mantiene i dati originali del profilo WCS disponibili per il codice progettato per analizzarlo.

I valori possibili di questo parametro sono i seguenti. Tutti i bit non definiti in questo elenco sono riservati e devono essere impostati su zero:

Valore Descrizione
WCS_DEFAULT Specifica che il nuovo profilo CPI contiene il profilo WCS originale in un WcsProfilesTag privato.
WCS_ICCONLY Specifica che il nuovo profilo CPI non contiene il wcsProfilesTag o il profilo WCS originale.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è l'handle del nuovo profilo colore.

Se questa funzione ha esito negativo, il valore restituito è NULL. Per informazioni sugli errori estesi, chiamare GetLastError.

Commenti

Questa funzione può essere usata con stringhe ASCII o Unicode.

La funzione CloseColorProfile deve essere usata per chiudere l'handle HPROFILE restituito quando non è più necessario.

DMP, CAMP e GMMP di HPROFILE sono incorporati in un tag privato all'interno del profilo ICC creato.

Il profilo ICC creato con questa API avrà il tag di descrizione del profilo costruito dagli elementi ProfileName dei profili WCS in base al modello seguente: "Creato da Microsoft WCS da DMP:[nomeprofili DMP], CAMP:[nomeprogetto CAMP], GMMP:[gmmp ProfileName]"

Quando WCS rileva questo profilo ICC (tramite OpenColorProfileW o WcsOpenColorProfileW ), estrae e usa i profili WCS contenuti nel WcsProfilesTag.

Le informazioni out-of-gamut nei tag di gamut creati in WCS usano la distanza del colore percettivo in CIECAM02, ovvero la radice quadrata media nello spazio CIECAM02 Jab. La distanza nei tag di gamut del profilo CP legacy è la radice quadrata media nello spazio CIELAB. È consigliabile usare lo spazio CIECAM02 quando è disponibile, per fornire metriche di distanza più accurate percettive.

WCS estrae e usa il profilo WCS originale tramite un profilo XML associato in modo esplicito a un dispositivo o a un profilo ICC con unWcsProfilesTag.

WcsProfilesTag è un tag di profilo CP privato Microsoft usato nei profili creati da WcsCreateIccProfile per contenere l'input dei profili WCS in WcsCreateIccProfile. Questo tag è conforme ai requisiti del profilo CPI per i tag del profilo. I componenti non XML del tag devono essere in ordine di byte "Big-Endian", che è standard per i profili ICC. Inoltre, i dati del tag devono essere allineati su un limite di 4 byte (misurato dall'inizio del profilo CPI). La struttura del tag è definita dal wcsProfilesTagType riportato di seguito. Si noti che i componenti XML del tag, i profili WCS contenuti in WcsProfileTag, vengono lasciati nell'ordinamento dei byte nativi, che possono essere little-endian o big-endian perché i parser XML elaborano correttamente entrambi.

La firma WcsProfilesTag è "MS00". Questa è la firma del tag che verrà visualizzata nella tabella dei tag dei profili ICC per WcsProfilesTag.

La struttura WcsProfilesTagType ha la struttura seguente:

Byte Offset Content
0-3 Firma del tipo MS10.
4-7 Riservato, deve essere impostato su 0 (tradizione CPI).
8-11 Offset di byte dall'inizio del tag ai dati CDMP.
12-15 Dimensioni dei dati CDMP in byte.
16-19 Offset di byte dall'inizio del tag ai dati CAMP.
20-23 Dimensioni dei dati CAMP in byte.
24-27 Offset di byte dall'inizio del tag ai dati GMMP.
28-31 Offset di byte dall'inizio del tag ai dati GMMP.
31-n Sequenza di byte (dimensione elemento -32) [dove le dimensioni degli elementi sono le dimensioni del tag registrate nella voce della tabella tag del profilo CPI per questo tag.]

Si tratta dei profili XML WCS usati da WcsCreateIccProfile per creare questo profilo CPI. I profili WCS sono ordinati: il DMP (obbligatorio) prima, seguito dal CAMP (se presente), seguito dal GMMP (se presente).

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