Basler acA2000-165, User Manual

Page: 173 / 272

AW00123402000 Color Creation and Enhancement
Basler ace USB 3.0 163
The correction for a specific light source uses a color transformation matrix that is automatically
populated by coefficients ("color transformation values") suitable for the set light source. The color
transformation values modify color-specific gain for red, green, and blue. The identity matrix is used
when "Off" is selected as the light source preset.
Setting the Light Source Presets
You can use the Light Source Preset parameter value to set the correction for a specific light source
or chose no correction. You can set the parameter value from within your application software by
using the Basler pylon API. The following code snippet illustrates using the API to set the selector
and the parameter value:
// Set the LightSourcePreset parameter value to "Off" (no correction)
camera.LightSourcePreset.SetValue(LightSourcePreset_Off);
//Set the LightSourcePreset parameter value to "Daylight5000K"
camera.LightSourcePreset.SetValue(LightSourcePreset_Daylight5000K);
// Set the LightSourcePreset parameter value to "Daylight6500K"
camera.LightSourcePreset.SetValue(LightSourcePreset_Daylight6500K);
// Set the LightSourcePreset parameter value to "Tungsten2800K"
camera.LightSourcePreset.SetValue(LightSourcePreset_Tungsten2800K);
When using a light source preset for a color camera, a gamma correction value of
approximately 0.4 will automatically be applied, corresponding to an sRGB
gamma correction value.
Under these circumstances, we recommend not to explicitly set a gamma
correction value. If you do nonetheless you will alter the effect of the selected light
source preset.
If you select "Off" as the light source preset no gamma correction value will
automatically be applied.
For more information about the gamma correction feature, see Section 8.10 on
page 207 .