sdl3 0.18.0

Bindings to SDL3, a cross-platform library to abstract the platform-specific details for building applications.
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

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // This is required for certain controllers to work on Windows without the
    // video subsystem enabled:
    sdl3::hint::set("SDL_JOYSTICK_THREAD", "1");

    let sdl_context = sdl3::init()?;
    let gamepad_subsystem = sdl_context.gamepad()?;

    let gamepad_joysticks_ids = gamepad_subsystem
        .gamepads()
        .map_err(|e| format!("can't enumerate gamepads: {e}"))?;

    println!("{} gamepads available", gamepad_joysticks_ids.len());

    // Iterate over all available joysticks and look for game controllers.
    let mut controller = gamepad_joysticks_ids
        .into_iter()
        .find_map(|id| {
            println!("Attempting to open gamepad {}", id.0);

            match gamepad_subsystem.open(id) {
                Ok(c) => {
                    // We managed to find and open a game controller,
                    // exit the loop
                    println!(
                        "Success: opened \"{}\"",
                        c.name().unwrap_or_else(|| "(unnamed)".to_owned())
                    );
                    Some(c)
                }
                Err(e) => {
                    println!("failed: {e:?}");
                    None
                }
            }
        })
        .expect("Couldn't open any gamepad");

    println!(
        "Controller mapping: {}",
        controller.mapping().unwrap_or("".to_owned())
    );

    let (mut lo_freq, mut hi_freq) = (0, 0);

    for event in sdl_context.event_pump()?.wait_iter() {
        use sdl3::event::Event;
        use sdl3::gamepad::Axis;

        match event {
            Event::ControllerAxisMotion {
                axis: Axis::TriggerLeft,
                value: val,
                ..
            } => {
                // Trigger axes go from 0 to 32767, so this should be okay
                lo_freq = (val as u16) * 2;
                match controller.set_rumble(lo_freq, hi_freq, 15000) {
                    Ok(()) => println!("Set rumble to ({lo_freq}, {hi_freq})"),
                    Err(e) => println!("Error setting rumble to ({lo_freq}, {hi_freq}): {e:?}"),
                }
            }
            Event::ControllerAxisMotion {
                axis: Axis::TriggerRight,
                value: val,
                ..
            } => {
                // Trigger axes go from 0 to 32767, so this should be okay
                hi_freq = (val as u16) * 2;
                match controller.set_rumble(lo_freq, hi_freq, 15000) {
                    Ok(()) => println!("Set rumble to ({lo_freq}, {hi_freq})"),
                    Err(e) => println!("Error setting rumble to ({lo_freq}, {hi_freq}): {e:?}"),
                }
            }
            Event::ControllerAxisMotion {
                axis, value: val, ..
            } => {
                // Axis motion is an absolute value in the range
                // [-32768, 32767]. Let's simulate a very rough dead
                // zone to ignore spurious events.
                let dead_zone = 10_000;
                if val > dead_zone || val < -dead_zone {
                    println!("Axis {axis:?} moved to {val}");
                }
            }
            Event::ControllerButtonDown { button, .. } => println!("Button {button:?} down"),
            Event::ControllerButtonUp { button, .. } => println!("Button {button:?} up"),
            Event::ControllerTouchpadDown {
                touchpad,
                finger,
                x,
                y,
                ..
            } => println!("Touchpad {touchpad} down finger:{finger} x:{x} y:{y}"),
            Event::ControllerTouchpadMotion {
                touchpad,
                finger,
                x,
                y,
                ..
            } => println!("Touchpad {touchpad} move finger:{finger} x:{x} y:{y}"),
            Event::ControllerTouchpadUp {
                touchpad,
                finger,
                x,
                y,
                ..
            } => println!("Touchpad {touchpad} up   finger:{finger} x:{x} y:{y}"),
            Event::Quit { .. } => break,
            _ => (),
        }
    }

    Ok(())
}