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

PolygonEllipticAxes

Header:	FIL.h
Namespace:	fil
Module:	FoundationBasic

Computes axes of an ellipse having the same first and second order moments as the given polygon.

Syntax

void fil::PolygonEllipticAxes
(
	const fil::Path& inPolygon,
	fil::Segment2D& outMajorAxis,
	fil::Segment2D& outMinorAxis
)

Parameters

	Name	Type	Default	Description
	inPolygon	const Path&
	outMajorAxis	Segment2D&
	outMinorAxis	Segment2D&

Description

The orientations of the resulting axes are always between 0 and 180 degrees.

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.

Errors

List of possible exceptions:

Error type	Description
DomainError	Degenerate polygon on input in PolygonEllipticAxes.