codecraft 0.2.0

A minimalist 3D game engine built on parts of Bevy (ECS, color) with wgpu and winit: OpenPBR materials, clustered lighting, a yakui-drawn UI, audio and gamepad haptics; its binary maps any folder, and the symbols of its Rust files, as a 3D wall of boxes
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

//! Keyboard state, published into the ECS world each frame.
use std::collections::HashSet;

use crate::ecs::Resource;

pub use winit::keyboard::KeyCode;

/// Which keys are down, and which went down this frame (`just_pressed` is a one-frame edge).
#[derive(Resource, Default, Debug)]
pub struct Keys {
    pressed: HashSet<KeyCode>,
    just_pressed: HashSet<KeyCode>,
}

impl Keys {
    pub fn pressed(&self, key: KeyCode) -> bool {
        self.pressed.contains(&key)
    }

    pub fn just_pressed(&self, key: KeyCode) -> bool {
        self.just_pressed.contains(&key)
    }

    pub(crate) fn press(&mut self, key: KeyCode, repeat: bool) {
        // Key repeat is the OS re-sending a held key; it must not read as a fresh press.
        if !repeat && self.pressed.insert(key) {
            self.just_pressed.insert(key);
        }
    }

    pub(crate) fn release(&mut self, key: KeyCode) {
        self.pressed.remove(&key);
    }

    pub(crate) fn end_frame(&mut self) {
        self.just_pressed.clear();
    }
}

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

    #[test]
    fn a_press_is_an_edge_that_lasts_one_frame() {
        let mut keys = Keys::default();
        keys.press(KeyCode::Escape, false);

        assert!(keys.just_pressed(KeyCode::Escape));
        assert!(keys.pressed(KeyCode::Escape));

        keys.end_frame();
        assert!(!keys.just_pressed(KeyCode::Escape), "the edge is spent");
        assert!(keys.pressed(KeyCode::Escape), "but the key is still held");
    }

    #[test]
    fn key_repeat_does_not_read_as_a_new_press() {
        let mut keys = Keys::default();
        keys.press(KeyCode::Escape, false);
        keys.end_frame();

        keys.press(KeyCode::Escape, true);
        assert!(!keys.just_pressed(KeyCode::Escape));

        keys.press(KeyCode::Escape, false);
        assert!(!keys.just_pressed(KeyCode::Escape));
    }

    #[test]
    fn releasing_and_pressing_again_is_a_fresh_edge() {
        let mut keys = Keys::default();
        keys.press(KeyCode::Escape, false);
        keys.end_frame();
        keys.release(KeyCode::Escape);
        assert!(!keys.pressed(KeyCode::Escape));

        keys.press(KeyCode::Escape, false);
        assert!(keys.just_pressed(KeyCode::Escape));
    }

    #[test]
    fn keys_are_tracked_independently() {
        let mut keys = Keys::default();
        keys.press(KeyCode::Escape, false);
        keys.press(KeyCode::Space, false);
        keys.release(KeyCode::Escape);

        assert!(!keys.pressed(KeyCode::Escape));
        assert!(keys.pressed(KeyCode::Space));
    }
}