Mercurial > sdl-ios-xcode
annotate src/joystick/SDL_sysjoystick.h @ 4073:0dd0ca51d941 SDL-1.2
Merged r3295:3296 from trunk/SDL: testjoystick reusing "joystick" variable.
| author | Ryan C. Gordon <icculus@icculus.org> |
|---|---|
| date | Sun, 15 Jul 2007 17:26:50 +0000 |
| parents | d910939febfa |
| children | 782fd950bd46 c121d94672cb a1b03ba2fcd0 |
| rev | line source |
|---|---|
| 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 |