WcsTranslateColors-Funktion (icm.h)

Artikel
02/26/2024

Übersetzt ein Array von Farben aus dem Quellfarbraum in den Zielfarbraum, wie durch eine Farbtransformation definiert.

Syntax

BOOL WcsTranslateColors(
  HTRANSFORM    hColorTransform,
  DWORD         nColors,
  DWORD         nInputChannels,
  COLORDATATYPE cdtInput,
  DWORD         cbInput,
  PVOID         pInputData,
  DWORD         nOutputChannels,
  COLORDATATYPE cdtOutput,
  DWORD         cbOutput,
  PVOID         pOutputData
);

Parameter

hColorTransform

Ein Handle für die WCS-Farbtransformation.

nColors

Die Anzahl der Elemente im Array, auf die pInputData und pOutputData verweisen.

nInputChannels

Die Anzahl der Kanäle pro Element im Array, auf das pInputData verweist.

cdtInput

Der COLORDATATYPE-Farbdatentyp der Eingabe.

cbInput

Die Puffergröße von pInputData in Bytes.

pInputData

Ein Zeiger auf ein Array von Eingabefarben. Die Größe des Puffers für dieses Array in Bytes entspricht dem DWORD-Wert von cbInput.

nOutputChannels

Die Anzahl der Kanäle pro Element im Array, auf das pOutputData verweist.

cdtOutput

Die COLORDATATYPE-Ausgabe , die den Farbdatentyp angegeben hat.

cbOutput

Die Puffergröße von pOutputData in Bytes.

pOutputData

Ein Zeiger auf ein Array von Farben, das die Ergebnisse der Farbübersetzung empfängt. Die Größe des Puffers für dieses Array in Bytes entspricht dem DWORD-Wert von cbOutput.

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 die Eingabe- und Ausgabefarbdatentypen nicht mit der Farbtransformation kompatibel sind, schlägt diese Funktion fehl. Diese Funktion schlägt fehl, wenn eine ICC-Transformation verwendet wird.

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

Freigeben über