|
0
|
1 /*
|
|
|
2 SDL - Simple DirectMedia Layer
|
|
|
3 Copyright (C) 1997, 1998, 1999, 2000, 2001 Sam Lantinga
|
|
|
4
|
|
|
5 This library is free software; you can redistribute it and/or
|
|
|
6 modify it under the terms of the GNU Library General Public
|
|
|
7 License as published by the Free Software Foundation; either
|
|
|
8 version 2 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 Library General Public License for more details.
|
|
|
14
|
|
|
15 You should have received a copy of the GNU Library General Public
|
|
|
16 License along with this library; if not, write to the Free
|
|
|
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
18
|
|
|
19 Sam Lantinga
|
|
|
20 slouken@devolution.com
|
|
|
21 */
|
|
|
22
|
|
|
23 #ifdef SAVE_RCSID
|
|
|
24 static char rcsid =
|
|
|
25 "@(#) $Id$";
|
|
|
26 #endif
|
|
|
27
|
|
|
28 /* This is the system specific header for the SDL joystick API */
|
|
|
29
|
|
|
30 #include "SDL_joystick.h"
|
|
|
31
|
|
|
32 /* The SDL joystick structure */
|
|
|
33 struct _SDL_Joystick {
|
|
|
34 Uint8 index; /* Device index */
|
|
|
35 const char *name; /* Joystick name - system dependent */
|
|
|
36
|
|
|
37 int naxes; /* Number of axis controls on the joystick */
|
|
|
38 Sint16 *axes; /* Current axis states */
|
|
|
39
|
|
|
40 int nhats; /* Number of hats on the joystick */
|
|
|
41 Uint8 *hats; /* Current hat states */
|
|
|
42
|
|
|
43 int nballs; /* Number of trackballs on the joystick */
|
|
|
44 struct balldelta {
|
|
|
45 int dx;
|
|
|
46 int dy;
|
|
|
47 } *balls; /* Current ball motion deltas */
|
|
|
48
|
|
|
49 int nbuttons; /* Number of buttons on the joystick */
|
|
|
50 Uint8 *buttons; /* Current button states */
|
|
|
51
|
|
|
52 struct joystick_hwdata *hwdata; /* Driver dependent information */
|
|
|
53
|
|
|
54 int ref_count; /* Reference count for multiple opens */
|
|
|
55 };
|
|
|
56
|
|
|
57 /* Function to scan the system for joysticks.
|
|
|
58 * Joystick 0 should be the system default joystick.
|
|
|
59 * This function should return the number of available joysticks, or -1
|
|
|
60 * on an unrecoverable fatal error.
|
|
|
61 */
|
|
|
62 extern int SDL_SYS_JoystickInit(void);
|
|
|
63
|
|
|
64 /* Function to get the device-dependent name of a joystick */
|
|
|
65 extern const char *SDL_SYS_JoystickName(int index);
|
|
|
66
|
|
|
67 /* Function to open a joystick for use.
|
|
|
68 The joystick to open is specified by the index field of the joystick.
|
|
|
69 This should fill the nbuttons and naxes fields of the joystick structure.
|
|
|
70 It returns 0, or -1 if there is an error.
|
|
|
71 */
|
|
|
72 extern int SDL_SYS_JoystickOpen(SDL_Joystick *joystick);
|
|
|
73
|
|
|
74 /* Function to update the state of a joystick - called as a device poll.
|
|
|
75 * This function shouldn't update the joystick structure directly,
|
|
|
76 * but instead should call SDL_PrivateJoystick*() to deliver events
|
|
|
77 * and update joystick device state.
|
|
|
78 */
|
|
|
79 extern void SDL_SYS_JoystickUpdate(SDL_Joystick *joystick);
|
|
|
80
|
|
|
81 /* Function to close a joystick after use */
|
|
|
82 extern void SDL_SYS_JoystickClose(SDL_Joystick *joystick);
|
|
|
83
|
|
|
84 /* Function to perform any system-specific joystick related cleanup */
|
|
|
85 extern void SDL_SYS_JoystickQuit(void);
|
|
|
86
|
