CMCreateMultiProfileTransform-Funktion (icm.h)

Akzeptiert ein Array von Profilen oder ein einzelnes Gerätelinkprofil und erstellt eine Farbtransformation. Bei dieser Transformation handelt es sich um eine Zuordnung des farbraums, der durch das erste Profil dem des zweiten Profils und so weiter zum letzten Profil angegeben wird.

Syntax

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

Die Parameter

pahProfiles

Verweist auf ein Array von Profilziehpunkten.

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 Renderabsichten.

nIntents

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

dwFlags

Gibt Kennzeichnungen an, die zum Erstellen der Steuerung der Transformation verwendet werden sollen. Ausführliche Informationen finden Sie unter CMM Transform Creation Flags.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert eine Farbtransformation im Bereich 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 ein Fehler signalisiert wird, sollte der CMM SetLastError verwenden, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, wie in Winerror.h definiert.

Bemerkungen

Für den Export dieser Funktion ist jedes CMM erforderlich.

Das Array von Absichten gibt an, wie Profile kombiniert werden sollen. Der n-Ten-Intent wird zum Kombinieren des n-th-Profilsim Array verwendet. Wenn nur eine Absicht angegeben wird, wird sie für das erste Profil verwendet, und alle anderen Profile werden mit Übereinstimmungsabsicht kombiniert.

Die Profilhandles, die zum Erstellen der Farbtransformation verwendet werden, können geschlossen werden, nachdem der Aufruf von CMCreateMultiProfileTransform abgeschlossen wurde.

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen