Struct Numeric 

pub struct Numeric;

A zero-sized namespace struct providing static math utility methods.

This struct follows the same pattern as App, serving as a namespace for free-standing mathematical functions such as clamp, lerp, angle conversions, and interpolation helpers.

Implementations

impl Numeric

Implements static math utility methods on the Numeric namespace struct.

pub fn clamp(value: f64, min: f64, max: f64) -> f64

Clamps a value between a minimum and maximum bound.

Arguments

• f64 - The value to clamp.
• f64 - The minimum allowed value.
• f64 - The maximum allowed value.

Returns

• f64 - The clamped value.

pub fn lerp(start: f64, end: f64, t: f64) -> f64

Performs linear interpolation between two values.

Arguments

• f64 - The start value.
• f64 - The end value.
• f64 - The interpolation factor, typically in the range 0.0 to 1.0.

Returns

• f64 - The interpolated value.

pub fn deg_to_rad(degrees: f64) -> f64

Converts an angle from degrees to radians.

Arguments

• f64 - The angle in degrees.

Returns

• f64 - The angle in radians.

pub fn rad_to_deg(radians: f64) -> f64

Converts an angle from radians to degrees.

Arguments

• f64 - The angle in radians.

Returns

• f64 - The angle in degrees.

pub fn normalize_angle(radians: f64) -> f64

Normalizes an angle to the range -PI to PI.

Arguments

• f64 - The angle in radians.

Returns

• f64 - The normalized angle in the range -PI to PI.

pub fn angle_delta(from: f64, to: f64) -> f64

Computes the shortest angular difference between two angles.

Arguments

• f64 - The source angle in radians.
• f64 - The target angle in radians.

Returns

• f64 - The signed angular delta in the range -PI to PI.

pub fn lerp_angle(from: f64, to: f64, t: f64) -> f64

Performs angular interpolation taking the shortest path around the circle.

Arguments

• f64 - The source angle in radians.
• f64 - The target angle in radians.
• f64 - The interpolation factor, typically in the range 0.0 to 1.0.

Returns

• f64 - The interpolated angle in radians.

pub fn distance(a: Vector2D, b: Vector2D) -> f64

Computes the Euclidean distance between two 2D points.

Arguments

• Vector2D - The first point.
• Vector2D - The second point.

Returns

• f64 - The distance between the two points.

pub fn distance_squared(a: Vector2D, b: Vector2D) -> f64

Computes the squared Euclidean distance between two 2D points.

Avoids a square root, making it faster for comparison-only use cases.

Arguments

• Vector2D - The first point.
• Vector2D - The second point.

Returns

• f64 - The squared distance between the two points.

pub fn smoothstep(edge_min: f64, edge_max: f64, value: f64) -> f64

Computes a smoothstep interpolation factor using a cubic Hermite polynomial.

Arguments

• f64 - The edge minimum.
• f64 - The edge maximum.
• f64 - The input value.

Returns

• f64 - The smoothstep result in the range 0.0 to 1.0.

pub fn approach(current: f64, target: f64, max_delta: f64) -> f64

Moves current towards target by at most max_delta.

Arguments

• f64 - The current value.
• f64 - The target value.
• f64 - The maximum allowed change.

Returns

• f64 - The new value moved towards target.

pub fn sign(value: f64) -> f64

Returns the sign of a value as -1.0, 0.0, or 1.0.

Arguments

• f64 - The input value.

Returns

• f64 - -1.0 if negative, 0.0 if zero, 1.0 if positive.

pub fn wrap(value: f64, max: f64) -> f64

Wraps a value into the range 0.0 to max.

Arguments

• f64 - The value to wrap.
• f64 - The upper bound of the range.

Returns

• f64 - The wrapped value in the range 0.0 to max.

pub fn sign_or_positive(value: f64) -> f64

Returns 1.0 if the value is positive, -1.0 otherwise.

Arguments

• f64 - The input value.

Returns

• f64 - 1.0 if the value is non-negative, -1.0 otherwise.

pub fn distance_3d(a: Vector3D, b: Vector3D) -> f64

Computes the Euclidean distance between two 3D points.

Arguments

• Vector3D - The first point.
• Vector3D - The second point.

Returns

• f64 - The distance between the two points.

pub fn distance_squared_3d(a: Vector3D, b: Vector3D) -> f64

Computes the squared Euclidean distance between two 3D points.

Avoids a square root, making it faster for comparison-only use cases.

Arguments

• Vector3D - The first point.
• Vector3D - The second point.

Returns

• f64 - The squared distance between the two points.

impl Numeric

pub fn new() -> Self

Trait Implementations

impl Clone for Numeric

fn clone(&self) -> Numeric

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Numeric

impl Debug for Numeric

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

Formats the value using the given formatter.

impl Default for Numeric

fn default() -> Numeric

Returns the “default value” for a type.

impl Eq for Numeric

impl Hash for Numeric

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Numeric

fn cmp(&self, other: &Numeric) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Numeric

fn eq(&self, other: &Numeric) -> 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 PartialOrd for Numeric

fn partial_cmp(&self, other: &Numeric) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Numeric