ClassesClasses | | Operators

lut_transT_lut_transLutTransLutTrans (Operator)

Name

lut_transT_lut_transLutTransLutTrans — Transform an image with a gray-value look-up-table

Signature

lut_trans(Image : ImageResult : Lut : )

Herror T_lut_trans(const Hobject Image, Hobject* ImageResult, const Htuple Lut)

void LutTrans(const HObject& Image, HObject* ImageResult, const HTuple& Lut)

HImage HImage::LutTrans(const HTuple& Lut) const

static void HOperatorSet.LutTrans(HObject image, out HObject imageResult, HTuple lut)

HImage HImage.LutTrans(HTuple lut)

Description

lut_translut_transLutTransLutTransLutTrans transforms an image ImageImageImageImageimage by using a gray value look-up-table LutLutLutLutlut. This table acts as a transformation function. In the case of byte-images, LutLutLutLutlut has to be a tuple of length 256. In the case of int2-images, LutLutLutLutlut has to be a tuple of length 256 <= length <= 65536. If the length of the LutLutLutLutlut is <= 32768, the transformation is applied to the positive gray values only, i.e., the first element of the LutLutLutLutlut specifies the new gray value for the gray value 0. If the LutLutLutLutlut is longer than 32768, exactly 65536 must be passed. In this case, the positive and negative gray values are transformed. In this case, the first element indicates the new gray value for the gray value -32768 of the input image, while the last element of the tuple indicates the new gray value for the gray value 32767. In all cases, the gray values of values outside the range of LutLutLutLutlut are set to 0. In the case of uint2-images, LutLutLutLutlut has to be a tuple of length 256 <= length <= 65536. Gray values outside the range of LutLutLutLutlut are set to 0.

Attention

lut_translut_transLutTransLutTransLutTrans can be executed on OpenCL devices.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte* / int2* / uint2*) *allowed for compute devices

Image whose gray values are to be transformed.

ImageResultImageResultImageResultImageResultimageResult (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / int2 / uint2)

Transformed image.

LutLutLutLutlut (input_control)  integer-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Table containing the transformation.

Example (HDevelop)

* Apply a gamma correction to an image.
Gamma := 2.2
GammaLUT := []
for G := 0 to 255 by 1
    GammaLUT := [GammaLUT,round(255.0*pow(G/255.0,1.0/Gamma))]
endfor
read_image (Image, 'mreut')
lut_trans (Image, ImageGamma, GammaLUT)

Result

The operator lut_translut_transLutTransLutTransLutTrans returns the value 2 (H_MSG_TRUE) if the parameters are correct. Otherwise an exception is raised.

Module

Foundation


ClassesClasses | | Operators