Mercurial > sdl-ios-xcode

comparison src/joystick/SDL_joystick.c @ 0:74212992fb08

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial revision
author Sam Lantinga <slouken@lokigames.com>
date Thu, 26 Apr 2001 16:45:43 +0000
parents
children e8157fcb3114
comparison
equal deleted inserted replaced
-1:000000000000 0:74212992fb08
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 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 }