author | Sam Lantinga <slouken@libsdl.org> |
Tue, 21 Feb 2006 08:46:50 +0000 | |
changeset 1402 | d910939febfa |
parent 1336 | 3692456e7b0f |
child 1662 | 782fd950bd46 |
child 1895 | c121d94672cb |
child 4159 | a1b03ba2fcd0 |
permissions | -rw-r--r-- |
0 | 1 |
/* |
2 |
SDL - Simple DirectMedia Layer |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
3 |
Copyright (C) 1997-2006 Sam Lantinga |
0 | 4 |
|
1336
3692456e7b0f
Use SDL_ prefixed versions of C library functions.
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
5 |
This library is SDL_free software; you can redistribute it and/or |
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
6 |
modify it under the terms of the GNU Lesser General Public |
0 | 7 |
License as published by the Free Software Foundation; either |
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
8 |
version 2.1 of the License, or (at your option) any later version. |
0 | 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 |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
13 |
Lesser General Public License for more details. |
0 | 14 |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
15 |
You should have received a copy of the GNU Lesser General Public |
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
16 |
License along with this library; if not, write to the Free Software |
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
17 |
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
0 | 18 |
|
19 |
Sam Lantinga |
|
252
e8157fcb3114
Updated the source with the correct e-mail address
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
20 |
slouken@libsdl.org |
0 | 21 |
*/ |
1402
d910939febfa
Use consistent identifiers for the various platforms we support.
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
22 |
#include "SDL_config.h" |
0 | 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 |
Uint8 index; /* Device index */ |
|
31 |
const char *name; /* Joystick name - system dependent */ |
|
32 |
||
33 |
int naxes; /* Number of axis controls on the joystick */ |
|
34 |
Sint16 *axes; /* Current axis states */ |
|
35 |
||
36 |
int nhats; /* Number of hats on the joystick */ |
|
37 |
Uint8 *hats; /* Current hat states */ |
|
38 |
||
39 |
int nballs; /* Number of trackballs on the joystick */ |
|
40 |
struct balldelta { |
|
41 |
int dx; |
|
42 |
int dy; |
|
43 |
} *balls; /* Current ball motion deltas */ |
|
44 |
||
45 |
int nbuttons; /* Number of buttons on the joystick */ |
|
46 |
Uint8 *buttons; /* Current button states */ |
|
47 |
||
48 |
struct joystick_hwdata *hwdata; /* Driver dependent information */ |
|
49 |
||
50 |
int ref_count; /* Reference count for multiple opens */ |
|
51 |
}; |
|
52 |
||
53 |
/* Function to scan the system for joysticks. |
|
54 |
* Joystick 0 should be the system default joystick. |
|
55 |
* This function should return the number of available joysticks, or -1 |
|
56 |
* on an unrecoverable fatal error. |
|
57 |
*/ |
|
58 |
extern int SDL_SYS_JoystickInit(void); |
|
59 |
||
60 |
/* Function to get the device-dependent name of a joystick */ |
|
61 |
extern const char *SDL_SYS_JoystickName(int index); |
|
62 |
||
63 |
/* Function to open a joystick for use. |
|
64 |
The joystick to open is specified by the index field of the joystick. |
|
65 |
This should fill the nbuttons and naxes fields of the joystick structure. |
|
66 |
It returns 0, or -1 if there is an error. |
|
67 |
*/ |
|
68 |
extern int SDL_SYS_JoystickOpen(SDL_Joystick *joystick); |
|
69 |
||
70 |
/* Function to update the state of a joystick - called as a device poll. |
|
71 |
* This function shouldn't update the joystick structure directly, |
|
72 |
* but instead should call SDL_PrivateJoystick*() to deliver events |
|
73 |
* and update joystick device state. |
|
74 |
*/ |
|
75 |
extern void SDL_SYS_JoystickUpdate(SDL_Joystick *joystick); |
|
76 |
||
77 |
/* Function to close a joystick after use */ |
|
78 |
extern void SDL_SYS_JoystickClose(SDL_Joystick *joystick); |
|
79 |
||
80 |
/* Function to perform any system-specific joystick related cleanup */ |
|
81 |
extern void SDL_SYS_JoystickQuit(void); |
|
82 |