Dart Angles

Official Dart package

This package provides an Angle type seeking to eliminate the use of variable suffixes like ...deg or ...rad as well as manual angle unit conversions such as x * rad2deg and the likes.

Therefore, this package's raison d'être is not to serve features but to increase code maintainability, thus reducing maintaince cost and bugs.

Angles can be constructed from these units: degrees, radians, gradians and turns.

Unit	Quantity of a full turn
Degree	360°
Radian	2π
Gradian	400ᵍ
Turn	1

Sample code

// Various ways to define a half turn:
a0 = Angle.degrees(180.0);
a1 = Angle.radians(math.pi);
a2 = Angle.turns(0.5);

a0.degrees; // = 180.0
a1.radians; // = 3.1415...
a2.turns;   // = 0.5

You can also convert strings to angles.

// Various ways to parse a half turn:
Angle.parse("180deg"); // = 180.0
Angle.parse("180.0°"); // = 180.0
Angle.parse("0.0° 10800.0′ 0.0″"); // = 180.0
Angle.parse("180degrees"); // = 180.0
Angle.parse("pi rad"); // = π
Angle.parse("π radians"); // = π
Angle.parse("200ᵍ"); // = 200ᵍ
Angle.parse("200 gradians"); // = 200ᵍ

Documentation

Constructors:

• Angle.degrees(x)
• Angle.radians(x)
• Angle.gradians(x)
• Angle.turns(x)
• Angle.parse(x)

Accessors:

• .degrees()
• .radians()
• .gradians()
• .turns()

Trigonometric functions:

• .sin()
• .cos()
• .tan()
• Angle.asin(x)
• Angle.acos(x)
• Angle.atan(x)
• Angle.atan2(y, x)
• Angle.atanFullTurn(y, x)
• Angle.cartesian(x, y)

Utility functions:

• .toString()
• .approximately(other, range)
• .ratio(other)
• .normalized

All arithmetic and relational operators are defined on angles as well.