Measures the angle between two segments with one of four possible metrics.
|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|
Angle between segments can be interpreted in two different ways:
- Segments as vectors - the angle is measured from the first to the second vector clockwise or counter-clockwise.
- 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:
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.
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
|DomainError||Unsupported angle metric in AngleBetweenSegments.|
This filter is available on Basic Complexity Level.