Standard Features AW00097603000
186 Basler aviator GigE
10.7.9 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 the Auto Function AOI that was related to the Balance White
Auto function. The balance white auto function can be operated in the "once" mode of operation
and in the "continuous" mode of operation. For information about the "once" mode of operation and
the "continuous" mode of operation, see Section 10.7.2 on page 173.
If the related Auto Function AOI does not overlap the Image AOI (see the "Auto Function AOI"
section) the pixel data from the Auto Function AOI 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 setting the white balance "manually", see Section 8.3.1 on page 113.
Setting the balance white auto functionality using Basler pylon is a several step process:
Select the Auto Function AOI to which the Balance White Auto is assigned.
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 to which the Balance White Auto function is assigned
// For this example, assume that the Balance White Auto function is
// assigned to Auto 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.
Note that on cameras delivered from the factory, all auto functions will become
disabled whenever you power on or reset the camera.
If you load the auto functions factory set as the default configuration set and the
default configuration set is designated as the "startup" set, by default the exposure
auto function is enabled.
To change this behavior, you must change the configuration set settings. For more
information about configuration sets, see Section 10.19 on page 254.
To Next Page
Loading...
Need help?
General
