Balance White - Basler DART BCON SERIES User Manual

Features
11.6.3

Balance White

By default, the balance white auto function is enabled. Manual adjustment
of the white balance will not work.
Set the BalanceWhiteAuto parameter to Off before making any manual
adjustments.
For more information about the balance white auto function, see Section 11.11.5
on page
The Balance White feature allows you to manually correct color shifts. A digital gain correction can
be applied per color (red, green, blue) so that white objects in the camera's field of view appear
white in the acquired images.
While the Light Source Preset feature is useful to preconfigure the white balance based on fixed
preset values (see Section 11.6.2 on
white balance for your specific imaging conditions.
The white balance is effective on all pixel data output formats including "raw" pixel formats (Bayer 8
and Bayer 12).
Setting the White Balance
You can perform white balancing by adjusting the intensity of the colors red, green, and blue in your
images. Each color can be individually adjusted using the BalanceRatio parameter.
To set the white balance:
1. Set the BalanceRatioSelector parameter to Red, Green, or Blue.
2. Set the BalanceRatio parameter to the desired value for the selected color channel.
The BalanceRatio parameter value can range from 1 to 7.984375:
BalanceRatio = 1: The intensity of the color is unaffected by the white balance mechanism.

Balance ratio > 1: The intensity of the color is increased relative to the other two colors.

Balance ratio < 1: The intensity of the color is decreased relative to the other two colors.

The increase or decrease in intensity is proportional. For example, if the balance ratio for a color is
set to 1.25, the intensity of that color is increased by 25 %.
You can set the BalanceRatioSelector and the BalanceRatio parameter value from within your
application software by using the Basler pylon API. The following code snippet illustrates using the
API to set the selector and the parameter value for green as an example:
// Select the green color channel and set its intensity to 125%
camera.BalanceRatioSelector.SetValue(BalanceRatioSelector_Green);
camera.BalanceRatio.SetValue(1.25);
92
119.
page 90), the Balance White feature lets you fine-tune the
AW00136902000
Basler dart BCON