CMCreateMultiProfileTransform-Funktion (icm.h)

Artikel
08/24/2023

Akzeptiert ein Array von Profilen oder ein einzelnes Gerätelinkprofil und erstellt eine Farbtransformation. Bei dieser Transformation handelt es sich um eine Zuordnung vom Farbraum, der vom ersten Profil zum zweiten Profil angegeben wird, usw. zum letzten Profil.

Syntax

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

Parameter

pahProfiles

Verweist auf ein Array von Profilhandles.

nProfiles

Gibt die Anzahl der Profile im Array an.

padwIntents

Verweist auf ein Array von Renderingabsichten. Jede Renderingabsicht wird durch einen der folgenden Werte dargestellt:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderingabsichten.

nIntents

Gibt die Anzahl der Absichten im Absichtsarray an. Kann 1 oder derselbe Wert wie nProfiles sein.

dwFlags

Gibt Flags an, die für die Erstellung der Transformation verwendet werden sollen. Weitere Informationen finden Sie unter Flags zur Erstellung von CMM-Transformationen.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert eine Farbtransformation im Bereich von 256 bis 65.535. Da nur das niedrige WORD der Transformation beibehalten wird, können gültige Transformationen diesen Bereich nicht überschreiten.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode mit einem Wert kleiner als 256. Wenn der Rückgabewert kleiner als 256 ist und einen Fehler signalisiert, sollte der CMM SetLastError verwenden, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, wie in Winerror.h definiert.

Hinweise

Jeder CMM ist erforderlich, um diese Funktion zu exportieren.

Das Array von Absichten gibt an, wie Profile kombiniert werden sollen. Die n-tenAbsicht wird verwendet, um das n-tenProfil im Array zu kombinieren. Wenn nur eine Absicht angegeben wird, wird sie für das erste Profil verwendet, und alle anderen Profile werden mithilfe der Absicht Übereinstimmung kombiniert.

Die Zum Erstellen der Farbtransformation verwendeten Profilhandles können geschlossen werden, nachdem der Aufruf von CMCreateMultiProfileTransform abgeschlossen wurde.

Anforderungen


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

Freigeben über