euv-engine 0.12.27

A high-performance 2D game engine built on the euv framework, featuring ECS, fixed-timestep game loop, canvas rendering, physics, collision detection, sprite animation, and audio.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

/// The trait that game implementations must fulfill to receive
/// fixed-timestep update and interpolated render callbacks from the scheduler.
pub trait TickHandler {
    /// Called at a fixed interval defined by `SchedulerConfig::fixed_timestep`.
    ///
    /// All game logic, physics, and state mutations should happen here.
    ///
    /// # Arguments
    ///
    /// - `f64` - The fixed delta time in seconds.
    fn on_update(&mut self, delta_time: f64);

    /// Called once per animation frame after all accumulated updates have been processed.
    ///
    /// The interpolation factor represents how far between fixed updates the current
    /// frame is, allowing smooth rendering at variable frame rates.
    ///
    /// # Arguments
    ///
    /// - `f64` - The interpolation factor in the range 0.0 to 1.0.
    fn on_render(&mut self, interpolation: f64);
}

/// A trait for objects that participate in the engine's update step.
///
/// All implementors receive the same fixed-timestep delta time; the engine's
/// scheduler is responsible for dispatching. Provides a single abstraction over
/// the `update` methods defined on `Entity`, `Animator`, `SceneManager`, and
/// the `World2D` / `World3D` physics containers, enabling generic iteration
/// (e.g. `Vec<Box<dyn Updatable>>`).
///
/// `SchedulerState::tick` calls into this trait through the `TickHandler`
/// trait; per-domain implementors (entities, scenes, sprites, physics worlds)
/// expose their own `update` method that satisfies this contract.
pub trait Updatable {
    /// Advance the object's internal state by the given delta time.
    ///
    /// # Arguments
    ///
    /// - `f64` - The delta time in seconds since the last update.
    fn update(&mut self, delta_time: f64);
}