Features
Basler pilot 185
Setting an Auto Function AOI
Setting an Auto Function AOI is a two-step process: You must first select the Auto Function AOI
related to the auto function that you want to use and then set the size and the position of the Auto
Function AOI.
By default, an Auto Function AOI is set to the full resolution of the camera’s sensor. You can change
the size and the position of an Auto Function AOI by changing the value of the Auto Function AOI’s
X Offset, Y Offset, Width, and Height parameters.
The value of the X Offset parameter determines the starting column for the Auto Function AOI.
The value of the Y Offset parameter determines the starting line for the Auto Function AOI.
The value of the Width parameter determines the width of the Auto Function AOI.
The value of the Height parameter determines the height of the Auto Function AOI.
When you are setting an Auto Function AOI, you must follow these guidelines:
The sum of the X Offset setting plus the Width setting must not exceed the width of the
camera’s sensor. For example, on the piA640-21gm0, the sum of the X Offset setting plus the
Width setting must not exceed 648.
The sum of the Y Offset setting plus the Height setting must not exceed the height of the
camera’s sensor. For example, on the piA640-210gm, the sum of the Y Offset setting plus the
Height setting must not exceed 488.
The X Offset, Y Offset, Width, and Height parameters can be set in increments of 1.
For more information about the concept of a "virtual sensor", see Section 11.7.1 on page 168.
You can select an Auto Function AOI and set the X Offset, Y Offset, Width, and Height parameter
values for the Auto Function AOI from within your application software by using the pylon API. The
following code snippets illustrate using the API to select an Auto Function AOI and to get the
maximum allowed settings for the Width and Height parameters. The code snippets also illustrate
setting the X Offset, Y Offset, Width, and Height parameter values. As an example, Auto Function
AOI1 is selected:
On color cameras, we strongly recommend setting the X Offset, Y Offset, Width,
and Height parameters for an Auto Function AOI in increments of 2 to make the
Auto Function AOI match the Bayer filter pattern of the sensor. For example, you
should set the X Offset parameter to 0, 2, 4, 6, 8, etc.
Normally, the X Offset, Y Offset, Width, and Height parameter settings for an Auto
Function AOI 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 AOI will refer to
the binned lines and columns in the sensor and not to the physical lines in the
sensor as they normally would.