Basler ace acA640-90gm - Page 166

Color Creation and Enhancement
156 Basler ace GigE
Each GainXY position can each be populated with a floating point value ranging from -4.0 to
+3.98438 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 -4.0, 64 being equivalent to 1.0, and +255 being equivalent to +3.98438. 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 the Custom Mode
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.
// Select the color transformation type (assume an acA750-30gc camera, so the
// YUVtoRGB transformation type is appropriate
Camera.ColorTransformationSelector.SetValue
( ColorTransformationSelector_YUVtoRGB );
// Select the color transformation mode
Camera.ColorTransformationMode.SetValue( ColorTransformationMode_Custom );
// Select a position in the matrix
Camera.ColorTransformationValueSelector.SetValue
( ColorTransformationValueSelector_Gain10 );
// 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_Gain10 );
// 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.
For more information about the pylon API and the pylon Viewer, see Section 3 on page 27.