sdl 0.3.6

SDL bindings
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
116
117
118
119
120
121
122
123
124
125
126
127

use libc::c_int;
use std::ffi::CStr;
use std::str;

use get_error;

pub mod ll {
    #![allow(non_camel_case_types)]

    use libc::{c_void, c_int, uint8_t, int16_t};
    use libc::types::os::arch::c95::c_schar;

    pub type SDL_Joystick = c_void;

    extern "C" {
        pub fn SDL_NumJoysticks() -> c_int;
        pub fn SDL_JoystickName(i: c_int) -> *const c_schar;
        pub fn SDL_JoystickOpen(i: c_int) -> *mut SDL_Joystick;
        pub fn SDL_JoystickOpened(i: c_int) -> c_int;
        pub fn SDL_JoystickIndex(joystick: *mut SDL_Joystick) -> c_int;
        pub fn SDL_JoystickNumAxes(joystick: *mut SDL_Joystick) -> c_int;
        pub fn SDL_JoystickNumBalls(joystick: *mut SDL_Joystick) -> c_int;
        pub fn SDL_JoystickNumHats(joystick: *mut SDL_Joystick) -> c_int;
        pub fn SDL_JoystickNumButtons(joystick: *mut SDL_Joystick) -> c_int;
        pub fn SDL_JoystickUpdate();
        pub fn SDL_JoystickEventState(state: c_int) -> c_int;
        pub fn SDL_JoystickGetAxis(joystick: *mut SDL_Joystick, axis: c_int) -> int16_t;
        pub fn SDL_JoystickGetHat(joystick: *mut SDL_Joystick, hat: c_int) -> uint8_t;
        pub fn SDL_JoystickGetBall(joystick: *mut SDL_Joystick, ball: c_int, dx: *mut c_int, dy: *mut c_int)
                        -> c_int;
        pub fn SDL_JoystickGetButton(joystick: *mut SDL_Joystick, button: c_int) -> uint8_t;
        pub fn SDL_JoystickClose(joystick: *mut SDL_Joystick);
    }
}

pub fn get_num_joysticks() -> isize {
    unsafe { ll::SDL_NumJoysticks() as isize }
}

pub fn get_joystick_name(index: isize) -> Result<String, String> {
    unsafe {
        let cstr = ll::SDL_JoystickName(index as c_int);

        if cstr.is_null() {
            Err(get_error())
        } else {
            Ok(str::from_utf8(CStr::from_ptr(cstr).to_bytes()).unwrap().to_string())
        }
    }
}

pub fn is_joystick_open(index: isize) -> bool {
    unsafe { ll::SDL_JoystickOpened(index as c_int) == 1 }
}

pub fn update_joysticks() {
    unsafe { ll::SDL_JoystickUpdate(); }
}

#[derive(PartialEq)]
pub struct Joystick {
    pub raw: *mut ll::SDL_Joystick
}

fn wrap_joystick(raw: *mut ll::SDL_Joystick) -> Joystick {
    Joystick { raw: raw }
}

impl Joystick {
    pub fn open(index: isize) -> Result<Joystick, String> {
        unsafe {
            let raw = ll::SDL_JoystickOpen(index as c_int);

            if raw.is_null() { Err(get_error()) }
            else { Ok(wrap_joystick(raw)) }
        }
    }

    pub fn get_index(&self) -> isize {
        unsafe { ll::SDL_JoystickIndex(self.raw) as isize }
    }

    pub fn get_num_axes(&self) -> isize {
        unsafe { ll::SDL_JoystickNumAxes(self.raw) as isize }
    }

    pub fn get_num_balls(&self) -> isize {
        unsafe { ll::SDL_JoystickNumBalls(self.raw) as isize }
    }

    pub fn get_num_hats(&self) -> isize {
        unsafe { ll::SDL_JoystickNumHats(self.raw) as isize }
    }

    pub fn get_num_buttons(&self) -> isize {
        unsafe { ll::SDL_JoystickNumButtons(self.raw) as isize }
    }

    pub fn get_axis(&self, axis: isize) -> i16 {
        unsafe { ll::SDL_JoystickGetAxis(self.raw, axis as c_int) as i16 }
    }

    pub fn get_hat(&self, hat: isize) -> u8 {
        unsafe { ll::SDL_JoystickGetAxis(self.raw, hat as c_int) as u8 }
    }

    pub fn get_button(&self, button: isize) -> u8 {
        unsafe { ll::SDL_JoystickGetButton(self.raw, button as c_int) as u8 }
    }

    pub fn get_ball(&self, ball: isize) -> (isize, isize) {
        let mut dx = 0;
        let mut dy = 0;

        unsafe { ll::SDL_JoystickGetBall(self.raw, ball as c_int,
                                         &mut dx,
                                         &mut dy); }

        (dx as isize, dy as isize)
    }
}

impl Drop for Joystick {
    fn drop(&mut self) {
        unsafe { ll::SDL_JoystickClose(self.raw); }
    }
}