Struct Radians 

pub struct Radians(pub f32);

A type-safe wrapper for angular measurements in radians.

Range: Usually normalized to (-π, π] for flight dynamics.

Tuple Fields

0: f32

Implementations

impl Radians

pub fn normalize(&self) -> Self

Normalizes the angle to the range (-π, π].

This is essential for preventing “the long way around” maneuvers and ensuring the PID controller receives the smallest possible error.

Performance

This implementation uses a deterministic approach to ensure consistent execution time in real-time flight loops.

pub fn shortest_distance_to(&self, target: Radians) -> f32

Calculates the shortest angular distance to a target.

Returns a value in the range (-π, π]. A positive result indicates a clockwise rotation, while a negative result indicates counter-clockwise.

Example

Moving from 179° to -179° will return a distance of 2° (0.035 rad) instead of -358°.

Trait Implementations

impl Clone for Radians

fn clone(&self) -> Radians

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Radians

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Radians

fn default() -> Radians

Returns the “default value” for a type.

impl From<Degrees> for Radians

fn from(degrees: Degrees) -> Self

Converts Degrees to Radians. Used for ingesting user configuration into the flight-ready physics engine.

impl From<Radians> for Degrees

fn from(radians: Radians) -> Self

Converts Radians to Degrees using the standard constant π.

impl PartialEq for Radians

fn eq(&self, other: &Radians) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Radians

impl StructuralPartialEq for Radians