Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Geometry 2D » Geometry 2D Angle Metrics » AngleBetweenSegments

AngleBetweenSegments


Module: FoundationLite

Measures the angle between two segments with one of four possible metrics.

Name Type Description
inSegment1 Segment2D First segment
inSegment2 Segment2D Second segment
inAngleMetric AngleMetric Chooses one of four possible ways of measuring the angle
inAutodetectOrientation Bool Autodetects orientation of the segments assuming that these are two consecutive sides of a polygon
outAbsoluteAngle Real Angle value used for measurements <0; 360>
outDirectedAngle Real Angle value used for clockwise transformations <-360; 360>
outArc Arc2D Angle visualization object

Description

Angle between segments can be interpreted in two different ways:

  1. Segments as vectors - the angle is measured from the first to the second vector clockwise or counter-clockwise.
  2. Segments as consecutive sides of a polygon - the angle is measured from the first to the second side clockwise or counter-clockwise.

The method that is appropriate in a particular case can be chosen with the inAngleMetric input. Possible values are:

  • VectorClockwiseAngle
  • VectorCounterClockwiseAngle
  • PolygonClockwiseAngle
  • PolygonCounterClockwiseAngle

Segment Orientation

We do not usually care about orientation of a segment. However, when measuring angles, this information is important. In the most typical application, which is measuring an angle between two consecutive sides of a polygon, orientation of the segments is used together with inAngleMetric to determine the corner point and the side of the polygon (inside or outside). This information can also be obtained automatically by considering the intersection point between lines containing the segments. The inAutodetectOrientation parameter is there for that purpose. However, keep in mind that this method may produce unexpected results when the segments are parallel or nearly parallel.

Note that because of inaccuracies of floating-point arithmetic, some geometric operations (including this one) may lead to unpredictable results for degenerated cases. In this filter such a case occurs when an empty segment is given on input.

Examples

Description of usage of this filter can be found in examples and tutorial: L-pipe measurements.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Unsupported angle metric in AngleBetweenSegments.

Complexity Level

This filter is available on Basic Complexity Level.

See Also