CMTranslateColors-Funktion (icm.h)

Ü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
);

Die Parameter

hcmTransform

Gibt die zu verwendende Farbtransformation an.

lpaInputColors

Verweist auf ein Array von COLOR-Strukturen , die übersetzt werden sollen.

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

Wenn diese Funktion fehlschlägt, lautet der Rückgabewert FALSCH. Der CMM sollte 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 die Eingabe und die 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 auch dann zu übersetzen, wenn die Quell- und Zielpuffer identisch sind.

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen