Supported by...


All Pixelink cameras support a 10-bit Lookup Table, with some cameras supporting a 12-bit Lookup Table. 


Description


The Lookup Table (LUT) typically has a number (typically 1024 or 4096) of 2-byte entries that range in value from 0 to 1023 (10-bit depth).  The LUT is used to implement the IIDC Gamma feature but it can also be used to implement any LUT transfer function required.


The LUT is written to camera memory as a block of 1024 words at the address specified by the Lookup Table Offset register, starting with Word 0 (Black).


When the LUT or Gamma function is active (ON), every pixel is converted according to the transfer function stored in the LUT.  With both functions off, the LUT is bypassed and a linear transfer function is used.


Since both Gamma and the LUT use the same camera memory, whichever function was last turned on will control the memory and the other function will be turned off.  Turning on the Gamma function will overwrite the LUT with the appropriate gamma values.  


Turning on the LUT will disable Gamma but will leave the camera memory unchanged.  If the LUT is turned off, the LUT values will be retained in camera memory and will be applied again once the LUT is turned on.


If the bit-depth of the camera is greater than that of the LUT,  the LUT output will be linearly interpolated.  


API Control

PxLGetFeature, PxLSetFeature


Feature ID
Number of Params
Parameters
Units 
Restrictions

FEATURE_LOOKUP_TABLE

Lookup table control

1 ( See Note Below)


fValue [MAX]


N/A


Integer Only



Note: When using the Pixelink API to access the Lookup Table feature it behaves differently than all other features. When querying the supported features of the camera using PxLGetCameraFeatures it will return that FEATURE_LOOKUP_TABLE only has one parameter. The min and max value of this parameter will be 0 and the maximum number of entries respectively. When getting or setting the value of the lookup table using PxLGetFeature or PxLSetFeature the number of parameters should be set to the maximum number of entries and each parameter represents an entry in the lookup table.


Note: The stream state must be off (STREAM_OFF) to modify this feature.  See PxLSetStreamState.  


Feature Flags


Camera
Presence
Read Only
Auto
Manual
One-time Auto 
Off 
CiD

All Cameras

Yes

No

No

Yes

No

Yes

No


Parameters


Camera
Parameter
Unit
Type
Min
Max
Default
Step Size

All cameras

LUT

None

Absolute

0

1024

N/A

1