repame-shell 0.3.25

Repose platform runner wrappers, sim stepping, viewport mount, and gamepad polling
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

use std::cell::RefCell;
use std::rc::Rc;

use repose_core::input::{Key, Modifiers};
use repose_core::shortcuts::{self, Action};

pub fn game_shortcut_map(
    pause: &'static str,
    restart: &'static str,
    confirm: &'static str,
) -> shortcuts::ShortcutMap {
    shortcuts::ShortcutMap::new()
        .bind(Key::Escape, Modifiers::default(), action_for(pause))
        .bind(
            Key::Character('r'),
            Modifiers::default(),
            action_for(restart),
        )
        .bind(Key::Enter, Modifiers::default(), action_for(confirm))
}

fn action_for(name: &'static str) -> Action {
    Action::Custom(name.into())
}

#[derive(Default)]
pub struct ShortcutEdges {
    pub pause: bool,
    pub restart: bool,
    pub confirm: bool,
}

pub type SharedEdges = Rc<RefCell<ShortcutEdges>>;

pub fn shared_edges() -> SharedEdges {
    Rc::new(RefCell::new(ShortcutEdges::default()))
}

pub fn shortcut_handler(
    edges: &SharedEdges,
    pause: &'static str,
    restart: &'static str,
    confirm: &'static str,
) -> shortcuts::Handler {
    let inner = edges.clone();
    Rc::new(move |action| {
        let mut e = inner.borrow_mut();
        match action {
            Action::Custom(key) if key.as_ref() == pause => {
                e.pause = true;
                true
            }
            Action::Custom(key) if key.as_ref() == restart => {
                e.restart = true;
                true
            }
            Action::Custom(key) if key.as_ref() == confirm => {
                e.confirm = true;
                true
            }
            _ => false,
        }
    })
}

/// Compose the game map + edges handler once in the root view
/// (mount-once under the hood: safe to call every frame on desktop,
/// web, and Android-with-keyboard alike). One call per game; no
/// per-key duplication at call sites.
pub fn install_game_shortcuts(
    edges: &SharedEdges,
    pause: &'static str,
    restart: &'static str,
    confirm: &'static str,
) {
    let _ = shortcuts::InstallShortcutMap(game_shortcut_map(pause, restart, confirm));
    let _ = shortcuts::InstallShortcutHandler(shortcut_handler(edges, pause, restart, confirm));
}

/// Overwrite the process-global default shortcut map (tests and headless
/// compose without a runner use this path).
pub fn install_map(map: shortcuts::ShortcutMap) {
    shortcuts::set_default_map(map);
}

/// Install only the action handler into long-lived `edges`
/// (tests and headless compose without a runner use this path).
pub fn install_handler_into(
    edges: &SharedEdges,
    pause: &'static str,
    restart: &'static str,
    confirm: &'static str,
) {
    shortcuts::set(Some(shortcut_handler(edges, pause, restart, confirm)));
}

pub fn take(edges: &SharedEdges) -> (bool, bool, bool) {
    let mut e = edges.borrow_mut();
    (
        std::mem::take(&mut e.pause),
        std::mem::take(&mut e.restart),
        std::mem::take(&mut e.confirm),
    )
}