Basler pilot - Balance White Auto

Features
192 Basler pilot
11.12.5Balance White Auto
Balance White Auto is an auto function and the "automatic" counterpart of the manual white balance
feature. The balance white auto function is only available on color models.
The automatic white balance 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 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 AOI2 and can only be operated in the "once"
mode of operation.
If Auto Function AOI2 does not overlap the Image AOI (see the "Auto Function AOI" section) the
pixel data from Auto Function AOI2 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 Abs parameter values for red, green, and blue are each set to 1.5. These settings will control
the white balance of the image.
For information on the white balance feature, see Section 11.3 on page 155.
To use the balance white auto function, carry out the following steps:
1. Select Auto Function AOI2.
2. Set the postion and size of Auto Function AOI2.
3. Enable the balance white auto function by setting it to "once".
You can carry out steps 1 to 3 from within your application software by using the pylon API. The
following code snippet illustrates using the API to use the auto function:
 Selecting and setting Auto Function AOI2: See the "Auto Function AOI" section above.
 Enabling the balance white auto function and selecting the "once" mode of operation:
// Set AOI for white balance statistics
// Currently AutoFunctionAOISelector_AOI2 is predefined to gather
// white balance statistics
// Set position and size of the auto function AOI
Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 );
Camera.AutoFunctionAOIOffsetX.SetValue( 0 );
Camera.AutoFunctionAOIOffsetY.SetValue( 0 );
Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() );
Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() );
// Set mode of operation for balance white auto function
Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once );