Struct Fixed32 

#[repr(transparent)]
pub struct Fixed32(pub i32);

Fixed-point number with 16.16 format (16 integer bits, 16 fractional bits).

Guarantees identical results across ALL platforms per Monniaux (2008): “Floating-point non-determinism is a primary source of divergence in cross-platform replay systems.”

Examples

use jugar_web::trace::Fixed32;

let a = Fixed32::from_int(5);
let b = Fixed32::from_int(3);
assert_eq!((a + b).to_int(), 8);
assert_eq!((a - b).to_int(), 2);
assert_eq!((a * b).to_int(), 15);
assert_eq!((a / b).to_int(), 1); // Integer division

Tuple Fields

0: i32

Implementations

impl Fixed32

pub const FRAC_BITS: u32 = 16

Number of fractional bits (16.16 format)

pub const SCALE: i32

Scale factor (2^16 = 65536)

pub const ZERO: Self

Zero

pub const ONE: Self

One (1.0 in fixed-point)

pub const HALF: Self

Half (0.5 in fixed-point)

pub const MIN: Self

Minimum value

pub const MAX: Self

Maximum value

pub const EPSILON: Self

Epsilon (smallest positive value)

pub const PI: Self

Pi approximation (accurate to ~5 decimal places)

pub const fn from_raw(raw: i32) -> Self

Create from raw fixed-point value (internal representation).

pub const fn to_raw(self) -> i32

Get the raw fixed-point value.

pub const fn from_int(n: i32) -> Self

Create from integer.

pub const fn to_int(self) -> i32

Convert to integer (truncates fractional part).

pub fn from_f32(f: f32) -> Self

Create from f32 (use only for constants, not runtime game logic).

Warning

This conversion introduces platform-dependent rounding. Only use for initialization from constants; never in game update loops.

pub fn to_f32(self) -> f32

Convert to f32 (for rendering only, not game logic).

Warning

The result may differ slightly across platforms. Only use for rendering; never store or compare these values for game logic.

pub const fn saturating_add(self, other: Self) -> Self

Saturating addition (clamps to MIN/MAX instead of overflowing).

pub const fn saturating_sub(self, other: Self) -> Self

Saturating subtraction (clamps to MIN/MAX instead of overflowing).

pub const fn mul(self, other: Self) -> Self

Fixed-point multiplication with proper scaling.

Uses i64 intermediate to prevent overflow.

pub const fn saturating_mul(self, other: Self) -> Self

Saturating multiplication (clamps instead of overflowing).

pub const fn div(self, other: Self) -> Self

Fixed-point division with proper scaling.

Uses i64 intermediate to prevent overflow.

Panics

Panics if other is zero.

pub const fn checked_div(self, other: Self) -> Option<Self>

Checked division (returns None if divisor is zero).

pub const fn abs(self) -> Self

Absolute value.

pub const fn signum(self) -> Self

Sign of the number (-1, 0, or 1).

pub const fn is_negative(self) -> bool

Check if negative.

pub const fn is_positive(self) -> bool

Check if positive.

pub const fn is_zero(self) -> bool

Check if zero.

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

Clamp value to range [min, max].

pub const fn lerp(self, other: Self, t: Self) -> Self

Linear interpolation between self and other.

t should be between 0.0 and 1.0 (as Fixed32).

pub const fn floor(self) -> Self

Floor to integer (round toward negative infinity).

pub const fn ceil(self) -> Self

Ceiling to integer (round toward positive infinity).

pub const fn round(self) -> Self

Round to nearest integer.

pub const fn fract(self) -> Self

Get fractional part.

pub const fn checked_mul(self, other: Self) -> Option<Self>

Checked multiplication - returns None on overflow (Regehr 2012).

Use this in game logic where overflow indicates a bug that should be caught early in development.

Examples

use jugar_web::trace::Fixed32;

let a = Fixed32::from_int(100);
let b = Fixed32::from_int(50);
assert_eq!(a.checked_mul(b), Some(Fixed32::from_int(5000)));

// Overflow case
let big = Fixed32::MAX;
assert_eq!(big.checked_mul(Fixed32::from_int(2)), None);

pub const fn strict_mul(self, other: Self) -> Self

Strict multiplication - panics on overflow in all builds (Regehr 2012).

Use this in game logic where overflow indicates a bug. This is the safest option for catching bugs early.

Panics

Panics if the multiplication would overflow.

Examples

use jugar_web::trace::Fixed32;

let a = Fixed32::from_int(100);
let b = Fixed32::from_int(50);
assert_eq!(a.strict_mul(b), Fixed32::from_int(5000));

pub const fn checked_add(self, other: Self) -> Option<Self>

Checked addition - returns None on overflow.

pub const fn strict_add(self, other: Self) -> Self

Strict addition - panics on overflow.

Panics

Panics if the addition would overflow.

pub const fn checked_sub(self, other: Self) -> Option<Self>

Checked subtraction - returns None on overflow.

pub const fn strict_sub(self, other: Self) -> Self

Strict subtraction - panics on overflow.

Panics

Panics if the subtraction would overflow.

Trait Implementations

impl Add for Fixed32

type Output = Fixed32

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Fixed32

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl Clone for Fixed32

fn clone(&self) -> Fixed32

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Fixed32

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

Formats the value using the given formatter.

impl Default for Fixed32

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Fixed32

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Fixed32

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

Formats the value using the given formatter.

impl Div for Fixed32

type Output = Fixed32

The resulting type after applying the / operator.

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

Performs the / operation.

impl From<i32> for Fixed32

fn from(n: i32) -> Self

Converts to this type from the input type.

impl Hash for Fixed32

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 Mul for Fixed32

type Output = Fixed32

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for Fixed32

type Output = Fixed32

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl Ord for Fixed32

fn cmp(&self, other: &Fixed32) -> 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 Fixed32

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

fn partial_cmp(&self, other: &Fixed32) -> 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 Serialize for Fixed32

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub for Fixed32

type Output = Fixed32

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Fixed32

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl Copy for Fixed32

impl Eq for Fixed32

impl StructuralPartialEq for Fixed32