User`s manual

Features
Basler aviator Camera Link 131
7.8.7 Balance White Auto
Balance White Auto is the "automatic" counterpart to manually setting the white balance. The
balance white auto function is only available on color models.
Automatic white balancing is a two-step process. First, the Balance Ratio Abs parameter values for
red, green, and blue are each set to 1.5. Then, assuming a "gray world" model, the Balance Ratio
Abs parameter values are automatically adjusted such that the average values for the "red" and
"blue" pixels match the average value for the "green" pixels.
The balance white auto function uses Auto Function AOI 2 and can only be operated in the "once"
mode of operation.
If Auto Function AOI 2 does not overlap the Image AOI (see the "Auto Function AOI" section) the
pixel data from Auto Function AOI 2 will not be used to control the white balance of the image.
However, as soon as the Balance White Auto function is set to "once" operation mode, the Balance
Ratio parameter values for red, green, and blue are each set to 1.5. These settings will then control
the white balance of the image.
For more information about the "manual" white balance settings, see Section 7.8.7 on page 131.
Setting the Balance White Auto Function Using Basler pylon
Setting the balance white auto functionality using Basler pylon is a several step process:
 Select the Auto Function AOI 2.
 Set the value of the Offset X, Offset Y, Width, and Height parameters for the AOI.
 Set the value of the Exposure Auto parameter for the "once" or the "continuous" mode of
operation.
You can set the white balance auto functionality from within your application software by using the
pylon API. The following code snippets illustrate using the API to set the balance auto functionality:
// Select auto function AOI 2
Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 );
// Set the position and size of selected auto function AOI. In this example, we set
// auto function AOI to cover the entire sensor.
Camera.AutoFunctionAOIOffsetX.SetValue( 0 );
Camera.AutoFunctionAOIOffsetY.SetValue( 0 );
Note that on cameras delivered from the factory, the exposure auto, gain auto, and
white balance auto (on color cameras) functions will all become enabled
whenever you power on or reset the camera. This behavior happens due to the
way that the camera’s configuration sets are set in the factory. More specifically, it
happens because the auto functions factory setup is selected as the default
configuration set and the default configuration set is designated as the "startup"
set. To change this behavior, you must change the configuration set settings. For
more information about configuration sets, see Section 7.19 on page 170.