neser 1.1.0

NESER - Nintendo Emulation Systems Engine (Rust). Desktop and WebAssembly frontends.
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

#![allow(dead_code)] // Public API for future use in native frontend
use crate::frontends::native::gl_backend::RenderTarget;

use glutin::context::PossiblyCurrentContext;
use glutin::prelude::*;
use glutin::surface::{Surface, SwapInterval, WindowSurface};
use winit::window::Window;

use std::num::NonZeroU32;
use std::sync::Arc;

/// Winit/glutin-backed render target implementing the backend-agnostic
/// [`RenderTarget`] trait used by [`GlBackend`](crate::frontends::native::gl_backend::GlBackend).
pub struct WinitRenderTarget {
    window: Arc<Window>,
    surface: Surface<WindowSurface>,
    gl_context: PossiblyCurrentContext,
}

impl WinitRenderTarget {
    pub fn new(
        window: Arc<Window>,
        surface: Surface<WindowSurface>,
        gl_context: PossiblyCurrentContext,
    ) -> Self {
        Self {
            window,
            surface,
            gl_context,
        }
    }

    /// Returns a reference to the underlying winit window.
    pub fn window(&self) -> &Window {
        &self.window
    }

    /// Sets the swap interval (vsync) on the GL surface.
    pub fn set_swap_interval(&self, vsync: bool) -> Result<(), String> {
        let interval = if vsync {
            SwapInterval::Wait(NonZeroU32::MIN)
        } else {
            SwapInterval::DontWait
        };
        self.surface
            .set_swap_interval(&self.gl_context, interval)
            .map_err(|e| format!("failed to set swap interval: {e}"))
    }
}

impl RenderTarget for WinitRenderTarget {
    fn window_size(&self) -> (u32, u32) {
        let size = self
            .window
            .inner_size()
            .to_logical::<u32>(self.window.scale_factor());
        (size.width, size.height)
    }

    fn drawable_size(&self) -> (u32, u32) {
        // inner_size() returns physical (HiDPI-aware) pixels.
        let size = self.window.inner_size();
        (size.width, size.height)
    }

    fn swap_buffers(&self) {
        if let Err(e) = self.surface.swap_buffers(&self.gl_context) {
            eprintln!("failed to swap GL buffers: {e}");
        }
    }

    fn make_current(&self) -> Result<(), String> {
        self.gl_context
            .make_current(&self.surface)
            .map_err(|e| format!("failed to make GL context current: {e}"))
    }

    fn set_fullscreen(&mut self, enabled: bool) -> Result<(), String> {
        self.window
            .set_fullscreen(enabled.then_some(winit::window::Fullscreen::Borderless(None)));
        Ok(())
    }

    fn set_mouse_grab(&mut self, enabled: bool) -> Result<(), String> {
        let mode = if enabled {
            winit::window::CursorGrabMode::Confined
        } else {
            winit::window::CursorGrabMode::None
        };
        self.window.set_cursor_grab(mode).or_else(|e| {
            if enabled {
                // Confined is unsupported on some platforms (e.g. macOS).
                // Silently succeed — cursor hiding via set_cursor_visible
                // is sufficient. We must NOT fall back to Locked because
                // Locked stops delivering absolute CursorMoved positions,
                // which breaks Arkanoid/Zapper coordinate tracking. SNES
                // Mouse uses the explicit set_mouse_grab_locked() instead.
                Ok(())
            } else {
                Err(format!("failed to release cursor grab: {e}"))
            }
        })
    }

    fn notify_resize(&mut self, w: u32, h: u32) {
        if let (Some(w), Some(h)) = (NonZeroU32::new(w), NonZeroU32::new(h)) {
            self.surface.resize(&self.gl_context, w, h);
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    /// Compile-time verification that WinitRenderTarget implements RenderTarget.
    fn _assert_render_target_impl(_: &dyn RenderTarget) {}

    #[allow(dead_code)]
    fn _type_check(rt: &WinitRenderTarget) {
        _assert_render_target_impl(rt);
    }
}