Freigeben über

CheckColors-Funktion (icm.h)

  • Artikel

Bestimmt, ob die Farben in einem Array innerhalb des Ausgabeumfangs einer angegebenen Transformation liegen.

Syntax

BOOL CheckColors(
  HTRANSFORM hColorTransform,
  PCOLOR     paInputColors,
  DWORD      nColors,
  COLORTYPE  ctInput,
  PBYTE      paResult
);

Parameter

hColorTransform

Handle für die zu verwendende Farbtransformation.

paInputColors

Zeiger auf ein Array von zu übersetzenden nColorsCOLOR-Strukturen .

nColors

Enthält die Anzahl der Elemente in den Arrays, auf die von paInputColors und paResult verwiesen wird.

ctInput

Gibt den Typ der Eingabefarbe an.

paResult

Zeiger auf ein Array von nColors-Bytes , das die Ergebnisse des Tests empfängt.

Rückgabewert

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

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

Hinweise

Wenn der Eingabefarbtyp nicht mit der Farbtransformation kompatibel ist, schlägt CheckColors fehl.

Die Funktion platziert ergebnisse der Tests im Array, auf das paResult verweist. Jedes Byte im Array entspricht einem COLOR-Element im Array, auf das von paInputColors verwiesen wird, und weist einen Wert ohne Vorzeichen zwischen 0 und 255 auf. Der Wert 0 gibt an, dass sich die Farbe im Gamut befindet, während ein Wert ungleich null angibt, dass sie sich außerhalb des Farbraums befindet. Für jede ganze Zahl n , die 0 <n< 255 ist, gibt der Ergebniswert n +1 an, dass die entsprechende Farbe mindestens so weit außerhalb des Gamuts liegt, wie durch den Ergebniswert n angegeben würde.

Die In WCS erstellten Gamut-Tags verwenden den wahrnehmungsbezogenen Farbabstand in CIECAM02, d. h. die mittlere Quadratwurzel in CIECAM02 Jab-Raum. Der Abstand in den älteren ICC-Profil-Gamuttags ist die mittlere Quadratwurzel im CIELAB-Raum. Es wird empfohlen, den CIECAM02 Speicherplatz zu verwenden, wenn er verfügbar ist, da er wahrnehmungsgenauere Entfernungsmetriken bereitstellt.

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