Multiple ROI Acquisition

More than one region of interest can be used with pl_exp_setup_seq or pl_exp_setup_cont functions. The number of ROIs supported by the camera can be obtained by reading PARAM_ROI_COUNT with ATTR_MAX prior to configuring the acquisition. The Embedded Frame Metadata feature must be enabled in order to use multiple ROIs.

To acquire a multi-ROI frame, a sequence of steps should be followed:

1. Embedded Frame Metadata feature is enabled.
2. pl_exp_setup_seq or pl_exp_setup_cont is called with rgn_array and rgn_total specifying the array of regions to capture.
3. pl_exp_start_seq or pl_exp_start_cont is called to start the acquisition.
4. Once the frame arrives, it can be decoded or recomposed using the process described in the Embedded Frame Metadata chapter.

Note

Please, refer to the Multiple Regions code sample to get more information about the use of Multiple ROI Acquisition.