create_color_trans_lutT_create_color_trans_lutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut (Operator)
Name
create_color_trans_lutT_create_color_trans_lutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut — 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_lutCreateColorTransLutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut 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 ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space gibt den Ausgangs- oder den
Zielfarbraum an. Mit dem Parameter TransDirectionTransDirectionTransDirectionTransDirectiontransDirectiontrans_direction 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_rgbTransFromRgbTransFromRgbTransFromRgbtrans_from_rgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgbtrans_to_rgb. Bei Transformationen aus / nach den
Farbräumen 'yiq'"yiq""yiq""yiq""yiq""yiq", 'argyb'"argyb""argyb""argyb""argyb""argyb", 'yuv'"yuv""yuv""yuv""yuv""yuv",
'ciexyz'"ciexyz""ciexyz""ciexyz""ciexyz""ciexyz" oder 'i1i2i3'"i1i2i3""i1i2i3""i1i2i3""i1i2i3""i1i2i3" wird
empfohlen die Operatoren trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbTransFromRgbtrans_from_rgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgbtrans_to_rgb zu verwenden.
Für weitere Informationen zu den Farbraumtransformationen siehe die
Beschreibungen der Operatoren trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbTransFromRgbtrans_from_rgb und
trans_to_rgbtrans_to_rgbTransToRgbTransToRgbTransToRgbtrans_to_rgb.
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
ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Gewünschte Farbtransformation.
Defaultwert:
'hsv'
"hsv"
"hsv"
"hsv"
"hsv"
"hsv"
Werteliste: 'argyb'"argyb""argyb""argyb""argyb""argyb", 'cielab'"cielab""cielab""cielab""cielab""cielab", 'cielchab'"cielchab""cielchab""cielchab""cielchab""cielchab", 'cielchuv'"cielchuv""cielchuv""cielchuv""cielchuv""cielchuv", 'cieluv'"cieluv""cieluv""cieluv""cieluv""cieluv", 'ciexyz'"ciexyz""ciexyz""ciexyz""ciexyz""ciexyz", 'ciexyz3'"ciexyz3""ciexyz3""ciexyz3""ciexyz3""ciexyz3", 'ciexyz4'"ciexyz4""ciexyz4""ciexyz4""ciexyz4""ciexyz4", 'ciexyz4'"ciexyz4""ciexyz4""ciexyz4""ciexyz4""ciexyz4", 'hls'"hls""hls""hls""hls""hls", 'hls'"hls""hls""hls""hls""hls", 'hsi'"hsi""hsi""hsi""hsi""hsi", 'hsv'"hsv""hsv""hsv""hsv""hsv", 'i1i2i3'"i1i2i3""i1i2i3""i1i2i3""i1i2i3""i1i2i3", 'ihs'"ihs""ihs""ihs""ihs""ihs", 'lms'"lms""lms""lms""lms""lms", 'yiq'"yiq""yiq""yiq""yiq""yiq", 'yuv'"yuv""yuv""yuv""yuv""yuv"
TransDirectionTransDirectionTransDirectionTransDirectiontransDirectiontrans_direction (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Gewünschte Richtung der Farbtransformation.
Defaultwert:
'from_rgb'
"from_rgb"
"from_rgb"
"from_rgb"
"from_rgb"
"from_rgb"
Werteliste: 'from_rgb'"from_rgb""from_rgb""from_rgb""from_rgb""from_rgb", 'to_rgb'"to_rgb""to_rgb""to_rgb""to_rgb""to_rgb"
NumBitsNumBitsNumBitsNumBitsnumBitsnum_bits (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl der Bits des Eingangsbildes.
Defaultwert: 8
Werteliste: 8
ColorTransLUTHandleColorTransLUTHandleColorTransLUTHandleColorTransLUTHandlecolorTransLUTHandlecolor_trans_luthandle (output_control) color_trans_lut → HColorTransLUT, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der Look-Up-Tabelle für Farbtransformation.
Ergebnis
create_color_trans_lutcreate_color_trans_lutCreateColorTransLutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut 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_lutApplyColorTransLutApplyColorTransLutApplyColorTransLutapply_color_trans_lut
Siehe auch
apply_color_trans_lutapply_color_trans_lutApplyColorTransLutApplyColorTransLutApplyColorTransLutapply_color_trans_lut,
clear_color_trans_lutclear_color_trans_lutClearColorTransLutClearColorTransLutClearColorTransLutclear_color_trans_lut
Modul
Foundation