Setting An Auto Function Roi - Basler acA2040-55 User Manual

Features

7.15.3.3 Setting an Auto Function ROI

Setting an Auto Function ROI is a two-step process: You must first select the Auto Function ROI
related to the auto function that you want to use and then set the size and the position of the Auto
Function ROI.
By default, an Auto Function ROI is set to the full resolution of the camera's sensor. You can change
the size and the position of an Auto Function ROI by changing the value of the Auto Function ROI's
X Offset, Y Offset, Width, and Height parameters.
The value of the X Offset parameter determines the starting column for the Auto Function ROI.

The value of the Y Offset parameter determines the starting row for the Auto Function ROI.

The value of the Width parameter determines the width of the Auto Function ROI.

The value of the Height parameter determines the height of the Auto Function ROI.

When you are setting an Auto Function ROI, you must follow these guidelines:
The sum of the Offset X setting plus the Width setting must not exceed the width of the

camera's sensor. For example, on the acA1920-25um, the sum of the Offset X setting plus the
Width setting must not exceed 1920.
The sum of the Offset Y setting plus the Height setting must not exceed the height of the

camera's sensor. For example, on the acA1920-25um, the sum of the Offset Y setting plus the
Height setting must not exceed 1080.
The X Offset, Y Offset, Width, and Height parameters can be set in increments of 1.
On color cameras, we strongly recommend setting the Offset X, Offset Y, Width,
and Height parameters for an Auto Function ROI in increments of 2 to make the
Auto Function ROI match the color filter pattern of the sensor. For example, you
should set the X Offset parameter to 0, 2, 4, 6, 8, etc.
Normally, the Offset X, Offset Y, Width, and Height parameter settings for an Auto
Function ROI refer to the physical columns and lines in the sensor. But if binning
is enabled (monochrome cameras only), these parameters are set in terms of
"virtual" columns and lines, i.e. the settings for an Auto Function ROI will refer to
the binned lines and columns in the sensor and not to the physical lines in the
sensor as they normally would.
For more information about the concept of a "virtual sensor", see Section 7.8.4 on
You can select an Auto Function ROI and set the Offset X, Offset X, Width, and Height parameter
values for the Auto Function ROI from within your application software by using the Basler pylon
API. The following code snippets illustrate using the API to select an Auto Function ROI and to get
the maximum allowed settings for the Width and Height parameters. The code snippets also
300
AW00123409000
page 251.
Basler ace USB 3.0