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

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sdl_context = sdl3::init()?;
    let joystick_subsystem = sdl_context.joystick()?;
    let haptic_subsystem = sdl_context.haptic()?;

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

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

    // Iterate over all available joysticks and stop once we manage to open one.
    let joystick_id = joysticks
        .into_iter()
        .find_map(|id| match joystick_subsystem.open(id) {
            Ok(c) => {
                println!("Success: opened \"{}\"", c.name());
                Some(id)
            }
            Err(e) => {
                println!("failed: {e:?}");
                None
            }
        })
        .expect("Couldn't open any joystick");

    let mut haptic = haptic_subsystem
        .open_from_joystick_id(joystick_id.into())
        .map_err(|e| e.to_string())?;

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

        match event {
            Event::JoyAxisMotion {
                axis_idx,
                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_idx} moved to {val}");
                }
            }
            Event::JoyButtonDown { button_idx, .. } => {
                println!("Button {button_idx} down");
                haptic.rumble_play(0.5, 500);
            }
            Event::JoyButtonUp { button_idx, .. } => println!("Button {button_idx} up"),
            Event::JoyHatMotion { hat_idx, state, .. } => {
                println!("Hat {hat_idx} moved to {state:?}")
            }
            Event::Quit { .. } => break,
            _ => (),
        }
    }

    Ok(())
}