create_color_trans_lutT_create_color_trans_lutCreateColorTransLutCreateColorTransLut (Operator)
Name
create_color_trans_lutT_create_color_trans_lutCreateColorTransLutCreateColorTransLut — Generiert eine Look-Up-Tabelle für die Farbraumtransformation von
RGB Farbraum in die weiteren Farbräume.
Signatur
void CreateColorTransLut(const HTuple& ColorSpace, const HTuple& TransDirection, const HTuple& NumBits, HTuple* ColorTransLUTHandle)
static HColorTransLUT HImage::CreateColorTransLut(const HString& ColorSpace, const HString& TransDirection, Hlong NumBits)
static HColorTransLUT HImage::CreateColorTransLut(const char* ColorSpace, const char* TransDirection, Hlong NumBits)
static HColorTransLUT HImage::CreateColorTransLut(const wchar_t* ColorSpace, const wchar_t* TransDirection, Hlong NumBits)
(Nur Windows)
void HColorTransLUT::HColorTransLUT(const HString& ColorSpace, const HString& TransDirection, Hlong NumBits)
void HColorTransLUT::HColorTransLUT(const char* ColorSpace, const char* TransDirection, Hlong NumBits)
void HColorTransLUT::HColorTransLUT(const wchar_t* ColorSpace, const wchar_t* TransDirection, Hlong NumBits)
(Nur Windows)
void HColorTransLUT::CreateColorTransLut(const HString& ColorSpace, const HString& TransDirection, Hlong NumBits)
void HColorTransLUT::CreateColorTransLut(const char* ColorSpace, const char* TransDirection, Hlong NumBits)
void HColorTransLUT::CreateColorTransLut(const wchar_t* ColorSpace, const wchar_t* TransDirection, Hlong NumBits)
(Nur Windows)
Beschreibung
create_color_trans_lutcreate_color_trans_lutCreateColorTransLutCreateColorTransLutCreateColorTransLut generiert eine Look-Up-Tabelle für
die Farbraumtransformation aus dem RGB-Farbraum in andere Farbräume
und umgekehrt.
Für die Transformationen werden 3-kanalige 8-Bit Farbbilder
benötigt, d.h. jeder Kanal muss vom Typ 'byte' sein. Besitzen die
Eingabebilder unterschiedliche Domänen, wird nur die gemeinsame
Schnittmenge aller drei Eingabebilder transformiert.
Der Parameter ColorSpaceColorSpaceColorSpaceColorSpacecolorSpace gibt den Ausgangs- oder den
Zielfarbraum an. Mit dem Parameter TransDirectionTransDirectionTransDirectionTransDirectiontransDirection wird die
Richtung der Transformation ('von RGB' oder 'nach RGB') festgelegt.
Die Verwendung von der Look-Up-Tabelle für die
Farbraumtransformation beschleunigt viele Farbraumtransformationen
im Vergleich zu den Operatoren trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbTransFromRgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgb. Bei Transformationen aus / (nach) den
Farbräumen 'yiq', 'argyb', 'yuv', 'ciexyz' oder 'i1i2i3' wird
empfohlen die Operatoren trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbTransFromRgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgb zu verwenden.
Für weitere Informationen zu den Farbraumtransformationen siehe die
Beschreibungen der Operatoren trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbTransFromRgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgb.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
ColorSpaceColorSpaceColorSpaceColorSpacecolorSpace (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Gewünschte Farbtransformation.
Defaultwert:
'hsv'
"hsv"
"hsv"
"hsv"
"hsv"
Werteliste: 'argyb'"argyb""argyb""argyb""argyb", 'cielab'"cielab""cielab""cielab""cielab", 'cielchab'"cielchab""cielchab""cielchab""cielchab", 'cielchuv'"cielchuv""cielchuv""cielchuv""cielchuv", 'cieluv'"cieluv""cieluv""cieluv""cieluv", 'ciexyz'"ciexyz""ciexyz""ciexyz""ciexyz", 'ciexyz3'"ciexyz3""ciexyz3""ciexyz3""ciexyz3", 'ciexyz4'"ciexyz4""ciexyz4""ciexyz4""ciexyz4", 'ciexyz4'"ciexyz4""ciexyz4""ciexyz4""ciexyz4", 'hls'"hls""hls""hls""hls", 'hls'"hls""hls""hls""hls", 'hsi'"hsi""hsi""hsi""hsi", 'hsv'"hsv""hsv""hsv""hsv", 'i1i2i3'"i1i2i3""i1i2i3""i1i2i3""i1i2i3", 'ihs'"ihs""ihs""ihs""ihs", 'lms'"lms""lms""lms""lms", 'yiq'"yiq""yiq""yiq""yiq", 'yuv'"yuv""yuv""yuv""yuv"
TransDirectionTransDirectionTransDirectionTransDirectiontransDirection (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Gewünschte Richtung der Farbtransformation.
Defaultwert:
'from_rgb'
"from_rgb"
"from_rgb"
"from_rgb"
"from_rgb"
Werteliste: 'from_rgb'"from_rgb""from_rgb""from_rgb""from_rgb", 'to_rgb'"to_rgb""to_rgb""to_rgb""to_rgb"
NumBitsNumBitsNumBitsNumBitsnumBits (input_control) integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl der Bits des Eingangsbildes.
Defaultwert: 8
Werteliste: 8
ColorTransLUTHandleColorTransLUTHandleColorTransLUTHandleColorTransLUTHandlecolorTransLUTHandle (output_control) color_trans_lut → HColorTransLUT, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der Look-Up-Tabelle für Farbtransformation.
Ergebnis
create_color_trans_lutcreate_color_trans_lutCreateColorTransLutCreateColorTransLutCreateColorTransLut liefert den Wert 2 (H_MSG_TRUE), falls die
übergebenen Parameter korrekt sind und die Look-Up-Tabelle erzeugt
werden konnte. Ansonsten wird eine Fehlerbehandlung
durchgeführt.
Nachfolger
apply_color_trans_lutapply_color_trans_lutApplyColorTransLutApplyColorTransLutApplyColorTransLut
Siehe auch
apply_color_trans_lutapply_color_trans_lutApplyColorTransLutApplyColorTransLutApplyColorTransLut,
clear_color_trans_lutclear_color_trans_lutClearColorTransLutClearColorTransLutClearColorTransLut
Modul
Foundation