Basler Pioneer User Manual page 196

Standard Features
Setting the AOI
By default, the AOI is set to use the full resolution of the camera's sensor. You can change the size
and the position of the AOI by changing the value of the camera's X Offset, Y Offset, Width, and
Height parameters.
The value of the X Offset parameter determines the starting column for the area of interest.
The value of the Y Offset parameter determines the starting line for the area of interest.
The value of the Width parameter determines the width of the area of interest.
The value of the Height parameter determines the height of the area of interest.
When you are setting the camera's area of interest, you must follow these guidelines on all camera
models:
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-210gm, 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.
On monochrome cameras:
The X Offset, Y Offset, Width, and Height parameters can be set in increments of 1.
On color cameras:
The X Offset, Y Offset, Width, and Height parameters can be set in increments of 2 and they
must be set to an even number. For example, the X Offset parameter can be set to 0, 2, 4, 6, 8,
etc.
Note
Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to
the physical columns and lines in the sensor. But if binning is enabled, these
parameters are set in terms of "virtual" columns and lines. For more
information, see Section 13.6 on
You can set the X Offset, Y Offset, Width, and Height parameter values from within your application
software by using the pylon API. The following code snippets illustrate using the API to get the
maximum allows settings and the increments for the Width and Height parameters. They also
illustrate setting the X Offset, Y Offset, Width, and Height parameter values
int64_t widthMax = Camera.Width.GetMax( );
int64_t widhInc = Camera.Width.GetInc();
Camera.Width.SetValue( 200 );
Camera.OffsetX.SetValue( 100 );
int64_t heightMax = Camera.Height.GetMax( );
int64_t heightInc = Camera.Height.GetInc();
186
page 188.
Basler pioneer