Back to FabImage Library website

You are here: Start » Function Reference » Path » Path Features » PathTurnAngleMaximum

PathTurnAngleMaximum


Header: FIL.h
Namespace: fil
Module: FoundationPro

Finds the maximum of the profile of turn angles of a path.

Syntax

C++
C#
 
void fil::PathTurnAngleMaximum
(
	const fil::Path& inPath,
	fil::TurnAngleDirection::Type inAllowedTurnDirection,
	fil::TurnAnglePrecision::Type inResultPrecision,
	float& outMaximumTurnAngleIndex,
	fil::Point2D& outMaximumTurnAnglePoint,
	float& outMaximumTurnAngleAngle
)

Parameters

Name Type Default Description
Input value
 inPath const Path& Input path
Input value
 inAllowedTurnDirection TurnAngleDirection::Type All Allows to detect only left-turns, only right-turns or both
Input value
 inResultPrecision TurnAnglePrecision::Type Switches between pixel-precise or subpixel-precise detection of the found maximum
Output value
 outMaximumTurnAngleIndex float& Index of found maximum
Output value
 outMaximumTurnAnglePoint Point2D& Found point of a path with maximum turn angle
Output value
 outMaximumTurnAngleAngle float& Maximal turn angle of the input path

Description

The operation computes the profile of turn angles of a path and finds the maximum of the profile. The inAllowedTurnDirection parameter restricts kind of turns taken into consideration (left-turns only, right-turns only or both), while inResultPrecision determines the precision of the resulting maximum point.

Examples

PathTurnAngleMaximum run on the sample path with inAllowedTurnDirection = Right

Errors

List of possible exceptions:

Error type Description
DomainError Path with no turn angle on input in PathTurnAngleMaximum.

See Also