Commit | Line | Data |
---|---|---|
ef79bbde P |
1 | /* |
2 | SDL - Simple DirectMedia Layer | |
3 | Copyright (C) 1997-2010 Sam Lantinga | |
4 | ||
5 | This library is SDL_free software; you can redistribute it and/or | |
6 | modify it under the terms of the GNU Lesser General Public | |
7 | License as published by the Free Software Foundation; either | |
8 | version 2.1 of the License, or (at your option) any later version. | |
9 | ||
10 | This library is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 | Lesser General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU Lesser General Public | |
16 | License along with this library; if not, write to the Free Software | |
17 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
18 | ||
19 | Sam Lantinga | |
20 | slouken@libsdl.org | |
21 | */ | |
22 | #include "SDL_config.h" | |
23 | ||
24 | /* This is the system specific header for the SDL joystick API */ | |
25 | ||
26 | #include "SDL_joystick.h" | |
27 | ||
28 | /* The SDL joystick structure */ | |
29 | struct _SDL_Joystick | |
30 | { | |
31 | Uint8 index; /* Device index */ | |
32 | const char *name; /* Joystick name - system dependent */ | |
33 | ||
34 | int naxes; /* Number of axis controls on the joystick */ | |
35 | Sint16 *axes; /* Current axis states */ | |
36 | ||
37 | int nhats; /* Number of hats on the joystick */ | |
38 | Uint8 *hats; /* Current hat states */ | |
39 | ||
40 | int nballs; /* Number of trackballs on the joystick */ | |
41 | struct balldelta | |
42 | { | |
43 | int dx; | |
44 | int dy; | |
45 | } *balls; /* Current ball motion deltas */ | |
46 | ||
47 | int nbuttons; /* Number of buttons on the joystick */ | |
48 | Uint8 *buttons; /* Current button states */ | |
49 | ||
50 | struct joystick_hwdata *hwdata; /* Driver dependent information */ | |
51 | ||
52 | int ref_count; /* Reference count for multiple opens */ | |
53 | }; | |
54 | ||
55 | /* Function to scan the system for joysticks. | |
56 | * Joystick 0 should be the system default joystick. | |
57 | * This function should return the number of available joysticks, or -1 | |
58 | * on an unrecoverable fatal error. | |
59 | */ | |
60 | extern int SDL_SYS_JoystickInit(void); | |
61 | ||
62 | /* Function to get the device-dependent name of a joystick */ | |
63 | extern const char *SDL_SYS_JoystickName(int index); | |
64 | ||
65 | /* Function to open a joystick for use. | |
66 | The joystick to open is specified by the index field of the joystick. | |
67 | This should fill the nbuttons and naxes fields of the joystick structure. | |
68 | It returns 0, or -1 if there is an error. | |
69 | */ | |
70 | extern int SDL_SYS_JoystickOpen(SDL_Joystick * joystick); | |
71 | ||
72 | /* Function to update the state of a joystick - called as a device poll. | |
73 | * This function shouldn't update the joystick structure directly, | |
74 | * but instead should call SDL_PrivateJoystick*() to deliver events | |
75 | * and update joystick device state. | |
76 | */ | |
77 | extern void SDL_SYS_JoystickUpdate(SDL_Joystick * joystick); | |
78 | ||
79 | /* Function to close a joystick after use */ | |
80 | extern void SDL_SYS_JoystickClose(SDL_Joystick * joystick); | |
81 | ||
82 | /* Function to perform any system-specific joystick related cleanup */ | |
83 | extern void SDL_SYS_JoystickQuit(void); | |
84 | ||
85 | /* vi: set ts=4 sw=4 expandtab: */ |