Back to Adaptive Vision Library Lite websiteYou are here:
Start »
Region Features »
RegionMassCenter
Computes a point with coordinates equal to the average coordinates of the region's pixels.
Syntax
void avl::RegionMassCenter
(
const avl::Region& inRegion,
avl::Point2D& outMassCenter
)
Parameters
|
Name |
Type |
Default |
Description |
 |
inRegion |
const Region& |
|
Input region |
 |
outMassCenter |
Point2D& |
|
|
Description
The operation computes the average of all pixel locations contained in a region. Note that the result is a Point2D, not a Location as its coordinates may be not-integer.
Hints
- If the input region is not guaranteed to be non-empty, precede this filter with SkipEmptyRegion.
Examples
The resulting outMassCenter point drawn onto the sample region.
Errors
| Error type |
Description |
| DomainError |
Input region is empty in RegionMassCenter. |
| DomainError |
Input region area above 2^30 in RegionMassCenter. |
| DomainError |
Point-run length above 2^15 in RegionMassCenter. |
