You are here: Start » AVL.NET » AVL.AngleBetweenSegments(AvlNet.Segment2D, AvlNet.Segment2D, AvlNet.AngleMetric, bool, float, float, AvlNet.Arc2D)

AVL.AngleBetweenSegments(AvlNet.Segment2D, AvlNet.Segment2D, AvlNet.AngleMetric, bool, float, float, AvlNet.Arc2D)

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax


public static void AngleBetweenSegments(
	AvlNet.Segment2D inSegment1,
	AvlNet.Segment2D inSegment2,
	AvlNet.AngleMetric inAngleMetric,
	bool inAutodetectOrientation,
	out float outAbsoluteAngle,
	out float outDirectedAngle,
	out AvlNet.Arc2D outArc
)

Parameters

inSegment1
Type: AvlNet.Segment2D
inSegment2
Type: AvlNet.Segment2D
inAngleMetric
Type: AvlNet.AngleMetric
inAutodetectOrientation
Type: System.Boolean
outAbsoluteAngle
Type: System.Single
outDirectedAngle
Type: System.Single
outArc
Type: AvlNet.Arc2D

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

Errors

Error type Description
DomainError Unsupported angle metric in AngleBetweenSegments.

See also