HALCON Operator reference

apply_color_trans_lutT_apply_color_trans_lutApplyColorTransLutApplyColorTransLutapply_color_trans_lut (Operator)

apply_color_trans_lutT_apply_color_trans_lutApplyColorTransLutApplyColorTransLutapply_color_trans_lut — Color space transformation using pre-generated look-up-table.

Signature

Herror T_apply_color_trans_lut(const Hobject Image1, const Hobject Image2, const Hobject Image3, Hobject* ImageResult1, Hobject* ImageResult2, Hobject* ImageResult3, const Htuple ColorTransLUTHandle)

void ApplyColorTransLut(const HObject& Image1, const HObject& Image2, const HObject& Image3, HObject* ImageResult1, HObject* ImageResult2, HObject* ImageResult3, const HTuple& ColorTransLUTHandle)

HImage HImage::ApplyColorTransLut(const HImage& Image2, const HImage& Image3, HImage* ImageResult2, HImage* ImageResult3, const HColorTransLUT& ColorTransLUTHandle) const

HImage HColorTransLUT::ApplyColorTransLut(const HImage& Image1, const HImage& Image2, const HImage& Image3, HImage* ImageResult2, HImage* ImageResult3) const

def apply_color_trans_lut(image_1: HObject, image_2: HObject, image_3: HObject, color_trans_luthandle: HHandle) -> Tuple[HObject, HObject, HObject]

Description

apply_color_trans_lutapply_color_trans_lutApplyColorTransLutApplyColorTransLutapply_color_trans_lut transforms an 3-channel image from the RGB color space to further color spaces and vice versa using a pre-generated look-up-table. The three channels of the image are passed as three separate images on input and output.

For further information about the color space transformations see operators trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbtrans_from_rgb and trans_to_rgbtrans_to_rgbTransToRgbTransToRgbtrans_to_rgb

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.
  • Automatically parallelized on domain level.

Parameters

Image1Image1Image1image1image_1 (input_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject (byte)

Input image (channel 1).

Image2Image2Image2image2image_2 (input_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject (byte)

Input image (channel 2).

Image3Image3Image3image3image_3 (input_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject (byte)

Input image (channel 3).

ImageResult1ImageResult1ImageResult1imageResult1image_result_1 (output_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject * (byte)

Color-transformed output image (channel 1).

ImageResult2ImageResult2ImageResult2imageResult2image_result_2 (output_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject * (byte)

Color-transformed output image (channel 2).

ImageResult3ImageResult3ImageResult3imageResult3image_result_3 (output_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject * (byte)

Color-transformed output image (channel 3).

ColorTransLUTHandleColorTransLUTHandleColorTransLUTHandlecolorTransLUTHandlecolor_trans_luthandle (input_control)  color_trans_lut HColorTransLUT, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the look-up-table for the color space transformation.

Result

The operator apply_color_trans_lutapply_color_trans_lutApplyColorTransLutApplyColorTransLutapply_color_trans_lut returns the value 2 ( H_MSG_TRUE) if the given parameters are correct and the input images could be successfully transformed. Otherwise, an exception will be raised.

Possible Predecessors

create_color_trans_lutcreate_color_trans_lutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut

Possible Successors

clear_color_trans_lutclear_color_trans_lutClearColorTransLutClearColorTransLutclear_color_trans_lut

Alternatives

trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbtrans_from_rgb, trans_to_rgbtrans_to_rgbTransToRgbTransToRgbtrans_to_rgb

See also

create_color_trans_lutcreate_color_trans_lutCreateColorTransLutCreateColorTransLutcreate_color_trans_lut, clear_color_trans_lutclear_color_trans_lutClearColorTransLutClearColorTransLutclear_color_trans_lut

Module

Foundation