Mercurial > sdl-ios-xcode
annotate src/joystick/SDL_joystick.c @ 461:1d36f593078a
Date: Thu, 18 Jul 2002 23:51:40 +0200 (MEST)
From: Krister Walfridsson
Subject: [SDL] src/joystick/bsd/SDL_sysjoystick.c patch
The *BSD USB HID joystick code has two serious bugs:
1. If a joystick reports unhandled hid_input usage (for example HUG_RZ or
HUG_DIAL), then the last handled value will be overwritten with an
arbitrary value. (Fixed in the patch below by adding a default case.)
2. The current code does only handle logical coordinates in the range 0-255,
while a big part of available joysticks report -128 - 127. (This is solved
in the patch below by first center the range around 0, and then stretch
it to the correct range.)
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Tue, 20 Aug 2002 06:08:42 +0000 |
parents | f6ffac90895c |
children | f25e3334d583 |
rev | line source |
---|---|
0 | 1 /* |
2 SDL - Simple DirectMedia Layer | |
297
f6ffac90895c
Updated copyright information for 2002
Sam Lantinga <slouken@libsdl.org>
parents:
252
diff
changeset
|
3 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002 Sam Lantinga |
0 | 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 | |
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 */ |
22 | |
23 #ifdef SAVE_RCSID | |
24 static char rcsid = | |
25 "@(#) $Id$"; | |
26 #endif | |
27 | |
28 /* This is the joystick API for Simple DirectMedia Layer */ | |
29 | |
30 #include <stdio.h> | |
31 #include <stdlib.h> | |
32 #include <string.h> | |
33 | |
34 #include "SDL_error.h" | |
35 #include "SDL_events.h" | |
36 #ifndef DISABLE_EVENTS | |
37 #include "SDL_events_c.h" | |
38 #endif | |
39 #include "SDL_joystick_c.h" | |
40 #include "SDL_sysjoystick.h" | |
41 | |
42 /* This is used for Quake III Arena */ | |
43 #ifdef DISABLE_EVENTS | |
44 #define SDL_Lock_EventThread() | |
45 #define SDL_Unlock_EventThread() | |
46 #endif | |
47 | |
48 Uint8 SDL_numjoysticks = 0; | |
49 SDL_Joystick **SDL_joysticks = NULL; | |
50 static SDL_Joystick *default_joystick = NULL; | |
51 | |
52 int SDL_JoystickInit(void) | |
53 { | |
54 int arraylen; | |
55 int status; | |
56 | |
57 SDL_numjoysticks = 0; | |
58 status = SDL_SYS_JoystickInit(); | |
59 if ( status >= 0 ) { | |
60 arraylen = (status+1)*sizeof(*SDL_joysticks); | |
61 SDL_joysticks = (SDL_Joystick **)malloc(arraylen); | |
62 if ( SDL_joysticks == NULL ) { | |
63 SDL_numjoysticks = 0; | |
64 } else { | |
65 memset(SDL_joysticks, 0, arraylen); | |
66 } | |
67 SDL_numjoysticks = status; | |
68 status = 0; | |
69 } | |
70 default_joystick = NULL; | |
71 return(status); | |
72 } | |
73 | |
74 /* | |
75 * Count the number of joysticks attached to the system | |
76 */ | |
77 int SDL_NumJoysticks(void) | |
78 { | |
79 return SDL_numjoysticks; | |
80 } | |
81 | |
82 /* | |
83 * Get the implementation dependent name of a joystick | |
84 */ | |
85 const char *SDL_JoystickName(int device_index) | |
86 { | |
87 if ( (device_index < 0) || (device_index >= SDL_numjoysticks) ) { | |
88 SDL_SetError("There are %d joysticks available", | |
89 SDL_numjoysticks); | |
90 return(NULL); | |
91 } | |
92 return(SDL_SYS_JoystickName(device_index)); | |
93 } | |
94 | |
95 /* | |
96 * Open a joystick for use - the index passed as an argument refers to | |
97 * the N'th joystick on the system. This index is the value which will | |
98 * identify this joystick in future joystick events. | |
99 * | |
100 * This function returns a joystick identifier, or NULL if an error occurred. | |
101 */ | |
102 SDL_Joystick *SDL_JoystickOpen(int device_index) | |
103 { | |
104 int i; | |
105 SDL_Joystick *joystick; | |
106 | |
107 if ( (device_index < 0) || (device_index >= SDL_numjoysticks) ) { | |
108 SDL_SetError("There are %d joysticks available", | |
109 SDL_numjoysticks); | |
110 return(NULL); | |
111 } | |
112 | |
113 /* If the joystick is already open, return it */ | |
114 for ( i=0; SDL_joysticks[i]; ++i ) { | |
115 if ( device_index == SDL_joysticks[i]->index ) { | |
116 joystick = SDL_joysticks[i]; | |
117 ++joystick->ref_count; | |
118 return(joystick); | |
119 } | |
120 } | |
121 | |
122 /* Create and initialize the joystick */ | |
123 joystick = (SDL_Joystick *)malloc((sizeof *joystick)); | |
124 if ( joystick != NULL ) { | |
125 memset(joystick, 0, (sizeof *joystick)); | |
126 joystick->index = device_index; | |
127 if ( SDL_SYS_JoystickOpen(joystick) < 0 ) { | |
128 free(joystick); | |
129 joystick = NULL; | |
130 } else { | |
131 if ( joystick->naxes > 0 ) { | |
132 joystick->axes = (Sint16 *)malloc | |
133 (joystick->naxes*sizeof(Sint16)); | |
134 } | |
135 if ( joystick->nhats > 0 ) { | |
136 joystick->hats = (Uint8 *)malloc | |
137 (joystick->nhats*sizeof(Uint8)); | |
138 } | |
139 if ( joystick->nballs > 0 ) { | |
140 joystick->balls = (struct balldelta *)malloc | |
141 (joystick->nballs*sizeof(*joystick->balls)); | |
142 } | |
143 if ( joystick->nbuttons > 0 ) { | |
144 joystick->buttons = (Uint8 *)malloc | |
145 (joystick->nbuttons*sizeof(Uint8)); | |
146 } | |
147 if ( ((joystick->naxes > 0) && !joystick->axes) | |
148 || ((joystick->nhats > 0) && !joystick->hats) | |
149 || ((joystick->nballs > 0) && !joystick->balls) | |
150 || ((joystick->nbuttons > 0) && !joystick->buttons)) { | |
151 SDL_OutOfMemory(); | |
152 SDL_JoystickClose(joystick); | |
153 joystick = NULL; | |
154 } | |
155 if ( joystick->axes ) { | |
156 memset(joystick->axes, 0, | |
157 joystick->naxes*sizeof(Sint16)); | |
158 } | |
159 if ( joystick->hats ) { | |
160 memset(joystick->hats, 0, | |
161 joystick->nhats*sizeof(Uint8)); | |
162 } | |
163 if ( joystick->balls ) { | |
164 memset(joystick->balls, 0, | |
165 joystick->nballs*sizeof(*joystick->balls)); | |
166 } | |
167 if ( joystick->buttons ) { | |
168 memset(joystick->buttons, 0, | |
169 joystick->nbuttons*sizeof(Uint8)); | |
170 } | |
171 } | |
172 } | |
173 if ( joystick ) { | |
174 /* Add joystick to list */ | |
175 ++joystick->ref_count; | |
176 SDL_Lock_EventThread(); | |
177 for ( i=0; SDL_joysticks[i]; ++i ) | |
178 /* Skip to next joystick */; | |
179 SDL_joysticks[i] = joystick; | |
180 SDL_Unlock_EventThread(); | |
181 } | |
182 return(joystick); | |
183 } | |
184 | |
185 /* | |
186 * Returns 1 if the joystick has been opened, or 0 if it has not. | |
187 */ | |
188 int SDL_JoystickOpened(int device_index) | |
189 { | |
190 int i, opened; | |
191 | |
192 opened = 0; | |
193 for ( i=0; SDL_joysticks[i]; ++i ) { | |
194 if ( SDL_joysticks[i]->index == (Uint8)device_index ) { | |
195 opened = 1; | |
196 break; | |
197 } | |
198 } | |
199 return(opened); | |
200 } | |
201 | |
202 static int ValidJoystick(SDL_Joystick **joystick) | |
203 { | |
204 int valid; | |
205 | |
206 if ( *joystick == NULL ) { | |
207 *joystick = default_joystick; | |
208 } | |
209 if ( *joystick == NULL ) { | |
210 SDL_SetError("Joystick hasn't been opened yet"); | |
211 valid = 0; | |
212 } else { | |
213 valid = 1; | |
214 } | |
215 return valid; | |
216 } | |
217 | |
218 /* | |
219 * Get the device index of an opened joystick. | |
220 */ | |
221 int SDL_JoystickIndex(SDL_Joystick *joystick) | |
222 { | |
223 if ( ! ValidJoystick(&joystick) ) { | |
224 return(-1); | |
225 } | |
226 return(joystick->index); | |
227 } | |
228 | |
229 /* | |
230 * Get the number of multi-dimensional axis controls on a joystick | |
231 */ | |
232 int SDL_JoystickNumAxes(SDL_Joystick *joystick) | |
233 { | |
234 if ( ! ValidJoystick(&joystick) ) { | |
235 return(-1); | |
236 } | |
237 return(joystick->naxes); | |
238 } | |
239 | |
240 /* | |
241 * Get the number of hats on a joystick | |
242 */ | |
243 int SDL_JoystickNumHats(SDL_Joystick *joystick) | |
244 { | |
245 if ( ! ValidJoystick(&joystick) ) { | |
246 return(-1); | |
247 } | |
248 return(joystick->nhats); | |
249 } | |
250 | |
251 /* | |
252 * Get the number of trackballs on a joystick | |
253 */ | |
254 int SDL_JoystickNumBalls(SDL_Joystick *joystick) | |
255 { | |
256 if ( ! ValidJoystick(&joystick) ) { | |
257 return(-1); | |
258 } | |
259 return(joystick->nballs); | |
260 } | |
261 | |
262 /* | |
263 * Get the number of buttons on a joystick | |
264 */ | |
265 int SDL_JoystickNumButtons(SDL_Joystick *joystick) | |
266 { | |
267 if ( ! ValidJoystick(&joystick) ) { | |
268 return(-1); | |
269 } | |
270 return(joystick->nbuttons); | |
271 } | |
272 | |
273 /* | |
274 * Get the current state of an axis control on a joystick | |
275 */ | |
276 Sint16 SDL_JoystickGetAxis(SDL_Joystick *joystick, int axis) | |
277 { | |
278 Sint16 state; | |
279 | |
280 if ( ! ValidJoystick(&joystick) ) { | |
281 return(0); | |
282 } | |
283 if ( axis < joystick->naxes ) { | |
284 state = joystick->axes[axis]; | |
285 } else { | |
286 SDL_SetError("Joystick only has %d axes", joystick->naxes); | |
287 state = 0; | |
288 } | |
289 return(state); | |
290 } | |
291 | |
292 /* | |
293 * Get the current state of a hat on a joystick | |
294 */ | |
295 Uint8 SDL_JoystickGetHat(SDL_Joystick *joystick, int hat) | |
296 { | |
297 Uint8 state; | |
298 | |
299 if ( ! ValidJoystick(&joystick) ) { | |
300 return(0); | |
301 } | |
302 if ( hat < joystick->nhats ) { | |
303 state = joystick->hats[hat]; | |
304 } else { | |
305 SDL_SetError("Joystick only has %d hats", joystick->nhats); | |
306 state = 0; | |
307 } | |
308 return(state); | |
309 } | |
310 | |
311 /* | |
312 * Get the ball axis change since the last poll | |
313 */ | |
314 int SDL_JoystickGetBall(SDL_Joystick *joystick, int ball, int *dx, int *dy) | |
315 { | |
316 int retval; | |
317 | |
318 if ( ! ValidJoystick(&joystick) ) { | |
319 return(-1); | |
320 } | |
321 | |
322 retval = 0; | |
323 if ( ball < joystick->nballs ) { | |
324 if ( dx ) { | |
325 *dx = joystick->balls[ball].dx; | |
326 } | |
327 if ( dy ) { | |
328 *dy = joystick->balls[ball].dy; | |
329 } | |
330 joystick->balls[ball].dx = 0; | |
331 joystick->balls[ball].dy = 0; | |
332 } else { | |
333 SDL_SetError("Joystick only has %d balls", joystick->nballs); | |
334 retval = -1; | |
335 } | |
336 return(retval); | |
337 } | |
338 | |
339 /* | |
340 * Get the current state of a button on a joystick | |
341 */ | |
342 Uint8 SDL_JoystickGetButton(SDL_Joystick *joystick, int button) | |
343 { | |
344 Uint8 state; | |
345 | |
346 if ( ! ValidJoystick(&joystick) ) { | |
347 return(0); | |
348 } | |
349 if ( button < joystick->nbuttons ) { | |
350 state = joystick->buttons[button]; | |
351 } else { | |
352 SDL_SetError("Joystick only has %d buttons",joystick->nbuttons); | |
353 state = 0; | |
354 } | |
355 return(state); | |
356 } | |
357 | |
358 /* | |
359 * Close a joystick previously opened with SDL_JoystickOpen() | |
360 */ | |
361 void SDL_JoystickClose(SDL_Joystick *joystick) | |
362 { | |
363 int i; | |
364 | |
365 if ( ! ValidJoystick(&joystick) ) { | |
366 return; | |
367 } | |
368 | |
369 /* First decrement ref count */ | |
370 if ( --joystick->ref_count > 0 ) { | |
371 return; | |
372 } | |
373 | |
374 /* Lock the event queue - prevent joystick polling */ | |
375 SDL_Lock_EventThread(); | |
376 | |
377 if ( joystick == default_joystick ) { | |
378 default_joystick = NULL; | |
379 } | |
380 SDL_SYS_JoystickClose(joystick); | |
381 | |
382 /* Remove joystick from list */ | |
383 for ( i=0; SDL_joysticks[i]; ++i ) { | |
384 if ( joystick == SDL_joysticks[i] ) { | |
385 memcpy(&SDL_joysticks[i], &SDL_joysticks[i+1], | |
386 (SDL_numjoysticks-i)*sizeof(joystick)); | |
387 break; | |
388 } | |
389 } | |
390 | |
391 /* Let the event thread keep running */ | |
392 SDL_Unlock_EventThread(); | |
393 | |
394 /* Free the data associated with this joystick */ | |
395 if ( joystick->axes ) { | |
396 free(joystick->axes); | |
397 } | |
398 if ( joystick->hats ) { | |
399 free(joystick->hats); | |
400 } | |
401 if ( joystick->balls ) { | |
402 free(joystick->balls); | |
403 } | |
404 if ( joystick->buttons ) { | |
405 free(joystick->buttons); | |
406 } | |
407 free(joystick); | |
408 } | |
409 | |
410 void SDL_JoystickQuit(void) | |
411 { | |
412 /* Stop the event polling */ | |
413 SDL_Lock_EventThread(); | |
414 SDL_numjoysticks = 0; | |
415 SDL_Unlock_EventThread(); | |
416 | |
417 /* Quit the joystick setup */ | |
418 SDL_SYS_JoystickQuit(); | |
419 if ( SDL_joysticks ) { | |
420 free(SDL_joysticks); | |
421 SDL_joysticks = NULL; | |
422 } | |
423 } | |
424 | |
425 | |
426 /* These are global for SDL_sysjoystick.c and SDL_events.c */ | |
427 | |
428 int SDL_PrivateJoystickAxis(SDL_Joystick *joystick, Uint8 axis, Sint16 value) | |
429 { | |
430 int posted; | |
431 | |
432 /* Update internal joystick state */ | |
433 joystick->axes[axis] = value; | |
434 | |
435 /* Post the event, if desired */ | |
436 posted = 0; | |
437 #ifndef DISABLE_EVENTS | |
438 if ( SDL_ProcessEvents[SDL_JOYAXISMOTION] == SDL_ENABLE ) { | |
439 SDL_Event event; | |
440 event.type = SDL_JOYAXISMOTION; | |
441 event.jaxis.which = joystick->index; | |
442 event.jaxis.axis = axis; | |
443 event.jaxis.value = value; | |
444 if ( (SDL_EventOK == NULL) || (*SDL_EventOK)(&event) ) { | |
445 posted = 1; | |
446 SDL_PushEvent(&event); | |
447 } | |
448 } | |
449 #endif /* !DISABLE_EVENTS */ | |
450 return(posted); | |
451 } | |
452 | |
453 int SDL_PrivateJoystickHat(SDL_Joystick *joystick, Uint8 hat, Uint8 value) | |
454 { | |
455 int posted; | |
456 | |
457 /* Update internal joystick state */ | |
458 joystick->hats[hat] = value; | |
459 | |
460 /* Post the event, if desired */ | |
461 posted = 0; | |
462 #ifndef DISABLE_EVENTS | |
463 if ( SDL_ProcessEvents[SDL_JOYHATMOTION] == SDL_ENABLE ) { | |
464 SDL_Event event; | |
465 event.jhat.type = SDL_JOYHATMOTION; | |
466 event.jhat.which = joystick->index; | |
467 event.jhat.hat = hat; | |
468 event.jhat.value = value; | |
469 if ( (SDL_EventOK == NULL) || (*SDL_EventOK)(&event) ) { | |
470 posted = 1; | |
471 SDL_PushEvent(&event); | |
472 } | |
473 } | |
474 #endif /* !DISABLE_EVENTS */ | |
475 return(posted); | |
476 } | |
477 | |
478 int SDL_PrivateJoystickBall(SDL_Joystick *joystick, Uint8 ball, | |
479 Sint16 xrel, Sint16 yrel) | |
480 { | |
481 int posted; | |
482 | |
483 /* Update internal mouse state */ | |
484 joystick->balls[ball].dx += xrel; | |
485 joystick->balls[ball].dy += yrel; | |
486 | |
487 /* Post the event, if desired */ | |
488 posted = 0; | |
489 #ifndef DISABLE_EVENTS | |
490 if ( SDL_ProcessEvents[SDL_JOYBALLMOTION] == SDL_ENABLE ) { | |
491 SDL_Event event; | |
492 event.jball.type = SDL_JOYBALLMOTION; | |
493 event.jball.which = joystick->index; | |
494 event.jball.ball = ball; | |
495 event.jball.xrel = xrel; | |
496 event.jball.yrel = yrel; | |
497 if ( (SDL_EventOK == NULL) || (*SDL_EventOK)(&event) ) { | |
498 posted = 1; | |
499 SDL_PushEvent(&event); | |
500 } | |
501 } | |
502 #endif /* !DISABLE_EVENTS */ | |
503 return(posted); | |
504 } | |
505 | |
506 int SDL_PrivateJoystickButton(SDL_Joystick *joystick, Uint8 button, Uint8 state) | |
507 { | |
508 int posted; | |
509 #ifndef DISABLE_EVENTS | |
510 SDL_Event event; | |
511 | |
512 switch ( state ) { | |
513 case SDL_PRESSED: | |
514 event.type = SDL_JOYBUTTONDOWN; | |
515 break; | |
516 case SDL_RELEASED: | |
517 event.type = SDL_JOYBUTTONUP; | |
518 break; | |
519 default: | |
520 /* Invalid state -- bail */ | |
521 return(0); | |
522 } | |
523 #endif /* !DISABLE_EVENTS */ | |
524 | |
525 /* Update internal joystick state */ | |
526 joystick->buttons[button] = state; | |
527 | |
528 /* Post the event, if desired */ | |
529 posted = 0; | |
530 #ifndef DISABLE_EVENTS | |
531 if ( SDL_ProcessEvents[event.type] == SDL_ENABLE ) { | |
532 event.jbutton.which = joystick->index; | |
533 event.jbutton.button = button; | |
534 event.jbutton.state = state; | |
535 if ( (SDL_EventOK == NULL) || (*SDL_EventOK)(&event) ) { | |
536 posted = 1; | |
537 SDL_PushEvent(&event); | |
538 } | |
539 } | |
540 #endif /* !DISABLE_EVENTS */ | |
541 return(posted); | |
542 } | |
543 | |
544 void SDL_JoystickUpdate(void) | |
545 { | |
546 int i; | |
547 | |
548 for ( i=0; SDL_joysticks[i]; ++i ) { | |
549 SDL_SYS_JoystickUpdate(SDL_joysticks[i]); | |
550 } | |
551 } | |
552 | |
553 int SDL_JoystickEventState(int state) | |
554 { | |
555 #ifdef DISABLE_EVENTS | |
556 return SDL_IGNORE; | |
557 #else | |
558 const Uint8 event_list[] = { | |
559 SDL_JOYAXISMOTION, SDL_JOYBALLMOTION, SDL_JOYHATMOTION, | |
560 SDL_JOYBUTTONDOWN, SDL_JOYBUTTONUP, | |
561 }; | |
562 int i; | |
563 | |
564 switch (state) { | |
565 case SDL_QUERY: | |
566 state = SDL_IGNORE; | |
567 for ( i=0; i<SDL_TABLESIZE(event_list); ++i ) { | |
568 state = SDL_EventState(event_list[i],SDL_QUERY); | |
569 if ( state == SDL_ENABLE ) { | |
570 break; | |
571 } | |
572 } | |
573 break; | |
574 default: | |
575 for ( i=0; i<SDL_TABLESIZE(event_list); ++i ) { | |
576 SDL_EventState(event_list[i], state); | |
577 } | |
578 break; | |
579 } | |
580 return(state); | |
581 #endif /* DISABLE_EVENTS */ | |
582 } |