Unit agnostic angle.
Using simple floating point numbers to store an angle value is error-prone : you may add two angle with one in radians and the second in degrees or you may try to compute the cosine of a value in degrees and get an unexpected result.
angulus
provides a type that represent an angle with no specific unit.
use angulus::{Angle, ToAngle};
use angulus::units::Degrees;
// Create an angle of 90°.
let alpha = 90.0_f32.deg();
// Create an angle of π/4 rad (45°).
let beta = Angle::RAD_FRAC_PI_4;
// Add the two angle without worrying about units.
let gamma = alpha + beta;
// Print the result.
println!(
"The cosine of {} is {}",
Degrees(gamma), // The angle is wrapped to display the value in degrees.
gamma.cos() // Compute the cosine without worrying about units.
);
// Output : The cosine of 135° is -0.70710677
std
: by default angulus links to the standard library. Disable this feature to remove this dependency and be able to use angulus in#![no_std]
crates.libm
: use the libm crate for the math methods (sin, cos, tan) whenstd
is disabled.serde
: enable serialization and deserialization with the serde crate.rand
: enable generation of random angle with the rand crate.
This crate requires Rust 1.61.0 or later.
Licensed under either of the following, at your choice:
Unless explicitly stated otherwise, any contribution intentionally submitted for inclusion in this crate, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions.