You are here: Start » Function Reference » Region Features » RegionMassCenter

RegionMassCenter

Computes a point with coordinates equal to the average coordinates of the region's pixels.

Header:	AVL.h

Syntax

void avl::RegionMassCenter
(
	const avl::Region& inRegion,
	avl::Point2D& outMassCenter
)

void RegionMassCenter
(
	Region inRegion,
	out 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.