User`s manual

Color Creation and Enhancement AW00098504000
132 Basler ace Camera Link
8.3 Color Enhancement Features
8.3.1 White Balance
White balance capability has been implemented on color models of the camera. White balancing
can be used to adjust the color balance of the images transmitted from the camera.
With the white balancing scheme used on these cameras, the red intensity, green intensity, and blue
intensity can each be 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.2, the intensity of that color will be increased by
20%.
The balance ratio value can range from 0.00 to 15.984. 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.
Setting the White Balance Using Basler pylon
Setting the Balance Ratio parameter for a color using Basler pylon is a two step process:
 Set the Balance Ratio Selector to red, green, or blue.
 Set the Balance Ratio Abs parameter to the desired value for the selected color.
You can use the pylon API to set the Balance Ratio Selector and the Balance Ratio Abs parameter
value from within your application software. The following code snippet illustrates using the API to
set the selector and the parameter value:
// Set the red balance ratio
This section (Section 8.3) describes how a color camera’s white balance can be
adjusted "manually", i.e., by setting the value of the Balance Ratio Abs parameters
for red, green, and blue.
The camera also has a White Balance Auto function that can automatically adjust
the white balance. Manual adjustment of the Balance Ratio Abs parameters
for red, green, and blue will only work correctly if the Balance White Auto
function is disabled.
For more information about auto functions in general, see Section 10.9 on
page 189.
For more information about the Balance White Auto function, see Section 10.9.7
on page 206.