Assignment Of An Auto Function To An Auto Function Roi - Basler acA2040-55 User Manual

AW00123409000

7.15.3.1 Assignment of an Auto Function to an Auto Function ROI

By default, the Gain Auto and the Exposure Auto auto functions are assigned to Auto Function
ROI 1 and the Balance White Auto auto function is assigned to Auto Function ROI 2. The
assignments can, however, be set as desired. For example, the Balance White Auto auto function
can be assigned to Auto Function ROI 1 or all auto functions can be assigned to the same Auto
Function ROI.
We strongly recommend not to assign an auto function to more than one Auto
Function ROI although multiple assignments can be made
One limitation must be borne in mind: For the purpose of making assignments, the Gain Auto and
the Exposure Auto auto functions are always considered as a single "brightness" auto function and
therefore the assignment is always identical for both auto functions. For example, if you assign the
"brightness" auto function to Auto Function ROI 2 the Gain Auto and the Exposure Auto auto
functions should both assigned to Auto Function ROI 2. This does not imply, however, that the Gain
Auto and the Exposure Auto auto functions must always be used at the same time.
You can assign auto functions to Auto Function ROIs from within your application software by using
the pylon API.
As an example, the following code snippet illustrates using the API to assign the Gain Auto and
Exposure Auto auto function - considered as a single "brightness" auto function - and the Balance
White auto function to Auto Function ROI 1.
The snippet also illustrates disabling the unused Auto Function ROI 2 to avoid assigning any auto
function to more than one Auto Function ROI.
// Select Auto Function ROI 1
// Assign auto functions to the selected Auto Function ROI
ROI
camera.AutoFunction
ROI
camera.AutoFunction
ROI
camera.AutoFunction
// Select the unused Auto Function ROI 2
// Disable the unused Auto Function ROI
ROI
camera.AutoFunction
ROI
camera.AutoFunction
ROI
camera.AutoFunction
You can also use the Basler pylon Viewer application to easily set the parameters.
Basler ace USB 3.0
Selector.SetValue(AutoFunction
UseBrightness.SetValue(true);
UseWhiteBalance.SetValue(true);
Selector.SetValue(AutoFunction
UseBrightness.SetValue(false);
UseWhiteBalance.SetValue(false);
ROI ROI
Selector_ 1);
ROI ROI
Selector_ 2);
Features
297