Top  Previous  Next


Assigns the array of values for the software lookup table. If the LUTMode is active, the pixel values in the incoming frames will be transformed based on a corresponding factor in the LUT array.


objActiveGige.SetROI LUT, Channels

HRESULT SetROI(VARIANT LUT, short Channels);

Data Types

LUT: Variant (Array)
Channels: Integer


SAFEARRAY of floating point factors to be used in the lookup table. The value of 1.0 corresponds to the maximum pixel value in the currently selected video format.  
Number of color channels in the submitted array. Can be one of the following values:  
1 - the array contains a one-channel LUT which will be used for all color components  
3 - the array contains a three-channel LUT where the first 1/3 of elements represent the red channel, the second 1/3 of elements - green channel and the last 1/3 of elements - blue channel.  
4 - the array contains a four-channel LUT used for the operation on a raw Bayer video. The first 1/4 of elements represent the R channel, the second 1/4 of elements - Gr channel, the third 1/4 of elements - B channel and the last 1/4 of elements - Gb channel.  

Return Values



The following VB example prepares a 3-channel linear LUT with an amplified green channel and applies it to the video:

 LUT(256 * 3) As 

 i = 0 To 255
LUT(i) = i/255.

For i = 256 To 511
LUT(i) = (i-256)*2/255.
For i = 512 To 767
LUT(i) = (i-512)/255.
ActiveGige1.SetLUT A, 3


The LUT processing in ActiveGige works in two stages. An array submitted by SetLUT and containing coefficients in the range 0 - 1.0 is converted to the internal LUT array with the number of elements and their values corresponding to the actual range of pixels in the currently selected format. This guarantees that the input LUT will have an identical effect on images of different types and pixel depths.

For example, if a submitted array has 256 elements with values gradually increasing from 0 to 0.5 and the currently selected format is Mono12 (for which the maximum pixel value is 4095), it will be converted to the internal LUT with 4096 elements and values gradually increasing from 0 to 2047. If the format is changed to Mono8, the internal LUT will automatically shrink to 256 elements with values gradually increasing from 0 to 255. If LUTMode is active, the value of each pixel will be mapped to the value of a corresponding element in the internal LUT.

For a single-channel LUT the input value of a pixel is used directly as an index in the LUT array. Multi-channel LUTs are logically divided into several subsequent LUTs starting from the red channel array. Therefore, if a submitted lookup table contains 768 elements and 3 channels, the first 256 elements will be used to index and remap red pixels, the second 256 elements - green pixels, and the last 256 elements - blue pixels.

To obtain the values of the current lookup table, use the GetLUT method.