User`s manual

AW00089316000 Standard Features
Basler ace GigE 227
You can set the Offset X, Offset Y, Width, and Height parameter values from within your application
software by using the Basler pylon API. The following code snippets illustrate using the API to get
the maximum allowed settings and the increments for the Width and Height parameters. They also
illustrate setting the Offset X, Offset Y, 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();
Camera.Height.SetValue( 200 );
Camera.OffsetY.SetValue( 100 );
You can also use the Basler pylon Viewer application to easily set the parameters.
For more information about the pylon API and the pylon Viewer, see Section 3 on page 39.
10.5.1 Changing AOI Parameters "On-the-Fly"
Making AOI parameter changes “on-the-fly” means making the parameter changes while the
camera is capturing images continuously. On-the-fly changes are only allowed for the parameters
that determine the position of the AOI, i.e., the Offset X and Offset Y parameters. Changes to the
AOI size are not allowed on-the-fly.
Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the
physical columns and rows of pixels in the sensor. But if binning is enabled, these
parameters are set in terms of "virtual" columns and rows. For more information,
see Section 10.8.3 on page 270.