CMTranslateColors-Funktion (icm.h)

Artikel
02/26/2024

Übersetzt ein Array von Farben aus einem Quellfarbraum in einen Zielfarbraum mithilfe einer Farbtransformation.

Syntax

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Parameter

hcmTransform

Gibt die zu verwendende Farbtransformation an.

lpaInputColors

Zeigt auf ein Array von zu übersetzenden COLOR-Strukturen .

nColors

Gibt die Anzahl der Elemente im Array an.

ctInput

Gibt den Farbtyp der Eingabe an.

lpaOutputColors

Verweist auf einen Puffer, in dem ein Array übersetzter COLOR-Strukturen platziert werden soll.

ctOutput

Gibt den Ausgabefarbtyp an.

Rückgabewert

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

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

Hinweise

Jeder CMM ist erforderlich, um diese Funktion zu exportieren.

Wenn die Eingabe- und Ausgabefarbtypen nicht mit der Farbtransformation kompatibel sind, sollte diese Funktion fehlschlagen.

Beachten Sie, dass diese Funktion die direkte Übersetzung unterstützen muss. Das heißt, wenn der Speicherbedarf der Ausgabe kleiner oder gleich dem Speicherbedarf der Eingabe ist, muss diese Funktion in der Lage sein, die Bitmapfarben zu übersetzen, auch wenn die Quell- und Zielpuffer identisch sind.

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

Freigeben über