wcsCreateIccProfile-Funktion (icm.h)

  • Artikel

Konvertiert ein WCS-Profil in ein ICC-Profil (International Color Consortium).

Syntax

HPROFILE WcsCreateIccProfile(
  HPROFILE hWcsProfile,
  DWORD    dwOptions
);

Parameter

hWcsProfile

Ein Handle für das WCS-Farbprofil, das konvertiert wird. Siehe Hinweise.

dwOptions

Ein Flagwert, der die Optionen für die Profilkonvertierung angibt.

Standardmäßig werden die ursprünglichen WCS-Profile, die für die Konvertierung verwendet werden, in das ICC-Ausgabeprofil in einem privaten Microsoft-Tag WcsProfilesTag (mit der Signatur "MS000") eingebettet. Dadurch entsteht ein ICC-Profil, das mit ICC-Software kompatibel ist, aber die ursprünglichen WCS-Profildaten für Code zur Verfügung stellt, der für die Analyse konzipiert ist.

Die möglichen Werte dieses Parameters sind wie folgt: Alle Bits, die in dieser Liste nicht definiert sind, sind reserviert und sollten auf null festgelegt werden:

Wert BESCHREIBUNG
WCS_DEFAULT Gibt an, dass das neue ICC-Profil das ursprüngliche WCS-Profil in einem privaten WcsProfilesTag enthält.
WCS_ICCONLY Gibt an, dass das neue ICC-Profil weder das WcsProfilesTag noch das ursprüngliche WCS-Profil enthält.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert das Handle des neuen Farbprofils.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Diese Funktion kann mit ASCII- oder Unicode-Zeichenfolgen verwendet werden.

Die CloseColorProfile-Funktion sollte verwendet werden, um das zurückgegebene HPROFILE-Handle zu schließen, wenn es nicht mehr benötigt wird.

DMP, CAMP und GMMP aus dem HPROFILE sind in ein privates Tag innerhalb des erstellten ICC-Profils eingebettet.

Für das mit dieser API erstellte ICC-Profil wird das Profilbeschreibungstag aus den ProfileName-Elementen der WCS-Profile nach dem folgenden Muster erstellt: "Erstellt von Microsoft WCS aus DMP:[der DMP-Profilname], CAMP:[der CAMP-Profilname], GMMP:[der GMMP-Profilname]"

Wenn WCS auf dieses ICC-Profil stößt (über OpenColorProfileW oder WcsOpenColorProfileW ), extrahiert und verwendet es die WCS-Profile, die im WcsProfilesTag enthalten sind.

Die In WCS erstellten Gamut-Tags verwenden den Wahrnehmungsfarbabstand in CIECAM02, der mittleren Quadratwurzel im CIECAM02-Jab-Raum. Die Entfernung in Legacy-ICC-Profil-Gamuttags ist die mittlere Quadratwurzel im CIELAB-Bereich. Es wird empfohlen, den CIECAM02-Speicherplatz zu verwenden, wenn er verfügbar ist, um wahrnehmungsgenauere Entfernungsmetriken bereitzustellen.

WCS extrahiert und verwendet das ursprüngliche WCS-Profil mithilfe eines XML-Profils, das explizit einem Gerät zugeordnet ist, oder eines ICC-Profils, das über einenWcsProfilesTag verfügt.

WcsProfilesTag ist ein privates ICC-Profiltag von Microsoft, das in Profilen verwendet wird, die von WcsCreateIccProfile erstellt wurden, um die WCS-Profileingabe für WcsCreateIccProfile zu enthalten. Dieses Tag entspricht den ICC-Profilanforderungen für Profiltags. Die Nicht-XML-Komponenten des Tags müssen sich in der Bytereihenfolge "Big-Endian" befinden, was standard für ICC-Profile ist. Darüber hinaus müssen die Tagdaten an einer 4-Byte-Grenze ausgerichtet werden (gemessen am Anfang des ICC-Profils). Die Struktur des Tags wird durch den unten angegebenen WcsProfilesTagType definiert. Beachten Sie, dass die XML-Komponenten des Tags, die WCS-Profile, die im WcsProfileTag enthalten sind, in ihrer nativen Bytereihenfolge verbleiben, die entweder little-endian oder big-endian sein kann, da XML-Parser beides ordnungsgemäß verarbeiten.

Die WcsProfilesTag-Signatur ist "MS00". Dies ist die Tagsignatur, die in der Tagtabelle für ICC-Profile für das WcsProfilesTag angezeigt wird.

Die WcsProfilesTagType-Struktur weist die folgende Struktur auf:

Byteoffset Inhalt
0-3 Die MS10-Typsignatur.
4-7 Reserviert, muss auf 0 (ICC-Tradition) festgelegt werden.
8-11 Byteoffset vom Anfang des Tags auf die CDMP-Daten.
12-15 Größe der CDMP-Daten in Bytes.
16-19 Byteoffset vom Anfang des Tags auf die CAMP-Daten.
20-23 Größe der CAMP-Daten in Bytes.
24-27 Byteoffset vom Anfang des Tags auf die GMMP-Daten.
28-31 Byteoffset vom Anfang des Tags auf die GMMP-Daten.
31-n Eine Sequenz von (Elementgröße -32) Byte [wobei die Elementgröße die Taggröße ist, die im Eintrag in der ICC-Profiltagstabelle für dieses Tag aufgezeichnet wird.]

Dies sind die WCS-XML-Profile, die von WcsCreateIccProfile zum Erstellen dieses ICC-Profils verwendet wurden. Die WCS-Profile werden sortiert: zuerst der DMP (erforderlich), gefolgt vom CAMP (sofern vorhanden), gefolgt von der GMMP (falls vorhanden).

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile icm.h
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen