Struct VirtualTime 

pub struct VirtualTime {
    pub paused: bool,
    pub scale: f64,
    pub max_delta: f64,
    pub elapsed: f64,
}

Virtual time controls: pause, speed scaling, and max-delta clamping.

Insert this resource to gain time control. If absent, the game loop uses raw host elapsed (backward compatible).

Example

use galeon_engine::VirtualTime;

let mut vt = VirtualTime::new();
assert!((vt.effective_elapsed(0.5) - 0.25).abs() < f64::EPSILON); // clamped to max_delta

vt.paused = true;
assert_eq!(vt.effective_elapsed(1.0), 0.0);

vt.paused = false;
vt.scale = 2.0;
assert!((vt.effective_elapsed(0.1) - 0.2).abs() < f64::EPSILON);

Fields

paused: bool

When true, effective_elapsed() always returns 0.

scale: f64

Speed multiplier. Clamped to [0.0, 8.0].

• 1.0 = normal
• 0.5 = half speed
• 2.0 = double speed

max_delta: f64

Raw elapsed is clamped to this value before scaling. Prevents death spirals when the host delivers a huge frame delta (e.g., tab was backgrounded). Default: 0.25 s.

elapsed: f64

Total virtual time elapsed since engine start. Accumulated by game_loop::tick() each frame.

Implementations

impl VirtualTime

pub fn new() -> Self

Create with default settings: unpaused, scale 1.0, max_delta 0.25 s.

pub fn effective_elapsed(&self, raw: f64) -> f64

Transform raw host elapsed into virtual elapsed.

Returns 0.0 when paused. Otherwise clamps raw to max_delta, then multiplies by scale (clamped to [0.0, 8.0]).

Trait Implementations

impl Default for VirtualTime

fn default() -> Self

Returns the “default value” for a type.