Freigeben über

CreateColorTransformW-Funktion (icm.h)

  • Artikel

Erstellt eine Farbtransformation, mit der Anwendungen die Farbverwaltung durchführen können.

Syntax

HTRANSFORM CreateColorTransformW(
  LPLOGCOLORSPACEW pLogColorSpace,
  HPROFILE         hDestProfile,
  HPROFILE         hTargetProfile,
  DWORD            dwFlags
);

Parameter

pLogColorSpace

Zeiger auf die LOGCOLORSPACEA-Eingabe.

hDestProfile

Handle mit dem Profil des Zielgeräts. Die Funktion bestimmt, ob HPROFILE Profilinformationen des International Color Consortium (ICC) oder des Windows Color System (WCS) enthält.

hTargetProfile

Handle mit dem Profil des Zielgeräts. Die Funktion bestimmt, ob das HPROFILE ICC- oder WCS-Profilinformationen enthält.

dwFlags

Gibt Flags an, die für die Erstellung der Transformation verwendet werden sollen. Siehe Hinweise.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Farbtransformation.

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

Hinweise

Wenn das Zielprofil NULL ist, wechselt die Transformation vom logischen Quellfarbraum zum Zielprofil. Wenn das Zielprofil angegeben wird, wechselt die Transformation vom logischen Quellfarbraum zum Zielprofil und dann zum Zielprofil. Dies ermöglicht die Vorschau der Ausgabe, die für das Zielgerät auf dem Zielgerät vorgesehen ist.

Die Werte in dwFlags dienen nur als Hinweise. Das Farbverwaltungsmodul muss bestimmen, wie sie am besten verwendet werden können.

Windows Vista: Drei neue Flags wurden hinzugefügt, die mit dwFlags verwendet werden können:

Flag Beschreibung
PRESERVEBLACK Wenn dieses Bit festgelegt ist, fügt die Transformations-Engine den entsprechenden GMMP der schwarzen Generation als letzten GMMP in die Transformationssequenz ein. Dieses Flag funktioniert nur in einer reinen WCS-Transformation.
SEQUENTIAL_TRANSFORM Wenn dieses Bit festgelegt ist, wird jeder Schritt in der WCS-Verarbeitungspipeline für jedes Pixel im Bild ausgeführt, und es wird keine optimierte Farbtransformation erstellt. Dieses Flag funktioniert nur in einer reinen WCS-Transformation. Einschränkungen: Eine transformation, die mit dem SEQUENTIAL_TRANSFORM Flagsatz erstellt wurde, kann nur in dem Thread verwendet werden, für den sie erstellt wurde, und nur für jeweils einen Farbübersetzungsaufruf. COM muss vor dem Erstellen der sequenziellen Transformation initialisiert werden und muss für die Lebensdauer des Transformationsobjekts initialisiert bleiben.
WCS_ALWAYS Wenn dieses Bit festgelegt ist, verwenden selbst alle ICC-Transformationen den WCS-Codepfad.

Hinweis

SEQUENTIAL_TRANSFORM wurde versehentlich im icm.h-Header im Windows Vista SDK ausgelassen. Wenn Sie das SEQUENTIAL_TRANSFORM-Flag verwenden möchten, definieren Sie es in Ihrer Anwendung wie folgt: #define SEQUENTIAL_TRANSFORM 0x80800000

Weitere Informationen finden Sie unter Flags zur Erstellung von CMM-Transformationen. Alle dort erwähnten Flags werden für alle Arten von Transformationen unterstützt, mit Ausnahme von FAST_TRANSLATE, die nur in einer reinen ICC-zu-ICC-Transformation funktioniert.

Die CreateColorTransform-Funktion wird außerhalb eines Gerätekontexts verwendet. Farben können sich verschieben, wenn sie von einem Farbprofil in dasselbe Farbprofil transformiert werden. Dies ist auf Genauigkeitsfehler zurückzuführen. Daher sollte unter diesen Umständen keine Farbtransformation durchgeführt werden.

Die B2Ax-Tags sind für jedes Profil erforderlich, das das Ziel einer Transformation ist.

Die WCS-Transformationsunterstützung für ICC ColorSpace-Profile ist auf RGB-Farbraumprofile beschränkt. Die folgenden ICC-Profiltypen können nicht in einer CITE-verarbeiteten Transformation verwendet werden, entweder in einer gemischten WCS/ICC-Transformation oder einer all-ICC-Transformation mit WCS_ALWAYS festgelegt:

  • Nicht-RGB ColorSpace-Profile
  • NamedColor-Profile
  • n-Kanalprofile (wobei n > 8)
  • DeviceLink-Profile
  • Abstrakte Profile

Anforderungen

Anforderung Wert
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