User`s manual
Color Creation and Enhancement  AW00098504000
138 Basler ace Camera Link
8.3.3.1 "Custom" Light Source Setting
The RGB to RGB color matrix conversion for each pixel is performed by multiplying a 1 x 3 matrix 
containing R, G, and B color values with a 3 x 3 matrix containing correction values. Each column 
in the 3 x 3 matrix can be populated with values of your choice. In other words:
Where Gain00, Gain01, etc. are settable values. 
Keep in mind that ace Camera Link cameras use sensors with a Bayer pattern filter and that they 
do not interpolate the pixel values. This means that when the camera is a doing matrix correction 
for a particular pixel, only one actual color value will be available for that pixel. To fill in the other two 
color values in the 1 x 3 matrix, the camera uses values from neighboring pixels. After making the 
correction calculations, the camera only transmits the result for the actual pixel color and discards 
the other two calculated values. For example, if the camera is correcting the value for a red pixel, it 
will populate the 1 x 3 matrix with the actual value for the red pixel. It will then populate the green 
and blue positions in the matrix with values from a neighboring green and a neighboring blue pixel. 
After making the matrix correction calculations, the camera will discard the green and blue values 
from the result and only transmit the red value.
Each GainXY position can each be populated with a floating point value ranging from -8.0 to 
+7.96875 by using the Color Transformation Value Selector to select one of the GainXX positions 
in the matrix and using the Color transformation Value parameter to enter a value for that position.
As an alternative the Gain XY values can each be entered as an integer value on a scale ranging 
from -256 to +255. This integer range maps linearly to the floating point range with -256 being 
equivalent to -8.0, 32 being equivalent to 1.0, and +255 being equivalent to +7.96875. The integer 
values can be entered using the Color transformation Value Raw parameter.
A reference article that explains the basics of color matrix transformation for video data can be 
found at:
http://www.its.bldrdoc.gov/pub/ntia-rpt/04-406/index.php
The "Custom" setting for the Light Source Selector parameter is intended for use 
by someone who is thoroughly familiar with matrix color transformations. It is 
nearly impossible to enter correct values in the conversion matrix by trial 
and error. 
 Gain00 Gain01 Gain02 
 Gain10 Gain11 Gain12 
 Gain20 Gain21 Gain22 
 R 
 G 
 B 
 R 
 G 
 B 
=










