You are here: Technical Reference > LUT Control
FLIR

Blackfly®S

BFS-GE-16S2-BD2

 

LUT Control

Lookup Table (LUT) is a common image processing technique to map a pixel from one value to the other. The camera has an 11-bit input lookup table that produces 9-bit output. When a pixel value is larger than the 11-bit maximum (i.e., 2047), LUT treats it the same as the 2047. The LUT is available for all pixel formats.

  • When outputting 8-bit pixel formats, the 9-bit LUT output is rounded down to the 8-bit value.
  • When outputting 12-bit pixel formats, the 9-bit LUT output stays as the most significant 9 bits of the 12-bit value and the remaining 3 bits are all zeros.
  • When outputting 16-bit pixel formats, the 9-bit LUT output stays as the most significant 9 bits of the 16-bit value and the remaining 7 bits are all zeros.

Therefore, LUT should be used cautiously for 12-bit or 16-bit pixel formats since some of the least significant bits are thrown away.

The factory default LUT is the linear mapping after the camera powers on (P' = P/4).

To customize a LUT:

  1. Use the LUT Selector to choose which LUT to control. LUT1 is the only lookup table to allow user access and control.
  2. Use LUT Enable to disable the selected LUT before customizing it. Customizations of the LUT apply immediately, therefore an active LUT that is changed may result in unexpected images.
  3. Use LUT Index to identify the index (offset) of the coefficient to access.
  4. LUT Value returns the value at the entry of the LUT Index. Enter the new value.
  5. Repeat steps 3 and 4 as necessary.
  6. Enable LUT to have changes take effect.

For coding purposes, LUT Value All provides access to all the LUT coefficients in a single string without using an individual LUT Index.

Since only one LUT is available for users to access and control, in RGB and YUV pixel formats, the same LUT applies to all three channels (i.e., red, green and blue). In monochrome and Bayer formats, there is a single channel, regardless of the color or monochrome image sensor.

Note that the customized LUT is not saved into the camera permanently. After power cycling, the LUT returns to the factory default.

Summary Table

Name Interface Access Visibility Description
LUT Selector IEnumeration Expert Selects which LUT to control.
LUT Enable [LUT Selector] IBoolean Expert Activates the selected LUT.
LUT Index [LUT Selector] IInteger Guru Control the index (offset) of the coefficient to access in the selected LUT.
LUT Value [LUT Selector] [LUT Index] IInteger Guru Returns the Value at entry LUTIndex of the LUT selected by LUTSelector.
LUT Value All [LUT Selector] IRegister Guru Accesses all the LUT coefficients in a single access without using individual LUTIndex.

LUT Control Features


LUT Selector

Selects which LUT to control.

Property Value
Name LUTSelector
Interface IEnumeration
Access
Visibility Expert

Enumeration Values
LUT1

LUT Enable

Activates the selected LUT.

Property Value
Name LUTEnable [LUT Selector]
Interface IBoolean
Access
Visibility Expert

LUT Index

Control the index (offset) of the coefficient to access in the selected LUT.

Property Value
Name LUTIndex [LUT Selector]
Interface IInteger
Access
Unit
Visibility Guru

LUT Value

Returns the Value at entry LUTIndex of the LUT selected by LUTSelector.

Property Value
Name LUTValue [LUT Selector] [LUT Index]
Interface IInteger
Access
Unit
Visibility Guru

LUT Value All

Accesses all the LUT coefficients in a single access without using individual LUTIndex.

Property Value
Name LUTValueAll [LUT Selector]
Interface IRegister
Access
Visibility Guru

 

8/13/2018
© 2015-2018 FLIR® Integrated Imaging Solutions Inc.
All rights reserved.
Legal
| Contact Support

Blackfly®S BFS-GE-16S2-BD2
Camera Reference

FLIR Camera and API References