Balance White Auto - Basler acA2040-55 User Manual

Features

7.15.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 parameter values for red,
green, and blue are each set to 1.5. Then, assuming a "gray world" model, the Balance Ratio
parameter values are automatically adjusted such that the average values for the "red" and "blue"
pixels match the average value for the "green" pixels.
Either Auto Function ROI can be selected to work with the balance white auto function.
If the selected Auto Function ROI does not overlap the Image ROI (see the "Auto Function ROI"
section) the pixel data from the Auto Function ROI 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
control the white balance of the image.
For more information about setting the white balance "manually", see Section 7.14.3.1 on
page 278.
To set the balance white function using Basler pylon:
1. Select the Auto Function ROI, for example, ROI 2.
2. Set the value of the Offset X, Offset Y, Width, and Height parameters for the ROI.
3. 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 ROI 2
camera.AutoFunctionROISelector.SetValue
(AutoFunctionROISelector_ROI2);
// Set the position and size of selected auto function ROI. In this
//example, we set
// auto function ROI to cover the entire sensor.
camera.AutoFunctionROIOffsetX.SetValue( 0 );
camera.AutoFunctionROIOffsetY.SetValue( 0 );
camera.AutoFunctionROIWidth.SetValue( camera.AutoFunctionROI-
Width.GetMax() );
camera.AutoFunctionROIHeight.SetValue( camera.AutoFunctionROI-
Height.GetMax() );
// Set mode of operation for balance white auto function
camera.BalanceWhiteAuto.SetValue(BalanceWhiteAuto_Once);
308
AW00123409000
Basler ace USB 3.0