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