euv-engine 0.12.21

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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

use crate::*;

/// Implements `Default` for `RenderConfig` with sensible default values.
impl Default for RenderConfig {
    fn default() -> RenderConfig {
        RenderConfig {
            backend: RenderBackendType::default(),
            canvas_selector: CONFIG_DEFAULT_CANVAS_SELECTOR.to_string(),
            width: CONFIG_DEFAULT_CANVAS_WIDTH,
            height: CONFIG_DEFAULT_CANVAS_HEIGHT,
            quality: RenderQuality::default(),
            antialias: CONFIG_DEFAULT_ANTIALIAS,
            power_preference: GpuPowerPreference::default(),
            ssaa_scale_factor: CONFIG_DEFAULT_SSAA_SCALE_FACTOR,
        }
    }
}

/// Implements `Default` for `EngineConfig` with default render and scheduler configs.
impl Default for EngineConfig {
    fn default() -> EngineConfig {
        EngineConfig {
            render: RenderConfig::default(),
            scheduler: SchedulerConfig::default(),
        }
    }
}

/// Implements construction helpers for `RenderConfig`.
impl RenderConfig {
    /// Creates a rendering configuration for the Canvas 2D backend.
    ///
    /// # Arguments
    ///
    /// - `S: AsRef<str>` - The CSS selector for the canvas element.
    /// - `f64` - The viewport width in CSS pixels.
    /// - `f64` - The viewport height in CSS pixels.
    ///
    /// # Returns
    ///
    /// - `RenderConfig` - The Canvas 2D rendering configuration.
    pub fn canvas2d<S>(canvas_selector: S, width: f64, height: f64) -> RenderConfig
    where
        S: AsRef<str>,
    {
        RenderConfig {
            backend: RenderBackendType::Canvas2D,
            canvas_selector: canvas_selector.as_ref().to_string(),
            width,
            height,
            ..RenderConfig::default()
        }
    }

    /// Creates a rendering configuration for the WebGPU backend.
    ///
    /// # Arguments
    ///
    /// - `S: AsRef<str>` - The CSS selector for the canvas element.
    /// - `f64` - The viewport width in CSS pixels.
    /// - `f64` - The viewport height in CSS pixels.
    ///
    /// # Returns
    ///
    /// - `RenderConfig` - The WebGPU rendering configuration.
    pub fn webgpu<S>(canvas_selector: S, width: f64, height: f64) -> RenderConfig
    where
        S: AsRef<str>,
    {
        RenderConfig {
            backend: RenderBackendType::WebGpu,
            canvas_selector: canvas_selector.as_ref().to_string(),
            width,
            height,
            ..RenderConfig::default()
        }
    }
}

/// Implements construction helpers for `EngineConfig`.
impl EngineConfig {
    /// Creates an engine configuration with the given render config and default scheduler.
    ///
    /// # Arguments
    ///
    /// - `RenderConfig` - The rendering configuration.
    ///
    /// # Returns
    ///
    /// - `EngineConfig` - The engine configuration.
    pub fn create(render: RenderConfig) -> EngineConfig {
        EngineConfig {
            render,
            scheduler: SchedulerConfig::default(),
        }
    }

    /// Sets the scheduler configuration and returns the updated config.
    ///
    /// # Arguments
    ///
    /// - `SchedulerConfig` - The scheduler configuration.
    ///
    /// # Returns
    ///
    /// - `EngineConfig` - The updated engine configuration.
    pub fn with_scheduler(mut self, scheduler: SchedulerConfig) -> EngineConfig {
        self.set_scheduler(scheduler);
        self
    }
}

/// Implements WebGPU power preference conversion for `GpuPowerPreference`.
impl GpuPowerPreference {
    /// Converts this power preference to the WebGPU string value.
    ///
    /// Used to set the `powerPreference` field on `GpuRequestAdapterOptions`
    /// via `Reflect::set`, avoiding a direct dependency on the
    /// `web_sys::GpuPowerPreference` type.
    ///
    /// # Returns
    ///
    /// - `&'static str` - The WebGPU power preference string (e.g., `"low-power"`).
    pub fn to_web_sys_string(&self) -> &'static str {
        match self {
            GpuPowerPreference::LowPower => "low-power",
            GpuPowerPreference::HighPerformance => "high-performance",
        }
    }
}