This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_joystick.c
587 lines (522 loc) · 13.9 KB
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2010 Sam Lantinga
4
5
This library is free software; you can redistribute it and/or
6
modify it under the terms of the GNU Lesser General Public
7
License as published by the Free Software Foundation; either
8
version 2.1 of the License, or (at your option) any later version.
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Lesser General Public License for more details.
14
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
19
Sam Lantinga
20
slouken@libsdl.org
21
*/
22
#include "SDL_config.h"
23
24
25
/* This is the joystick API for Simple DirectMedia Layer */
26
#include "SDL_events.h"
27
#include "SDL_sysjoystick.h"
28
29
30
31
#include "SDL_joystick_c.h"
#if !SDL_EVENTS_DISABLED
#include "../events/SDL_events_c.h"
#endif
32
33
34
35
36
Uint8 SDL_numjoysticks = 0;
SDL_Joystick **SDL_joysticks = NULL;
static SDL_Joystick *default_joystick = NULL;
37
38
int
SDL_JoystickInit(void)
39
{
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
int arraylen;
int status;
SDL_numjoysticks = 0;
status = SDL_SYS_JoystickInit();
if (status >= 0) {
arraylen = (status + 1) * sizeof(*SDL_joysticks);
SDL_joysticks = (SDL_Joystick **) SDL_malloc(arraylen);
if (SDL_joysticks == NULL) {
SDL_numjoysticks = 0;
} else {
SDL_memset(SDL_joysticks, 0, arraylen);
SDL_numjoysticks = status;
}
status = 0;
}
default_joystick = NULL;
return (status);
58
59
60
61
62
}
/*
* Count the number of joysticks attached to the system
*/
63
64
int
SDL_NumJoysticks(void)
65
{
66
return SDL_numjoysticks;
67
68
69
70
71
}
/*
* Get the implementation dependent name of a joystick
*/
72
73
const char *
SDL_JoystickName(int device_index)
74
{
75
76
77
78
79
if ((device_index < 0) || (device_index >= SDL_numjoysticks)) {
SDL_SetError("There are %d joysticks available", SDL_numjoysticks);
return (NULL);
}
return (SDL_SYS_JoystickName(device_index));
80
81
82
83
84
85
86
87
88
}
/*
* Open a joystick for use - the index passed as an argument refers to
* the N'th joystick on the system. This index is the value which will
* identify this joystick in future joystick events.
*
* This function returns a joystick identifier, or NULL if an error occurred.
*/
89
90
SDL_Joystick *
SDL_JoystickOpen(int device_index)
91
{
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
int i;
SDL_Joystick *joystick;
if ((device_index < 0) || (device_index >= SDL_numjoysticks)) {
SDL_SetError("There are %d joysticks available", SDL_numjoysticks);
return (NULL);
}
/* If the joystick is already open, return it */
for (i = 0; SDL_joysticks[i]; ++i) {
if (device_index == SDL_joysticks[i]->index) {
joystick = SDL_joysticks[i];
++joystick->ref_count;
return (joystick);
}
}
/* Create and initialize the joystick */
joystick = (SDL_Joystick *) SDL_malloc((sizeof *joystick));
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
if (joystick == NULL) {
SDL_OutOfMemory();
return NULL;
}
SDL_memset(joystick, 0, (sizeof *joystick));
joystick->index = device_index;
if (SDL_SYS_JoystickOpen(joystick) < 0) {
SDL_free(joystick);
return NULL;
}
if (joystick->naxes > 0) {
joystick->axes = (Sint16 *) SDL_malloc
(joystick->naxes * sizeof(Sint16));
}
if (joystick->nhats > 0) {
joystick->hats = (Uint8 *) SDL_malloc
(joystick->nhats * sizeof(Uint8));
}
if (joystick->nballs > 0) {
joystick->balls = (struct balldelta *) SDL_malloc
(joystick->nballs * sizeof(*joystick->balls));
133
}
134
135
136
if (joystick->nbuttons > 0) {
joystick->buttons = (Uint8 *) SDL_malloc
(joystick->nbuttons * sizeof(Uint8));
137
}
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
if (((joystick->naxes > 0) && !joystick->axes)
|| ((joystick->nhats > 0) && !joystick->hats)
|| ((joystick->nballs > 0) && !joystick->balls)
|| ((joystick->nbuttons > 0) && !joystick->buttons)) {
SDL_OutOfMemory();
SDL_JoystickClose(joystick);
return NULL;
}
if (joystick->axes) {
SDL_memset(joystick->axes, 0, joystick->naxes * sizeof(Sint16));
}
if (joystick->hats) {
SDL_memset(joystick->hats, 0, joystick->nhats * sizeof(Uint8));
}
if (joystick->balls) {
SDL_memset(joystick->balls, 0,
joystick->nballs * sizeof(*joystick->balls));
}
if (joystick->buttons) {
SDL_memset(joystick->buttons, 0, joystick->nbuttons * sizeof(Uint8));
}
/* Add joystick to list */
++joystick->ref_count;
for (i = 0; SDL_joysticks[i]; ++i)
/* Skip to next joystick */ ;
SDL_joysticks[i] = joystick;
166
return (joystick);
167
168
169
170
171
}
/*
* Returns 1 if the joystick has been opened, or 0 if it has not.
*/
172
173
int
SDL_JoystickOpened(int device_index)
174
{
175
176
177
178
179
180
181
182
183
184
int i, opened;
opened = 0;
for (i = 0; SDL_joysticks[i]; ++i) {
if (SDL_joysticks[i]->index == (Uint8) device_index) {
opened = 1;
break;
}
}
return (opened);
185
186
}
187
188
189
190
191
192
/*
* Checks to make sure the joystick is valid.
*/
int
SDL_PrivateJoystickValid(SDL_Joystick ** joystick)
193
{
194
195
196
197
198
199
200
201
202
203
204
205
int valid;
if (*joystick == NULL) {
*joystick = default_joystick;
}
if (*joystick == NULL) {
SDL_SetError("Joystick hasn't been opened yet");
valid = 0;
} else {
valid = 1;
}
return valid;
206
207
208
209
210
}
/*
* Get the device index of an opened joystick.
*/
211
212
int
SDL_JoystickIndex(SDL_Joystick * joystick)
213
{
214
if (!SDL_PrivateJoystickValid(&joystick)) {
215
216
217
return (-1);
}
return (joystick->index);
218
219
220
221
222
}
/*
* Get the number of multi-dimensional axis controls on a joystick
*/
223
224
int
SDL_JoystickNumAxes(SDL_Joystick * joystick)
225
{
226
if (!SDL_PrivateJoystickValid(&joystick)) {
227
228
229
return (-1);
}
return (joystick->naxes);
230
231
232
233
234
}
/*
* Get the number of hats on a joystick
*/
235
236
int
SDL_JoystickNumHats(SDL_Joystick * joystick)
237
{
238
if (!SDL_PrivateJoystickValid(&joystick)) {
239
240
241
return (-1);
}
return (joystick->nhats);
242
243
244
245
246
}
/*
* Get the number of trackballs on a joystick
*/
247
248
int
SDL_JoystickNumBalls(SDL_Joystick * joystick)
249
{
250
if (!SDL_PrivateJoystickValid(&joystick)) {
251
252
253
return (-1);
}
return (joystick->nballs);
254
255
256
257
258
}
/*
* Get the number of buttons on a joystick
*/
259
260
int
SDL_JoystickNumButtons(SDL_Joystick * joystick)
261
{
262
if (!SDL_PrivateJoystickValid(&joystick)) {
263
264
265
return (-1);
}
return (joystick->nbuttons);
266
267
268
269
270
}
/*
* Get the current state of an axis control on a joystick
*/
271
272
Sint16
SDL_JoystickGetAxis(SDL_Joystick * joystick, int axis)
273
{
274
275
Sint16 state;
276
if (!SDL_PrivateJoystickValid(&joystick)) {
277
278
279
280
281
282
283
284
285
return (0);
}
if (axis < joystick->naxes) {
state = joystick->axes[axis];
} else {
SDL_SetError("Joystick only has %d axes", joystick->naxes);
state = 0;
}
return (state);
286
287
288
289
290
}
/*
* Get the current state of a hat on a joystick
*/
291
292
Uint8
SDL_JoystickGetHat(SDL_Joystick * joystick, int hat)
293
{
294
295
Uint8 state;
296
if (!SDL_PrivateJoystickValid(&joystick)) {
297
298
299
300
301
302
303
304
305
return (0);
}
if (hat < joystick->nhats) {
state = joystick->hats[hat];
} else {
SDL_SetError("Joystick only has %d hats", joystick->nhats);
state = 0;
}
return (state);
306
307
308
309
310
}
/*
* Get the ball axis change since the last poll
*/
311
312
int
SDL_JoystickGetBall(SDL_Joystick * joystick, int ball, int *dx, int *dy)
313
{
314
315
int retval;
316
if (!SDL_PrivateJoystickValid(&joystick)) {
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
return (-1);
}
retval = 0;
if (ball < joystick->nballs) {
if (dx) {
*dx = joystick->balls[ball].dx;
}
if (dy) {
*dy = joystick->balls[ball].dy;
}
joystick->balls[ball].dx = 0;
joystick->balls[ball].dy = 0;
} else {
SDL_SetError("Joystick only has %d balls", joystick->nballs);
retval = -1;
}
return (retval);
335
336
337
338
339
}
/*
* Get the current state of a button on a joystick
*/
340
341
Uint8
SDL_JoystickGetButton(SDL_Joystick * joystick, int button)
342
{
343
344
Uint8 state;
345
if (!SDL_PrivateJoystickValid(&joystick)) {
346
347
348
349
350
351
352
353
354
return (0);
}
if (button < joystick->nbuttons) {
state = joystick->buttons[button];
} else {
SDL_SetError("Joystick only has %d buttons", joystick->nbuttons);
state = 0;
}
return (state);
355
356
357
358
359
}
/*
* Close a joystick previously opened with SDL_JoystickOpen()
*/
360
361
void
SDL_JoystickClose(SDL_Joystick * joystick)
362
{
363
364
int i;
365
if (!SDL_PrivateJoystickValid(&joystick)) {
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
return;
}
/* First decrement ref count */
if (--joystick->ref_count > 0) {
return;
}
if (joystick == default_joystick) {
default_joystick = NULL;
}
SDL_SYS_JoystickClose(joystick);
/* Remove joystick from list */
for (i = 0; SDL_joysticks[i]; ++i) {
if (joystick == SDL_joysticks[i]) {
382
383
SDL_memmove(&SDL_joysticks[i], &SDL_joysticks[i + 1],
(SDL_numjoysticks - i) * sizeof(joystick));
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
break;
}
}
/* Free the data associated with this joystick */
if (joystick->axes) {
SDL_free(joystick->axes);
}
if (joystick->hats) {
SDL_free(joystick->hats);
}
if (joystick->balls) {
SDL_free(joystick->balls);
}
if (joystick->buttons) {
SDL_free(joystick->buttons);
}
SDL_free(joystick);
402
403
}
404
405
void
SDL_JoystickQuit(void)
406
{
407
408
409
410
411
412
413
414
415
/* Stop the event polling */
SDL_numjoysticks = 0;
/* Quit the joystick setup */
SDL_SYS_JoystickQuit();
if (SDL_joysticks) {
SDL_free(SDL_joysticks);
SDL_joysticks = NULL;
}
416
417
418
419
420
}
/* These are global for SDL_sysjoystick.c and SDL_events.c */
421
422
int
SDL_PrivateJoystickAxis(SDL_Joystick * joystick, Uint8 axis, Sint16 value)
423
{
424
int posted;
425
426
427
/* Update internal joystick state */
joystick->axes[axis] = value;
428
429
430
/* Post the event, if desired */
posted = 0;
431
#if !SDL_EVENTS_DISABLED
432
if (SDL_GetEventState(SDL_JOYAXISMOTION) == SDL_ENABLE) {
433
434
435
436
437
438
439
440
441
442
443
SDL_Event event;
event.type = SDL_JOYAXISMOTION;
event.jaxis.which = joystick->index;
event.jaxis.axis = axis;
event.jaxis.value = value;
if ((SDL_EventOK == NULL)
|| (*SDL_EventOK) (SDL_EventOKParam, &event)) {
posted = 1;
SDL_PushEvent(&event);
}
}
444
#endif /* !SDL_EVENTS_DISABLED */
445
return (posted);
446
447
}
448
449
int
SDL_PrivateJoystickHat(SDL_Joystick * joystick, Uint8 hat, Uint8 value)
450
{
451
int posted;
452
453
454
/* Update internal joystick state */
joystick->hats[hat] = value;
455
456
457
/* Post the event, if desired */
posted = 0;
458
#if !SDL_EVENTS_DISABLED
459
if (SDL_GetEventState(SDL_JOYHATMOTION) == SDL_ENABLE) {
460
461
462
463
464
465
466
467
468
469
470
SDL_Event event;
event.jhat.type = SDL_JOYHATMOTION;
event.jhat.which = joystick->index;
event.jhat.hat = hat;
event.jhat.value = value;
if ((SDL_EventOK == NULL)
|| (*SDL_EventOK) (SDL_EventOKParam, &event)) {
posted = 1;
SDL_PushEvent(&event);
}
}
471
#endif /* !SDL_EVENTS_DISABLED */
472
return (posted);
473
474
}
475
476
477
int
SDL_PrivateJoystickBall(SDL_Joystick * joystick, Uint8 ball,
Sint16 xrel, Sint16 yrel)
478
{
479
int posted;
480
481
482
483
/* Update internal mouse state */
joystick->balls[ball].dx += xrel;
joystick->balls[ball].dy += yrel;
484
485
486
/* Post the event, if desired */
posted = 0;
487
#if !SDL_EVENTS_DISABLED
488
if (SDL_GetEventState(SDL_JOYBALLMOTION) == SDL_ENABLE) {
489
490
491
492
493
494
495
496
497
498
499
500
SDL_Event event;
event.jball.type = SDL_JOYBALLMOTION;
event.jball.which = joystick->index;
event.jball.ball = ball;
event.jball.xrel = xrel;
event.jball.yrel = yrel;
if ((SDL_EventOK == NULL)
|| (*SDL_EventOK) (SDL_EventOKParam, &event)) {
posted = 1;
SDL_PushEvent(&event);
}
}
501
#endif /* !SDL_EVENTS_DISABLED */
502
return (posted);
503
504
}
505
506
int
SDL_PrivateJoystickButton(SDL_Joystick * joystick, Uint8 button, Uint8 state)
507
{
508
int posted;
509
#if !SDL_EVENTS_DISABLED
510
511
512
513
514
515
516
517
518
519
520
521
522
SDL_Event event;
switch (state) {
case SDL_PRESSED:
event.type = SDL_JOYBUTTONDOWN;
break;
case SDL_RELEASED:
event.type = SDL_JOYBUTTONUP;
break;
default:
/* Invalid state -- bail */
return (0);
}
523
#endif /* !SDL_EVENTS_DISABLED */
524
525
526
/* Update internal joystick state */
joystick->buttons[button] = state;
527
528
529
/* Post the event, if desired */
posted = 0;
530
#if !SDL_EVENTS_DISABLED
531
if (SDL_GetEventState(event.type) == SDL_ENABLE) {
532
533
534
535
536
537
538
539
540
event.jbutton.which = joystick->index;
event.jbutton.button = button;
event.jbutton.state = state;
if ((SDL_EventOK == NULL)
|| (*SDL_EventOK) (SDL_EventOKParam, &event)) {
posted = 1;
SDL_PushEvent(&event);
}
}
541
#endif /* !SDL_EVENTS_DISABLED */
542
return (posted);
543
544
}
545
546
void
SDL_JoystickUpdate(void)
547
{
548
int i;
549
550
551
552
for (i = 0; SDL_joysticks[i]; ++i) {
SDL_SYS_JoystickUpdate(SDL_joysticks[i]);
}
553
554
}
555
556
int
SDL_JoystickEventState(int state)
557
{
558
#if SDL_EVENTS_DISABLED
559
return SDL_IGNORE;
560
#else
561
const Uint32 event_list[] = {
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
SDL_JOYAXISMOTION, SDL_JOYBALLMOTION, SDL_JOYHATMOTION,
SDL_JOYBUTTONDOWN, SDL_JOYBUTTONUP,
};
unsigned int i;
switch (state) {
case SDL_QUERY:
state = SDL_IGNORE;
for (i = 0; i < SDL_arraysize(event_list); ++i) {
state = SDL_EventState(event_list[i], SDL_QUERY);
if (state == SDL_ENABLE) {
break;
}
}
break;
default:
for (i = 0; i < SDL_arraysize(event_list); ++i) {
SDL_EventState(event_list[i], state);
}
break;
}
return (state);
584
#endif /* SDL_EVENTS_DISABLED */
585
}
586
587
/* vi: set ts=4 sw=4 expandtab: */