CMCheckColors-Funktion (icm.h)

Bestimmt, ob bestimmte Farben innerhalb der Ausgabeskala einer angegebenen Transformation liegen.

Syntax

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

Die Parameter

hcmTransform

Behandeln sie die zu verwendende Farbtransformation.

lpaInputColors

Zeigen Sie auf ein Array von COLOR-Strukturen , um die Ausgabeskala zu überprüfen.

nColors

Gibt die Anzahl der Elemente im Array an.

ctInput

Gibt den Eingabefarbtyp an.

lpaResult

Zeigen Sie auf einen Puffer, in dem ein Bytearray mit den Testergebnissen platziert werden soll. Jedes Byte im Puffer entspricht einer COLOR-Struktur , und beim Beenden wurde ein nicht signierter Wert zwischen 0 und 255 festgelegt. Der Wert 0 zeigt an, dass sich die Farbe in der Gamut befindet, während ein Wert ungleich Null angibt, dass er außerhalb des Gamuts liegt. Für eine beliebige ganze Zahl n, < n n< 255 gibt ein Ergebniswert von n + 1 an, dass die entsprechende Farbe mindestens so weit vom Gamut entfernt ist, wie durch einen Ergebniswert von n angegeben wird. Diese Werte werden in der Regel aus dem GamutTag im ICC-Profil generiert.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert WAHR.

Wenn diese Funktion fehlschlägt, lautet der Rückgabewert FALSCH. Wenn die Funktion nicht erfolgreich ist, sollte der CMM SetLastError aufrufen, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, der in Winerror.h definiert ist.

Bemerkungen

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

Wenn der Eingabefarbtyp nicht mit der Farbtransformation CMCheckColors kompatibel ist, tritt ein Fehler auf.

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen