pixel8-player 0.2.0

Pixel8 cart player over the console runtime: a windowed desktop backend or a static-musl KMS/evdev/ALSA backend for handhelds
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

//! The platform seam: everything device-specific (display, input) lives behind this trait,
//! so the picker and game loop are written once and tested headless.

// The KMS backend compiles only when it is the backend `main::real_backend`
// selects: `window` wins when both features are on, so a both-features build
// would otherwise carry the whole KMS stack as dead code.
#[cfg(all(feature = "kms", not(feature = "window")))]
pub mod alsa;
#[cfg(any(feature = "kms", feature = "window"))]
pub mod blit;
#[cfg(all(feature = "kms", not(feature = "window")))]
pub mod evdev;
#[cfg(all(feature = "kms", not(feature = "window")))]
pub mod kms;
pub mod null;
#[cfg(feature = "window")]
pub mod window;

use anyhow::Result;
use pixel8_runtime::fb::Framebuffer;

/// A display + input backend. Audio is owned internally by the backend (see `KmsPlatform`),
/// pulled from the shared synth, so it is not part of this surface.
pub trait Platform {
    /// Scale, rotate and letterbox a 128x128 indexed frame onto the screen.
    fn present(&mut self, fb: &Framebuffer) -> Result<()>;

    /// A snapshot of input for this frame.
    fn poll(&mut self) -> InputSnapshot;
}

/// One frame's input: the six console buttons plus the meta signals the loops act on.
#[derive(Clone, Copy, Default)]
pub struct InputSnapshot {
    /// Console buttons: 0 left, 1 right, 2 up, 3 down, 4 O, 5 X.
    pub buttons: [bool; 6],
    /// A named Select (when the device exposes one), used for back-to-picker.
    pub select: bool,
    /// A named Start, used with Select for quit.
    pub start: bool,
    /// The OS asked us to quit (SIGTERM / console close).
    pub quit_requested: bool,
    /// The fps meter was toggled this frame (edge, F1).
    pub fps_toggle: bool,
}

/// Screen rotation applied during the blit, for panels mounted rotated.
#[cfg(any(feature = "kms", feature = "window"))]
#[derive(Clone, Copy, PartialEq, Eq)]
pub enum Rotate {
    None,
    Cw90,
    Cw180,
    Cw270,
}

#[cfg(any(feature = "kms", feature = "window"))]
impl Rotate {
    /// `PIXEL8_ROTATE=0|90|180|270` overrides `default`; an unset/invalid value keeps `default`.
    pub fn from_env_or(default: Rotate) -> Rotate {
        match std::env::var("PIXEL8_ROTATE").ok().as_deref() {
            Some("0") => Rotate::None,
            Some("90") => Rotate::Cw90,
            Some("180") => Rotate::Cw180,
            Some("270") => Rotate::Cw270,
            _ => default,
        }
    }
}