Features AW00123409000
280 Basler ace USB 3.0
Particular Importance for the acA3800-14uc and acA4600-10uc
As a result of the cameras’ sensor design, images output by the acA3800-14uc and acA4600-10uc
cameras can display an artifact color shift. You can remove the artifact color shift by using the
balance white feature.
Several conditions ("imaging conditions"; see below) govern the occurrence of the artifact color
shift. Accordingly, for color shift removal, you must apply the balance white feature whenever at
least one of the relevant imaging conditions changes.
Among the imaging conditions are the following:
Optical system: exchange of lens, change of aperture, change of focus
Illumination: change of the type of illumination, change of the arrangement of light sources,
change of brightness
Camera settings and features: The artifact color shift depends on several camera settings and
features, in particular exposure time, Black Level, Digital Shift, Binning Horizontal, Binning
Vertical, LUT, some image ROI-related settings (Width, Height, OffsetX, OffsetY, CenterX,
CenterY).
Setting the Balance White Feature
1. Set the Balance Ratio Selector to red, green, or blue.
2. Set the Balance Ratio parameter to the desired value for the selected color.
You can set the Balance Ratio Selector and the Balance Ratio 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 color for white balancing and set the related BalanceRatio value
camera.BalanceRatioSelector.SetValue(BalanceRatioSelector_Green);
camera.BalanceRatio.SetValue(1.25);
You can also use the Basler pylon Viewer application to easily set the parameters.
For more information about the pylon API and the pylon Viewer, see Section 3.1 on page 61.
Keep in mind from the above that color shift removal requires that you apply the
balance white feature in many situations when you normally would not do so, for
example after having changed the lens focus.
To set the Balance Ratio parameter value for color using Basler pylon: