Say goodby to naming suffixes like ...deg
or ...rad
, manual angle conversions like x * rad2deg
and the inevitable mess when mixing up multiple angle units in your code.
This library provides a single class named Angle
, wrapping your angle variables in a far more readable way, whereas raw doubles aren't very expressive about how they store their values. One can create an angle from various units, including degrees, radians, gradians and turns.
// Various ways to define a half turn:
a0 = Angle.fromDegrees(180.0);
a1 = Angle.fromRadians(math.pi);
a2 = Angle.fromTurns(0.5);
a0.degrees; // = 180.0
a1.radians; // = 3.1415...
a2.turns; // = 0.5
Trigonometic functions are defined on instances:
x = Angle.asin(0.3);
y = x.sin; // = 0.3
Angles are immutable by design, but there are operators like +
, creating new angles:
// 270°:
x = Angle.halfTurn() + Angle.fromDegrees(90.0);
example/angles_example.dart
import 'package:angles/angles.dart';
import 'dart:math' as math;
main() {
// Various ways to define a half turn:
final x = Angle.fromDegrees(180.0);
final y = Angle.fromRadians(math.pi);
final z = Angle.fromTurns(0.5);
x.degrees; // = 180.0
x.radians; // = 3.1415...
x.turns; // = 0.5
// One can use builtin trigonometric functions:
final a = Angle.asin(0.3);
print(a.sin); // = 0.3
// Angles are immutable, but there are operators like +, creating new angles:
final threeQuarterTurn = Angle.halfTurn() + Angle.fromDegrees(90.0);
print(threeQuarterTurn); // 270°
}
Add this to your package's pubspec.yaml file:
dependencies:
angles: ^1.0.1
You can install packages from the command line:
with pub:
$ pub get
with Flutter:
$ flutter packages get
Alternatively, your editor might support pub get
or flutter packages get
.
Check the docs for your editor to learn more.
Now in your Dart code, you can use:
import 'package:angles/angles.dart';
Version  Uploaded  Documentation  Archive 

1.0.1  Feb 28, 2019  
1.0.0  Sep 23, 2018 
Popularity:
Describes how popular the package is relative to other packages.
[more]

69

Health:
Code health derived from static analysis.
[more]

100

Maintenance:
Reflects how tidy and uptodate the package is.
[more]

100

Overall:
Weighted score of the above.
[more]

85

We analyzed this package on Apr 12, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:
Detected platforms: Flutter, web, other
No platform restriction found in primary library
package:angles/angles.dart
.