LUT Functions

Functions
cvbres_t	ApplyLUT8Bit (IMG ImgIn, long Index, long Values[256], IMG &ImgOut)
	Creates an intensity-transformed image by applying an 8 bit lookup table with 256 entries to the input image. More...
cvbres_t	ApplyLUTCubic (IMG ImgIn, long Index, long NumLevels, double Levels[], double Values[], IMG &ImgOut)
	Apply a cubically interpolated LUT intensity transformation to one plane of an input image. More...
cvbres_t	ApplyLUTGeneric (IMG ImgIn, long Index, long NumLevels, double Levels[], double Values[], IMG &ImgOut)
	Performs intensity transformation of the source image pSrc using the lookup table (LUT) specified by the arrays Levels and Values. More...
cvbres_t	ApplyLUTLinear (IMG ImgIn, long Index, long NumLevels, double Levels[], double Values[], IMG &ImgOut)
	Apply a linearly interpolated LUT intensity transformation to one plane of an input image. More...

Detailed Description

Function Documentation

ApplyLUT8Bit()

cvbres_t ApplyLUT8Bit	(	IMG	ImgIn,
		long	Index,
		long	Values[256],
		IMG &	ImgOut
	)

Creates an intensity-transformed image by applying an 8 bit lookup table with 256 entries to the input image.

Every pixel of the input image is transformed such that Dst = Values[Src] (where Dst is the gray-value of the output
pixel after transformation and Src the gray-value of the input pixel).

Parameters

[in]	ImgIn	Handle of image object.
[in]	Index	Plane index of input image to perform the intensity transformation on.
[in]	Values	Array that contains the 256 values that form the lookup table. Attention: Visual Basic users should create an array, and pass the first element of that array to this function.
[out]	ImgOut	Image handle of result image.

Returns

0 : OK
< 0: an error occurred.

Supported platforms:

Win32
Win64

Related Topics:

ApplyLUTLinear, ApplyLUTCubic, ApplyLUTGeneric

ApplyLUTCubic()

cvbres_t ApplyLUTCubic	(	IMG	ImgIn,
		long	Index,
		long	NumLevels,
		double	Levels[],
		double	Values[],
		IMG &	ImgOut
	)

Apply a cubically interpolated LUT intensity transformation to one plane of an input image.

Performs intensity transformation of the source image ImgIn using the lookup table (LUT) with cubic interpolation between neighbor levels.
LUT is specified by the arrays Levels and Values.
Number of level and intensity values is less than nLevels by one.
Pixels in ImgIn image that are not in the range [Levels[0], Levels[NumLevels-1]) are copied to the result image without any transformation.

Parameters

[in]	ImgIn	Handle of image object.
[in]	Index	Plane index of input image to perform the intensity transformation on.
[in]	NumLevels	Number of levels and values in the lookup table.
[in]	Levels	Array of gray-value levels at which changes in the LUT occur. Attention: The level values have to be strictly increasing. The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[in]	Values	Array of intensity values that correspond to the levels specified in the Levels array.. Attention: The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[out]	ImgOut	Image handle of result image.

Returns

0 : OK
< 0: an error occurred.

Supported platforms:

Win32
Win64

Related Topics:

ApplyLUTLinear, ApplyLUTGeneric, ApplyLUT8Bit

ApplyLUTGeneric()

cvbres_t ApplyLUTGeneric	(	IMG	ImgIn,
		long	Index,
		long	NumLevels,
		double	Levels[],
		double	Values[],
		IMG &	ImgOut
	)

Performs intensity transformation of the source image pSrc using the lookup table (LUT) specified by the arrays Levels and Values.

For every source pixel from the input image with a gray-value in the range[Levels[k] <= Src < Levels[k+1] the output pixel will
have a gray-value of Values[k]. Length of the Levels and Values arrays is defined by the NumLevels parameter.
Number of level and intensity values is less than nLevels by one.
Pixels in the input image that are not in the range Levels[0]…Levels[NumLevels-1] are copied to the output image without transformation.

Parameters

[in]	ImgIn	Handle of image object.
[in]	Index	Plane index of input image to perform the intensity transformation on.
[in]	NumLevels	Number of levels and values in the lookup table.
[in]	Levels	Array of gray-value levels at which changes in the LUT occur. Attention: The level values have to be strictly increasing. The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[in]	Values	Array of intensity values that correspond to the levels specified in the Levels array.. Attention: The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[out]	ImgOut	Image handle of result image.

Returns

0 : OK
< 0: an error occurred.

Supported platforms:

Win32
Win64

Related Topics:

ApplyLUTLinear, ApplyLUTCubic, ApplyLUT8Bit

ApplyLUTLinear()

cvbres_t ApplyLUTLinear	(	IMG	ImgIn,
		long	Index,
		long	NumLevels,
		double	Levels[],
		double	Values[],
		IMG &	ImgOut
	)

Apply a linearly interpolated LUT intensity transformation to one plane of an input image.

Transforms the pixels of the input plane by applying a gray-value lookup table.
The lookup table is defined by a number of levels (at which the gray-values change) and values (that the transformed pixel will have).
Between the different values of different levels, a linear interpolation is applied.
Pixels in the input image that are not in the range Levels[0]…Levels[NumLevels-1] are copied to the output image without transformation.

Parameters

[in]	ImgIn	Handle of image object.
[in]	Index	Plane index of input image to perform intensity transformation on.
[in]	NumLevels	Number of levels and values in the lookup table.
[in]	Levels	Array of gray-value levels at which changes in the LUT occur. Attention: The level values have to be strictly increasing. The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[in]	Values	Array of intensity values that correspond to the levels specified in the Levels array.. Attention: The size of this array must be NumLevels. Visual Basic users should create an array, and pass the first element of that array to this function.
[out]	ImgOut	Image handle of result image.

Returns

0 : OK
< 0: an error occurred.

Supported platforms:

Win32
Win64

Related Topics:

ApplyLUTCubic, ApplyLUTGeneric, ApplyLUT8Bit