![]() |
PVCAM
3.9.x
Programmable Virtual Camera Access Method library
|
Centroids can be thought of as multiple ROIs that are chosen and generated by the camera itself. The users only specify how many ROIs they are interested in and what should their size be. The size and number of ROIs cannot change during acquisition, however, locations of the ROIs may change with each frame. Because of that, an embedded frame metadata must be included for every frame acquired. The frame may be recomposed using the same recomposing function(s) as described in the Embedded Frame Metadata chapter.
The Centroids feature can also be thought of as an "Object detection" feature. In the simplest form, a Centroid can be a pixel or group of adjacent pixels with higher intensity. A Centroid can also be a moving particle or a specific object the camera is trying to detect and/or track. For all available detection modes please see the PARAM_CENTROIDS_MODE parameter.
The Centroids feature is enabled by PARAM_CENTROIDS_ENABLED parameter. Other two parameters, the PARAM_CENTROIDS_COUNT and PARAM_CENTROIDS_RADIUS are used to define the desired number of centroids and their size. The Embedded Frame Metadata feature must be enabled before starting the Centroids acquisition.
By calling the pl_exp_setup_seq/pl_exp_setup_cont functions the user only specifies a single ROI where the Centroids shall be detected. User-defined multiple ROIs cannot be combined with this feature.
To use the centroids feature in an application, the following sequence of steps should be followed: