Back to FabImage Library website

You are here: Start » Function Reference » Path » Polygon Features » PolygonMassCenter

PolygonMassCenter


Header: FIL.h
Namespace: fil
Module: FoundationBasic

Computes the mass center of polygon.

Syntax

C++
C#
 
void fil::PolygonMassCenter
(
	const fil::Path& inPolygon,
	fil::Point2D& outMassCenter
)

Parameters

Name Type Default Description
Input value inPolygon const Path&
Output value outMassCenter Point2D&

Description

The operation computes the mass center of a polygon bounded by a closed path.

Note that if the input path is not a valid polygon (i.e. it has at least one self-intersection), the computation may lead to results that are not intuitive.

Examples

The resulting outMassCenters drawn onto the sample polygon.

Errors

List of possible exceptions:

Error type Description
DomainError Degenerate polygon on input in PolygonMassCenter.
DomainError Open path on input in PolygonMassCenter.

See Also

  • PathMassCenter – Computes the average of the path points (all, not only characteristic ones).
  • RegionMassCenter – Computes a point with coordinates equal to the average coordinates of the region's pixels.