Basler acA2000-165, User Manual

Page: 222 / 272

Features AW00123402000
212 Basler ace USB 3.0
8.11.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.
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 Exposure
Auto 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
camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1);
camera.AutoFunctionAOIUseBrightness.SetValue(true);
camera.AutoFunctionAOIUseWhiteBalance.SetValue(true);
// Select the unused Auto Function ROI 2
// Disable the unused Auto Function ROI
camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI2);
camera.AutoFunctionAOIUseBrightness.SetValue(false);
camera.AutoFunctionAOIUseWhiteBalance.SetValue(false);
You can also use the Basler pylon Viewer application to easily set the parameters.
We strongly recommend not to assign an auto function to more than one Auto
Function ROI although multiple assignments can be made