Foundation (CVFoundation.dll) 15.0
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]ImgInHandle of image object.
[in]IndexPlane index of input image to perform the intensity transformation on.
[in]ValuesArray 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]ImgOutImage 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]ImgInHandle of image object.
[in]IndexPlane index of input image to perform the intensity transformation on.
[in]NumLevelsNumber of levels and values in the lookup table.
[in]LevelsArray 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]ValuesArray 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]ImgOutImage 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]ImgInHandle of image object.
[in]IndexPlane index of input image to perform the intensity transformation on.
[in]NumLevelsNumber of levels and values in the lookup table.
[in]LevelsArray 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]ValuesArray 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]ImgOutImage 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]ImgInHandle of image object.
[in]IndexPlane index of input image to perform intensity transformation on.
[in]NumLevelsNumber of levels and values in the lookup table.
[in]LevelsArray 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]ValuesArray 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]ImgOutImage handle of result image.
Returns
0 : OK
< 0: an error occurred.
Supported platforms:
Win32
Win64
Related Topics:
ApplyLUTCubic, ApplyLUTGeneric, ApplyLUT8Bit