Image Region Of Interest (Roi) - Basler acA2040-55 User Manual

Features
7.6

Image Region of Interest (ROI)

The image region of interest (ROI) feature lets you specify a portion of the sensor array and after
each image is acquired, only the pixel information from the specified portion of the array is
transmitted out of the camera.
The region of interest is referenced to the top left corner of the sensor array. The top left corner is
designated as column 0 and row 0 as shown in Figure 86.
The location and size of the region of interest is defined by declaring an offset X (coordinate), a
width, an offset Y (coordinate), and a height. For example, suppose that you specify the offset X as
10, the width as 16, the offset Y as 6, and the height as 10. The region of the array that is bounded
by these settings is shown in
The camera will only transmit pixel data from within the region defined by your settings. Information
from the pixels outside of the region of interest is discarded.
Column
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
Row
0
1
2
Offset
3
Y
4
5
6
7
8
9
10
Height
11
12
13
14
15
16
17
18
19
Fig. 86: Region of Interest
One of the main advantages of the image ROI feature is that decreasing the height of the ROI can
increase the camera's maximum allowed acquisition frame rate.
For more information about how changing the ROI height affects the maximum allowed frame rate,
see Section 6.10 on page
208
Figure 86.
Offset X
Width
178.
AW00123409000
The camera
will only
transmit the
pixel data
from this
region
Basler ace USB 3.0