Basler ace acA1920-155, User Manual, Page: 193 / 326

AW00123404000 Color Creation and Enhancement
Basler ace USB 3.0 183
Setting the White Balance
With the white balancing scheme used on the cameras, the red intensity, green intensity, and blue
intensity can be individually adjusted. For each color, a Balance Ratio parameter is used to set the
intensity of the color. If the Balance Ratio parameter for a color is set to a value of 1, the intensity
of the color will be unaffected by the white balance mechanism. If the ratio is set to a value lower
than 1, the intensity of the color will be reduced. If the ratio is set to a value greater than 1, the
intensity of the color will be increased. The increase or decrease in intensity is proportional. For
example, if the Balance Ratio for a color is set to 1.25, the intensity of that color will be increased
by 25 %.
The Balance Ratio parameter value can range from 0.00 to 15.99976. But you should be aware that,
if you set the balance ratio for a color to a value lower than 1, this will not only decrease the intensity
of that color relative to the other two colors, but will also decrease the maximum intensity that the
color can achieve. For this reason, we don’t normally recommend setting a balance ratio less than
1 unless you want to correct for the strong predominance of one color.
1. Set the Balance Ratio Selector to red, green, or blue.
2. Set the Balance Ratio parameter to the desired value for the selected color.
You can set the Balance Ratio Selector and the Balance Ratio 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 for green as an example:
This section (Section 7.3.1) describes how a color camera’s white balance can be
adjusted "manually", i.e., by setting the value of the Balance Ratio parameters for
red, green, and blue.
The camera also has a Balance White Auto function that can automatically adjust
the white balance.
Manual adjustment of the Balance Ratio parameters for
red, green, and blue will only work, if the Balance White Auto function is
disabled.
For more information about auto functions in general, see Section 8.12 on
page 261 .
For more information about the Balance White Auto function, see Section 8.12.7
on
page 275 .
When you set the Light Source Preset to match your light source characteristics
and/or make changes to the entries in the color transformation matrix, the camera
will automatically make adjustments to the white balance settings so that they are
best suited for the current settings.
For more information about using the color transformation matrix, see
Section 7.3.4 on
page 191 .
To set the Balance Ratio parameter value for color using Basler pylon: