Basler scout GigE, User Manual, Page: 198 / 374

Color Creation and Enhancement AW00011916000
188 Basler scout GigE
Each GainXY position can 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 GainXY 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
Setting Custom Matrix Values
You can set the Color Transformation Value Selector, Color Transformation Value, and Color
Transformation Value Raw parameters from within your application software by using the Basler
pylon API. The following code snippet illustrates using the API to set the values in the matrix. Note
that the values in this example are just randomly selected numbers and do not represent values
that you should actually use.
// Set the light source selector for custom
Camera.LightSourceSelector.SetValue ( LightSourceSelector_Custom );
// Select a position in the matrix
Camera.ColorTransformationValueSelector.SetValue
( ColorTransformationValueSelector_Gain01 );
// Set the value for the selected position as a floating point value
Camera.ColorTransformationValue.SetValue( 2.11 );
// Select a position in the matrix
Camera.ColorTransformationValueSelector.SetValue
( ColorTransformationValueSelector_Gain12 );
// Set the value for the selected position as an integer value
Camera.ColorTransformationValueRaw.SetValue( 135 );
You can also use the Basler pylon Viewer application to easily set the parameters.