SDL 2.0
SDL_joystick.c
Go to the documentation of this file.
1/*
2 Simple DirectMedia Layer
3 Copyright (C) 1997-2019 Sam Lantinga <slouken@libsdl.org>
4
5 This software is provided 'as-is', without any express or implied
6 warranty. In no event will the authors be held liable for any damages
7 arising from the use of this software.
8
9 Permission is granted to anyone to use this software for any purpose,
10 including commercial applications, and to alter it and redistribute it
11 freely, subject to the following restrictions:
12
13 1. The origin of this software must not be misrepresented; you must not
14 claim that you wrote the original software. If you use this software
15 in a product, an acknowledgment in the product documentation would be
16 appreciated but is not required.
17 2. Altered source versions must be plainly marked as such, and must not be
18 misrepresented as being the original software.
19 3. This notice may not be removed or altered from any source distribution.
20*/
21#include "../SDL_internal.h"
22
23/* This is the joystick API for Simple DirectMedia Layer */
24
25#include "SDL.h"
26#include "SDL_atomic.h"
27#include "SDL_events.h"
28#include "SDL_sysjoystick.h"
29#include "SDL_assert.h"
30#include "SDL_hints.h"
31
32#if !SDL_EVENTS_DISABLED
33#include "../events/SDL_events_c.h"
34#endif
35#include "../video/SDL_sysvideo.h"
36
37/* This is included in only one place because it has a large static list of controllers */
38#include "controller_type.h"
39
40#ifdef __WIN32__
41/* Needed for checking for input remapping programs */
42#include "../core/windows/SDL_windows.h"
43
44#undef UNICODE /* We want ASCII functions */
45#include <tlhelp32.h>
46#endif
47
49#if defined(SDL_JOYSTICK_DINPUT) || defined(SDL_JOYSTICK_XINPUT)
51#endif
52#ifdef SDL_JOYSTICK_LINUX
54#endif
55#ifdef SDL_JOYSTICK_IOKIT
57#endif
58#if defined(__IPHONEOS__) || defined(__TVOS__)
60#endif
61#ifdef SDL_JOYSTICK_ANDROID
63#endif
64#ifdef SDL_JOYSTICK_EMSCRIPTEN
66#endif
67#ifdef SDL_JOYSTICK_HAIKU
69#endif
70#ifdef SDL_JOYSTICK_USBHID /* !!! FIXME: "USBHID" is a generic name, and doubly-confusing with HIDAPI next to it. This is the *BSD interface, rename this. */
72#endif
73#ifdef SDL_JOYSTICK_HIDAPI
75#endif
76#if defined(SDL_JOYSTICK_DUMMY) || defined(SDL_JOYSTICK_DISABLED)
78#endif
79};
81static SDL_Joystick *SDL_joysticks = NULL;
83static SDL_mutex *SDL_joystick_lock = NULL; /* This needs to support recursive locks */
85
86void
88{
91 }
92}
93
94void
96{
99 }
100}
101
102
103static void SDLCALL
104SDL_JoystickAllowBackgroundEventsChanged(void *userdata, const char *name, const char *oldValue, const char *hint)
105{
106 if (hint && *hint == '1') {
108 } else {
110 }
111}
112
113int
115{
116 int i, status;
117
119
120 /* Create the joystick list lock */
121 if (!SDL_joystick_lock) {
123 }
124
125 /* See if we should allow joystick events while in the background */
128
129#if !SDL_EVENTS_DISABLED
131 return -1;
132 }
133#endif /* !SDL_EVENTS_DISABLED */
134
135 status = -1;
136 for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
137 if (SDL_joystick_drivers[i]->Init() >= 0) {
138 status = 0;
139 }
140 }
141 return status;
142}
143
144/*
145 * Count the number of joysticks attached to the system
146 */
147int
149{
150 int i, total_joysticks = 0;
152 for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
153 total_joysticks += SDL_joystick_drivers[i]->GetCount();
154 }
156 return total_joysticks;
157}
158
159/*
160 * Return the next available joystick instance ID
161 * This may be called by drivers from multiple threads, unprotected by any locks
162 */
164{
166}
167
168/*
169 * Get the driver and device index for an API device index
170 * This should be called while the joystick lock is held, to prevent another thread from updating the list
171 */
173SDL_GetDriverAndJoystickIndex(int device_index, SDL_JoystickDriver **driver, int *driver_index)
174{
175 int i, num_joysticks, total_joysticks = 0;
176
177 if (device_index >= 0) {
178 for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
179 num_joysticks = SDL_joystick_drivers[i]->GetCount();
180 if (device_index < num_joysticks) {
181 *driver = SDL_joystick_drivers[i];
182 *driver_index = device_index;
183 return SDL_TRUE;
184 }
185 device_index -= num_joysticks;
186 total_joysticks += num_joysticks;
187 }
188 }
189
190 SDL_SetError("There are %d joysticks available", total_joysticks);
191 return SDL_FALSE;
192}
193
194/*
195 * Perform any needed fixups for joystick names
196 */
197static const char *
199{
200 if (name) {
201 const char *skip_prefix = "NVIDIA Corporation ";
202
203 if (SDL_strncmp(name, skip_prefix, SDL_strlen(skip_prefix)) == 0) {
204 name += SDL_strlen(skip_prefix);
205 }
206 }
207 return name;
208}
209
210
211/*
212 * Get the implementation dependent name of a joystick
213 */
214const char *
216{
217 SDL_JoystickDriver *driver;
218 const char *name = NULL;
219
221 if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
222 name = SDL_FixupJoystickName(driver->GetDeviceName(device_index));
223 }
225
226 /* FIXME: Really we should reference count this name so it doesn't go away after unlock */
227 return name;
228}
229
230int
232{
233 SDL_JoystickDriver *driver;
234 int player_index = -1;
235
237 if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
238 player_index = driver->GetDevicePlayerIndex(device_index);
239 }
241
242 return player_index;
243}
244
245/*
246 * Return true if this joystick is known to have all axes centered at zero
247 * This isn't generally needed unless the joystick never generates an initial axis value near zero,
248 * e.g. it's emulating axes with digital buttons
249 */
250static SDL_bool
251SDL_JoystickAxesCenteredAtZero(SDL_Joystick *joystick)
252{
253 static Uint32 zero_centered_joysticks[] = {
254 MAKE_VIDPID(0x0e8f, 0x3013), /* HuiJia SNES USB adapter */
255 MAKE_VIDPID(0x05a0, 0x3232), /* 8Bitdo Zero Gamepad */
256 };
257
258 int i;
260 SDL_JoystickGetProduct(joystick));
261
262/*printf("JOYSTICK '%s' VID/PID 0x%.4x/0x%.4x AXES: %d\n", joystick->name, vendor, product, joystick->naxes);*/
263
264 if (joystick->naxes == 2) {
265 /* Assume D-pad or thumbstick style axes are centered at 0 */
266 return SDL_TRUE;
267 }
268
269 for (i = 0; i < SDL_arraysize(zero_centered_joysticks); ++i) {
270 if (id == zero_centered_joysticks[i]) {
271 return SDL_TRUE;
272 }
273 }
274 return SDL_FALSE;
275}
276
277/*
278 * Open a joystick for use - the index passed as an argument refers to
279 * the N'th joystick on the system. This index is the value which will
280 * identify this joystick in future joystick events.
281 *
282 * This function returns a joystick identifier, or NULL if an error occurred.
283 */
284SDL_Joystick *
285SDL_JoystickOpen(int device_index)
286{
287 SDL_JoystickDriver *driver;
288 SDL_JoystickID instance_id;
289 SDL_Joystick *joystick;
290 SDL_Joystick *joysticklist;
291 const char *joystickname = NULL;
292
294
295 if (!SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
297 return NULL;
298 }
299
300 joysticklist = SDL_joysticks;
301 /* If the joystick is already open, return it
302 * it is important that we have a single joystick * for each instance id
303 */
304 instance_id = driver->GetDeviceInstanceID(device_index);
305 while (joysticklist) {
306 if (instance_id == joysticklist->instance_id) {
307 joystick = joysticklist;
308 ++joystick->ref_count;
310 return joystick;
311 }
312 joysticklist = joysticklist->next;
313 }
314
315 /* Create and initialize the joystick */
316 joystick = (SDL_Joystick *) SDL_calloc(sizeof(*joystick), 1);
317 if (joystick == NULL) {
320 return NULL;
321 }
322 joystick->driver = driver;
323 joystick->instance_id = instance_id;
324 joystick->attached = SDL_TRUE;
325 joystick->player_index = -1;
326 joystick->epowerlevel = SDL_JOYSTICK_POWER_UNKNOWN;
327
328 if (driver->Open(joystick, device_index) < 0) {
329 SDL_free(joystick);
331 return NULL;
332 }
333
334 joystickname = driver->GetDeviceName(device_index);
335 if (joystickname) {
336 joystick->name = SDL_strdup(joystickname);
337 } else {
338 joystick->name = NULL;
339 }
340
341 joystick->guid = driver->GetDeviceGUID(device_index);
342
343 if (joystick->naxes > 0) {
344 joystick->axes = (SDL_JoystickAxisInfo *) SDL_calloc(joystick->naxes, sizeof(SDL_JoystickAxisInfo));
345 }
346 if (joystick->nhats > 0) {
347 joystick->hats = (Uint8 *) SDL_calloc(joystick->nhats, sizeof(Uint8));
348 }
349 if (joystick->nballs > 0) {
350 joystick->balls = (struct balldelta *) SDL_calloc(joystick->nballs, sizeof(*joystick->balls));
351 }
352 if (joystick->nbuttons > 0) {
353 joystick->buttons = (Uint8 *) SDL_calloc(joystick->nbuttons, sizeof(Uint8));
354 }
355 if (((joystick->naxes > 0) && !joystick->axes)
356 || ((joystick->nhats > 0) && !joystick->hats)
357 || ((joystick->nballs > 0) && !joystick->balls)
358 || ((joystick->nbuttons > 0) && !joystick->buttons)) {
360 SDL_JoystickClose(joystick);
362 return NULL;
363 }
364
365 /* If this joystick is known to have all zero centered axes, skip the auto-centering code */
366 if (SDL_JoystickAxesCenteredAtZero(joystick)) {
367 int i;
368
369 for (i = 0; i < joystick->naxes; ++i) {
370 joystick->axes[i].has_initial_value = SDL_TRUE;
371 }
372 }
373
374 joystick->is_game_controller = SDL_IsGameController(device_index);
375
376 /* Add joystick to list */
377 ++joystick->ref_count;
378 /* Link the joystick in the list */
379 joystick->next = SDL_joysticks;
380 SDL_joysticks = joystick;
381
383
384 driver->Update(joystick);
385
386 return joystick;
387}
388
389
390/*
391 * Checks to make sure the joystick is valid.
392 */
393int
394SDL_PrivateJoystickValid(SDL_Joystick * joystick)
395{
396 int valid;
397
398 if (joystick == NULL) {
399 SDL_SetError("Joystick hasn't been opened yet");
400 valid = 0;
401 } else {
402 valid = 1;
403 }
404
405 return valid;
406}
407
408/*
409 * Get the number of multi-dimensional axis controls on a joystick
410 */
411int
412SDL_JoystickNumAxes(SDL_Joystick * joystick)
413{
414 if (!SDL_PrivateJoystickValid(joystick)) {
415 return -1;
416 }
417 return joystick->naxes;
418}
419
420/*
421 * Get the number of hats on a joystick
422 */
423int
424SDL_JoystickNumHats(SDL_Joystick * joystick)
425{
426 if (!SDL_PrivateJoystickValid(joystick)) {
427 return -1;
428 }
429 return joystick->nhats;
430}
431
432/*
433 * Get the number of trackballs on a joystick
434 */
435int
436SDL_JoystickNumBalls(SDL_Joystick * joystick)
437{
438 if (!SDL_PrivateJoystickValid(joystick)) {
439 return -1;
440 }
441 return joystick->nballs;
442}
443
444/*
445 * Get the number of buttons on a joystick
446 */
447int
448SDL_JoystickNumButtons(SDL_Joystick * joystick)
449{
450 if (!SDL_PrivateJoystickValid(joystick)) {
451 return -1;
452 }
453 return joystick->nbuttons;
454}
455
456/*
457 * Get the current state of an axis control on a joystick
458 */
459Sint16
460SDL_JoystickGetAxis(SDL_Joystick * joystick, int axis)
461{
463
464 if (!SDL_PrivateJoystickValid(joystick)) {
465 return 0;
466 }
467 if (axis < joystick->naxes) {
468 state = joystick->axes[axis].value;
469 } else {
470 SDL_SetError("Joystick only has %d axes", joystick->naxes);
471 state = 0;
472 }
473 return state;
474}
475
476/*
477 * Get the initial state of an axis control on a joystick
478 */
480SDL_JoystickGetAxisInitialState(SDL_Joystick * joystick, int axis, Sint16 *state)
481{
482 if (!SDL_PrivateJoystickValid(joystick)) {
483 return SDL_FALSE;
484 }
485 if (axis >= joystick->naxes) {
486 SDL_SetError("Joystick only has %d axes", joystick->naxes);
487 return SDL_FALSE;
488 }
489 if (state) {
490 *state = joystick->axes[axis].initial_value;
491 }
492 return joystick->axes[axis].has_initial_value;
493}
494
495/*
496 * Get the current state of a hat on a joystick
497 */
498Uint8
499SDL_JoystickGetHat(SDL_Joystick * joystick, int hat)
500{
501 Uint8 state;
502
503 if (!SDL_PrivateJoystickValid(joystick)) {
504 return 0;
505 }
506 if (hat < joystick->nhats) {
507 state = joystick->hats[hat];
508 } else {
509 SDL_SetError("Joystick only has %d hats", joystick->nhats);
510 state = 0;
511 }
512 return state;
513}
514
515/*
516 * Get the ball axis change since the last poll
517 */
518int
519SDL_JoystickGetBall(SDL_Joystick * joystick, int ball, int *dx, int *dy)
520{
521 int retval;
522
523 if (!SDL_PrivateJoystickValid(joystick)) {
524 return -1;
525 }
526
527 retval = 0;
528 if (ball < joystick->nballs) {
529 if (dx) {
530 *dx = joystick->balls[ball].dx;
531 }
532 if (dy) {
533 *dy = joystick->balls[ball].dy;
534 }
535 joystick->balls[ball].dx = 0;
536 joystick->balls[ball].dy = 0;
537 } else {
538 return SDL_SetError("Joystick only has %d balls", joystick->nballs);
539 }
540 return retval;
541}
542
543/*
544 * Get the current state of a button on a joystick
545 */
546Uint8
547SDL_JoystickGetButton(SDL_Joystick * joystick, int button)
548{
549 Uint8 state;
550
551 if (!SDL_PrivateJoystickValid(joystick)) {
552 return 0;
553 }
554 if (button < joystick->nbuttons) {
555 state = joystick->buttons[button];
556 } else {
557 SDL_SetError("Joystick only has %d buttons", joystick->nbuttons);
558 state = 0;
559 }
560 return state;
561}
562
563/*
564 * Return if the joystick in question is currently attached to the system,
565 * \return SDL_FALSE if not plugged in, SDL_TRUE if still present.
566 */
568SDL_JoystickGetAttached(SDL_Joystick * joystick)
569{
570 if (!SDL_PrivateJoystickValid(joystick)) {
571 return SDL_FALSE;
572 }
573
574 return joystick->attached;
575}
576
577/*
578 * Get the instance id for this opened joystick
579 */
581SDL_JoystickInstanceID(SDL_Joystick * joystick)
582{
583 if (!SDL_PrivateJoystickValid(joystick)) {
584 return -1;
585 }
586
587 return joystick->instance_id;
588}
589
590/*
591 * Find the SDL_Joystick that owns this instance id
592 */
593SDL_Joystick *
595{
596 SDL_Joystick *joystick;
597
599 for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
600 if (joystick->instance_id == joyid) {
601 break;
602 }
603 }
605 return joystick;
606}
607
608/*
609 * Get the friendly name of this joystick
610 */
611const char *
612SDL_JoystickName(SDL_Joystick * joystick)
613{
614 if (!SDL_PrivateJoystickValid(joystick)) {
615 return NULL;
616 }
617
618 return SDL_FixupJoystickName(joystick->name);
619}
620
621int
622SDL_JoystickGetPlayerIndex(SDL_Joystick * joystick)
623{
624 if (!SDL_PrivateJoystickValid(joystick)) {
625 return -1;
626 }
627 return joystick->player_index;
628}
629
630int
631SDL_JoystickRumble(SDL_Joystick * joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble, Uint32 duration_ms)
632{
633 if (!SDL_PrivateJoystickValid(joystick)) {
634 return -1;
635 }
636 return joystick->driver->Rumble(joystick, low_frequency_rumble, high_frequency_rumble, duration_ms);
637}
638
639/*
640 * Close a joystick previously opened with SDL_JoystickOpen()
641 */
642void
643SDL_JoystickClose(SDL_Joystick * joystick)
644{
645 SDL_Joystick *joysticklist;
646 SDL_Joystick *joysticklistprev;
647
648 if (!SDL_PrivateJoystickValid(joystick)) {
649 return;
650 }
651
653
654 /* First decrement ref count */
655 if (--joystick->ref_count > 0) {
657 return;
658 }
659
662 return;
663 }
664
665 joystick->driver->Close(joystick);
666 joystick->hwdata = NULL;
667
668 joysticklist = SDL_joysticks;
669 joysticklistprev = NULL;
670 while (joysticklist) {
671 if (joystick == joysticklist) {
672 if (joysticklistprev) {
673 /* unlink this entry */
674 joysticklistprev->next = joysticklist->next;
675 } else {
676 SDL_joysticks = joystick->next;
677 }
678 break;
679 }
680 joysticklistprev = joysticklist;
681 joysticklist = joysticklist->next;
682 }
683
684 SDL_free(joystick->name);
685
686 /* Free the data associated with this joystick */
687 SDL_free(joystick->axes);
688 SDL_free(joystick->hats);
689 SDL_free(joystick->balls);
690 SDL_free(joystick->buttons);
691 SDL_free(joystick);
692
694}
695
696void
698{
699 int i;
700
701 /* Make sure we're not getting called in the middle of updating joysticks */
703 while (SDL_updating_joystick) {
705 SDL_Delay(1);
707 }
708
709 /* Stop the event polling */
710 while (SDL_joysticks) {
711 SDL_joysticks->ref_count = 1;
713 }
714
715 /* Quit the joystick setup */
716 for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
718 }
719
721
722#if !SDL_EVENTS_DISABLED
724#endif
725
728
729 if (SDL_joystick_lock) {
733 }
734
736}
737
738
739static SDL_bool
741{
743 return SDL_FALSE;
744 }
745
747 /* We have windows but we don't have focus, ignore the event. */
748 return SDL_TRUE;
749 }
750 return SDL_FALSE;
751}
752
753/* These are global for SDL_sysjoystick.c and SDL_events.c */
754
756{
757#if !SDL_EVENTS_DISABLED
759 int device_index;
760
761 device_index = SDL_JoystickGetDeviceIndexFromInstanceID(device_instance);
762 if (device_index < 0) {
763 return;
764 }
765
766 event.type = SDL_JOYDEVICEADDED;
767
768 if (SDL_GetEventState(event.type) == SDL_ENABLE) {
769 event.jdevice.which = device_index;
771 }
772#endif /* !SDL_EVENTS_DISABLED */
773}
774
775/*
776 * If there is an existing add event in the queue, it needs to be modified
777 * to have the right value for which, because the number of controllers in
778 * the system is now one less.
779 */
781{
782 int i, num_events;
784 SDL_bool isstack;
785
787 if (num_events <= 0) {
788 return;
789 }
790
791 events = SDL_small_alloc(SDL_Event, num_events, &isstack);
792 if (!events) {
793 return;
794 }
795
797 for (i = 0; i < num_events; ++i) {
799 }
800 SDL_PeepEvents(events, num_events, SDL_ADDEVENT, 0, 0);
801
802 SDL_small_free(events, isstack);
803}
804
806{
807 SDL_Joystick *joystick;
808
809#if !SDL_EVENTS_DISABLED
811
812 event.type = SDL_JOYDEVICEREMOVED;
813
814 if (SDL_GetEventState(event.type) == SDL_ENABLE) {
815 event.jdevice.which = device_instance;
817 }
818
820#endif /* !SDL_EVENTS_DISABLED */
821
822 /* Mark this joystick as no longer attached */
823 for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
824 if (joystick->instance_id == device_instance) {
825 joystick->attached = SDL_FALSE;
826 joystick->force_recentering = SDL_TRUE;
827 break;
828 }
829 }
830}
831
832int
834{
835 int posted;
836
837 /* Make sure we're not getting garbage or duplicate events */
838 if (axis >= joystick->naxes) {
839 return 0;
840 }
841 if (!joystick->axes[axis].has_initial_value) {
842 joystick->axes[axis].initial_value = value;
843 joystick->axes[axis].value = value;
844 joystick->axes[axis].zero = value;
845 joystick->axes[axis].has_initial_value = SDL_TRUE;
846 }
847 if (value == joystick->axes[axis].value) {
848 return 0;
849 }
850 if (!joystick->axes[axis].sent_initial_value) {
851 /* Make sure we don't send motion until there's real activity on this axis */
852 const int MAX_ALLOWED_JITTER = SDL_JOYSTICK_AXIS_MAX / 80; /* ShanWan PS3 controller needed 96 */
853 if (SDL_abs(value - joystick->axes[axis].value) <= MAX_ALLOWED_JITTER) {
854 return 0;
855 }
856 joystick->axes[axis].sent_initial_value = SDL_TRUE;
857 joystick->axes[axis].value = value; /* Just so we pass the check above */
858 SDL_PrivateJoystickAxis(joystick, axis, joystick->axes[axis].initial_value);
859 }
860
861 /* We ignore events if we don't have keyboard focus, except for centering
862 * events.
863 */
865 if ((value > joystick->axes[axis].zero && value >= joystick->axes[axis].value) ||
866 (value < joystick->axes[axis].zero && value <= joystick->axes[axis].value)) {
867 return 0;
868 }
869 }
870
871 /* Update internal joystick state */
872 joystick->axes[axis].value = value;
873
874 /* Post the event, if desired */
875 posted = 0;
876#if !SDL_EVENTS_DISABLED
879 event.type = SDL_JOYAXISMOTION;
880 event.jaxis.which = joystick->instance_id;
881 event.jaxis.axis = axis;
882 event.jaxis.value = value;
883 posted = SDL_PushEvent(&event) == 1;
884 }
885#endif /* !SDL_EVENTS_DISABLED */
886 return posted;
887}
888
889int
890SDL_PrivateJoystickHat(SDL_Joystick * joystick, Uint8 hat, Uint8 value)
891{
892 int posted;
893
894 /* Make sure we're not getting garbage or duplicate events */
895 if (hat >= joystick->nhats) {
896 return 0;
897 }
898 if (value == joystick->hats[hat]) {
899 return 0;
900 }
901
902 /* We ignore events if we don't have keyboard focus, except for centering
903 * events.
904 */
906 if (value != SDL_HAT_CENTERED) {
907 return 0;
908 }
909 }
910
911 /* Update internal joystick state */
912 joystick->hats[hat] = value;
913
914 /* Post the event, if desired */
915 posted = 0;
916#if !SDL_EVENTS_DISABLED
919 event.jhat.type = SDL_JOYHATMOTION;
920 event.jhat.which = joystick->instance_id;
921 event.jhat.hat = hat;
922 event.jhat.value = value;
923 posted = SDL_PushEvent(&event) == 1;
924 }
925#endif /* !SDL_EVENTS_DISABLED */
926 return posted;
927}
928
929int
930SDL_PrivateJoystickBall(SDL_Joystick * joystick, Uint8 ball,
931 Sint16 xrel, Sint16 yrel)
932{
933 int posted;
934
935 /* Make sure we're not getting garbage events */
936 if (ball >= joystick->nballs) {
937 return 0;
938 }
939
940 /* We ignore events if we don't have keyboard focus. */
942 return 0;
943 }
944
945 /* Update internal mouse state */
946 joystick->balls[ball].dx += xrel;
947 joystick->balls[ball].dy += yrel;
948
949 /* Post the event, if desired */
950 posted = 0;
951#if !SDL_EVENTS_DISABLED
954 event.jball.type = SDL_JOYBALLMOTION;
955 event.jball.which = joystick->instance_id;
956 event.jball.ball = ball;
957 event.jball.xrel = xrel;
958 event.jball.yrel = yrel;
959 posted = SDL_PushEvent(&event) == 1;
960 }
961#endif /* !SDL_EVENTS_DISABLED */
962 return posted;
963}
964
965int
967{
968 int posted;
969#if !SDL_EVENTS_DISABLED
971
972 switch (state) {
973 case SDL_PRESSED:
974 event.type = SDL_JOYBUTTONDOWN;
975 break;
976 case SDL_RELEASED:
977 event.type = SDL_JOYBUTTONUP;
978 break;
979 default:
980 /* Invalid state -- bail */
981 return 0;
982 }
983#endif /* !SDL_EVENTS_DISABLED */
984
985 /* Make sure we're not getting garbage or duplicate events */
986 if (button >= joystick->nbuttons) {
987 return 0;
988 }
989 if (state == joystick->buttons[button]) {
990 return 0;
991 }
992
993 /* We ignore events if we don't have keyboard focus, except for button
994 * release. */
996 if (state == SDL_PRESSED) {
997 return 0;
998 }
999 }
1000
1001 /* Update internal joystick state */
1002 joystick->buttons[button] = state;
1003
1004 /* Post the event, if desired */
1005 posted = 0;
1006#if !SDL_EVENTS_DISABLED
1007 if (SDL_GetEventState(event.type) == SDL_ENABLE) {
1008 event.jbutton.which = joystick->instance_id;
1009 event.jbutton.button = button;
1010 event.jbutton.state = state;
1011 posted = SDL_PushEvent(&event) == 1;
1012 }
1013#endif /* !SDL_EVENTS_DISABLED */
1014 return posted;
1015}
1016
1017void
1019{
1020 int i;
1021 SDL_Joystick *joystick;
1022
1024 return;
1025 }
1026
1028
1030 /* The joysticks are already being updated */
1032 return;
1033 }
1034
1036
1037 /* Make sure the list is unlocked while dispatching events to prevent application deadlocks */
1039
1040 for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
1041 if (joystick->attached) {
1042 /* This should always be true, but seeing a crash in the wild...? */
1043 if (joystick->driver) {
1044 joystick->driver->Update(joystick);
1045 }
1046
1047 if (joystick->delayed_guide_button) {
1049 }
1050 }
1051
1052 if (joystick->force_recentering) {
1053 /* Tell the app that everything is centered/unpressed... */
1054 for (i = 0; i < joystick->naxes; i++) {
1055 if (joystick->axes[i].has_initial_value) {
1056 SDL_PrivateJoystickAxis(joystick, i, joystick->axes[i].zero);
1057 }
1058 }
1059
1060 for (i = 0; i < joystick->nbuttons; i++) {
1061 SDL_PrivateJoystickButton(joystick, i, 0);
1062 }
1063
1064 for (i = 0; i < joystick->nhats; i++) {
1066 }
1067
1068 joystick->force_recentering = SDL_FALSE;
1069 }
1070 }
1071
1073
1075
1076 /* If any joysticks were closed while updating, free them here */
1077 for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
1078 if (joystick->ref_count <= 0) {
1079 SDL_JoystickClose(joystick);
1080 }
1081 }
1082
1083 /* this needs to happen AFTER walking the joystick list above, so that any
1084 dangling hardware data from removed devices can be free'd
1085 */
1086 for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
1088 }
1089
1091}
1092
1093int
1095{
1096#if SDL_EVENTS_DISABLED
1097 return SDL_DISABLE;
1098#else
1099 const Uint32 event_list[] = {
1102 };
1103 unsigned int i;
1104
1105 switch (state) {
1106 case SDL_QUERY:
1108 for (i = 0; i < SDL_arraysize(event_list); ++i) {
1109 state = SDL_EventState(event_list[i], SDL_QUERY);
1110 if (state == SDL_ENABLE) {
1111 break;
1112 }
1113 }
1114 break;
1115 default:
1116 for (i = 0; i < SDL_arraysize(event_list); ++i) {
1117 SDL_EventState(event_list[i], state);
1118 }
1119 break;
1120 }
1121 return state;
1122#endif /* SDL_EVENTS_DISABLED */
1123}
1124
1125void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
1126{
1127 Uint16 *guid16 = (Uint16 *)guid.data;
1128
1129 /* If the GUID fits the form of BUS 0000 VENDOR 0000 PRODUCT 0000, return the data */
1130 if (/* guid16[0] is device bus type */
1131 guid16[1] == 0x0000 &&
1132 /* guid16[2] is vendor ID */
1133 guid16[3] == 0x0000 &&
1134 /* guid16[4] is product ID */
1135 guid16[5] == 0x0000
1136 /* guid16[6] is product version */
1137 ) {
1138 if (vendor) {
1139 *vendor = guid16[2];
1140 }
1141 if (product) {
1142 *product = guid16[4];
1143 }
1144 if (version) {
1145 *version = guid16[6];
1146 }
1147 } else {
1148 if (vendor) {
1149 *vendor = 0;
1150 }
1151 if (product) {
1152 *product = 0;
1153 }
1154 if (version) {
1155 *version = 0;
1156 }
1157 }
1158}
1159
1162{
1163 return (GuessControllerType(vendor, product) == k_eControllerType_PS4Controller);
1164}
1165
1168{
1169 EControllerType eType = GuessControllerType(vendor, product);
1170 return (eType == k_eControllerType_SwitchProController ||
1172}
1173
1176{
1177 EControllerType eType = GuessControllerType(vendor, product);
1178 return (eType == k_eControllerType_SteamController ||
1180}
1181
1184{
1185 /* Filter out some bogus values here */
1186 if (vendor == 0x0000 && product == 0x0000) {
1187 return SDL_FALSE;
1188 }
1189 if (vendor == 0x0001 && product == 0x0001) {
1190 return SDL_FALSE;
1191 }
1192 return (GuessControllerType(vendor, product) == k_eControllerType_XBox360Controller);
1193}
1194
1197{
1198 return (GuessControllerType(vendor, product) == k_eControllerType_XBoxOneController);
1199}
1200
1203{
1204 return (guid.data[14] == 'x') ? SDL_TRUE : SDL_FALSE;
1205}
1206
1209{
1210 return (guid.data[14] == 'h') ? SDL_TRUE : SDL_FALSE;
1211}
1212
1214{
1215 static Uint32 wheel_joysticks[] = {
1216 MAKE_VIDPID(0x046d, 0xc294), /* Logitech generic wheel */
1217 MAKE_VIDPID(0x046d, 0xc295), /* Logitech Momo Force */
1218 MAKE_VIDPID(0x046d, 0xc298), /* Logitech Driving Force Pro */
1219 MAKE_VIDPID(0x046d, 0xc299), /* Logitech G25 */
1220 MAKE_VIDPID(0x046d, 0xc29a), /* Logitech Driving Force GT */
1221 MAKE_VIDPID(0x046d, 0xc29b), /* Logitech G27 */
1222 MAKE_VIDPID(0x046d, 0xc261), /* Logitech G920 (initial mode) */
1223 MAKE_VIDPID(0x046d, 0xc262), /* Logitech G920 (active mode) */
1224 MAKE_VIDPID(0x044f, 0xb65d), /* Thrustmaster Wheel FFB */
1225 MAKE_VIDPID(0x044f, 0xb66d), /* Thrustmaster Wheel FFB */
1226 MAKE_VIDPID(0x044f, 0xb677), /* Thrustmaster T150 */
1227 MAKE_VIDPID(0x044f, 0xb664), /* Thrustmaster TX (initial mode) */
1228 MAKE_VIDPID(0x044f, 0xb669), /* Thrustmaster TX (active mode) */
1229 };
1230 int i;
1231
1232 for (i = 0; i < SDL_arraysize(wheel_joysticks); ++i) {
1233 if (vidpid == wheel_joysticks[i]) {
1234 return SDL_TRUE;
1235 }
1236 }
1237 return SDL_FALSE;
1238}
1239
1241{
1242 static Uint32 flightstick_joysticks[] = {
1243 MAKE_VIDPID(0x044f, 0x0402), /* HOTAS Warthog Joystick */
1244 MAKE_VIDPID(0x0738, 0x2221), /* Saitek Pro Flight X-56 Rhino Stick */
1245 };
1246 int i;
1247
1248 for (i = 0; i < SDL_arraysize(flightstick_joysticks); ++i) {
1249 if (vidpid == flightstick_joysticks[i]) {
1250 return SDL_TRUE;
1251 }
1252 }
1253 return SDL_FALSE;
1254}
1255
1257{
1258 static Uint32 throttle_joysticks[] = {
1259 MAKE_VIDPID(0x044f, 0x0404), /* HOTAS Warthog Throttle */
1260 MAKE_VIDPID(0x0738, 0xa221), /* Saitek Pro Flight X-56 Rhino Throttle */
1261 };
1262 int i;
1263
1264 for (i = 0; i < SDL_arraysize(throttle_joysticks); ++i) {
1265 if (vidpid == throttle_joysticks[i]) {
1266 return SDL_TRUE;
1267 }
1268 }
1269 return SDL_FALSE;
1270}
1271
1273{
1274 Uint16 vendor;
1275 Uint16 product;
1276 Uint32 vidpid;
1277
1278 if (SDL_IsJoystickXInput(guid)) {
1279 /* XInput GUID, get the type based on the XInput device subtype */
1280 switch (guid.data[15]) {
1281 case 0x01: /* XINPUT_DEVSUBTYPE_GAMEPAD */
1283 case 0x02: /* XINPUT_DEVSUBTYPE_WHEEL */
1285 case 0x03: /* XINPUT_DEVSUBTYPE_ARCADE_STICK */
1287 case 0x04: /* XINPUT_DEVSUBTYPE_FLIGHT_STICK */
1289 case 0x05: /* XINPUT_DEVSUBTYPE_DANCE_PAD */
1291 case 0x06: /* XINPUT_DEVSUBTYPE_GUITAR */
1292 case 0x07: /* XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE */
1293 case 0x0B: /* XINPUT_DEVSUBTYPE_GUITAR_BASS */
1295 case 0x08: /* XINPUT_DEVSUBTYPE_DRUM_KIT */
1297 case 0x13: /* XINPUT_DEVSUBTYPE_ARCADE_PAD */
1299 default:
1301 }
1302 }
1303
1304 SDL_GetJoystickGUIDInfo(guid, &vendor, &product, NULL);
1305 vidpid = MAKE_VIDPID(vendor, product);
1306
1307 if (SDL_IsJoystickProductWheel(vidpid)) {
1309 }
1310
1313 }
1314
1315 if (SDL_IsJoystickProductThrottle(vidpid)) {
1317 }
1318
1321 }
1322
1324}
1325
1327{
1328#ifdef __WIN32__
1329 const char *mapper_processes[] = {
1330 "DS4Windows.exe",
1331 "InputMapper.exe",
1332 };
1333 int i;
1334 PROCESSENTRY32 pe32;
1335 SDL_bool found = SDL_FALSE;
1336
1337 /* Take a snapshot of all processes in the system */
1338 HANDLE hProcessSnap = CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0);
1339 if (hProcessSnap != INVALID_HANDLE_VALUE) {
1340 pe32.dwSize = sizeof(PROCESSENTRY32);
1341 if (Process32First(hProcessSnap, &pe32)) {
1342 do
1343 {
1344 for (i = 0; i < SDL_arraysize(mapper_processes); ++i) {
1345 if (SDL_strcasecmp(pe32.szExeFile, mapper_processes[i]) == 0) {
1346 found = SDL_TRUE;
1347 }
1348 }
1349 } while (Process32Next(hProcessSnap, &pe32) && !found);
1350 }
1351 CloseHandle(hProcessSnap);
1352 }
1353 return found;
1354#else
1355 return SDL_FALSE;
1356#endif
1357}
1358
1360{
1361 /* This list is taken from:
1362 https://raw.githubusercontent.com/denilsonsa/udev-joystick-blacklist/master/generate_rules.py
1363 */
1364 static Uint32 joystick_blacklist[] = {
1365 /* Microsoft Microsoft Wireless Optical Desktop® 2.10 */
1366 /* Microsoft Wireless Desktop - Comfort Edition */
1367 MAKE_VIDPID(0x045e, 0x009d),
1368
1369 /* Microsoft Microsoft® Digital Media Pro Keyboard */
1370 /* Microsoft Corp. Digital Media Pro Keyboard */
1371 MAKE_VIDPID(0x045e, 0x00b0),
1372
1373 /* Microsoft Microsoft® Digital Media Keyboard */
1374 /* Microsoft Corp. Digital Media Keyboard 1.0A */
1375 MAKE_VIDPID(0x045e, 0x00b4),
1376
1377 /* Microsoft Microsoft® Digital Media Keyboard 3000 */
1378 MAKE_VIDPID(0x045e, 0x0730),
1379
1380 /* Microsoft Microsoft® 2.4GHz Transceiver v6.0 */
1381 /* Microsoft Microsoft® 2.4GHz Transceiver v8.0 */
1382 /* Microsoft Corp. Nano Transceiver v1.0 for Bluetooth */
1383 /* Microsoft Wireless Mobile Mouse 1000 */
1384 /* Microsoft Wireless Desktop 3000 */
1385 MAKE_VIDPID(0x045e, 0x0745),
1386
1387 /* Microsoft® SideWinder(TM) 2.4GHz Transceiver */
1388 MAKE_VIDPID(0x045e, 0x0748),
1389
1390 /* Microsoft Corp. Wired Keyboard 600 */
1391 MAKE_VIDPID(0x045e, 0x0750),
1392
1393 /* Microsoft Corp. Sidewinder X4 keyboard */
1394 MAKE_VIDPID(0x045e, 0x0768),
1395
1396 /* Microsoft Corp. Arc Touch Mouse Transceiver */
1397 MAKE_VIDPID(0x045e, 0x0773),
1398
1399 /* Microsoft® 2.4GHz Transceiver v9.0 */
1400 /* Microsoft® Nano Transceiver v2.1 */
1401 /* Microsoft Sculpt Ergonomic Keyboard (5KV-00001) */
1402 MAKE_VIDPID(0x045e, 0x07a5),
1403
1404 /* Microsoft® Nano Transceiver v1.0 */
1405 /* Microsoft Wireless Keyboard 800 */
1406 MAKE_VIDPID(0x045e, 0x07b2),
1407
1408 /* Microsoft® Nano Transceiver v2.0 */
1409 MAKE_VIDPID(0x045e, 0x0800),
1410
1411 MAKE_VIDPID(0x046d, 0xc30a), /* Logitech, Inc. iTouch Composite keboard */
1412
1413 MAKE_VIDPID(0x04d9, 0xa0df), /* Tek Syndicate Mouse (E-Signal USB Gaming Mouse) */
1414
1415 /* List of Wacom devices at: http://linuxwacom.sourceforge.net/wiki/index.php/Device_IDs */
1416 MAKE_VIDPID(0x056a, 0x0010), /* Wacom ET-0405 Graphire */
1417 MAKE_VIDPID(0x056a, 0x0011), /* Wacom ET-0405A Graphire2 (4x5) */
1418 MAKE_VIDPID(0x056a, 0x0012), /* Wacom ET-0507A Graphire2 (5x7) */
1419 MAKE_VIDPID(0x056a, 0x0013), /* Wacom CTE-430 Graphire3 (4x5) */
1420 MAKE_VIDPID(0x056a, 0x0014), /* Wacom CTE-630 Graphire3 (6x8) */
1421 MAKE_VIDPID(0x056a, 0x0015), /* Wacom CTE-440 Graphire4 (4x5) */
1422 MAKE_VIDPID(0x056a, 0x0016), /* Wacom CTE-640 Graphire4 (6x8) */
1423 MAKE_VIDPID(0x056a, 0x0017), /* Wacom CTE-450 Bamboo Fun (4x5) */
1424 MAKE_VIDPID(0x056a, 0x0018), /* Wacom CTE-650 Bamboo Fun 6x8 */
1425 MAKE_VIDPID(0x056a, 0x0019), /* Wacom CTE-631 Bamboo One */
1426 MAKE_VIDPID(0x056a, 0x00d1), /* Wacom Bamboo Pen and Touch CTH-460 */
1427 MAKE_VIDPID(0x056a, 0x030e), /* Wacom Intuos Pen (S) CTL-480 */
1428
1429 MAKE_VIDPID(0x09da, 0x054f), /* A4 Tech Co., G7 750 mouse */
1430 MAKE_VIDPID(0x09da, 0x1410), /* A4 Tech Co., Ltd Bloody AL9 mouse */
1431 MAKE_VIDPID(0x09da, 0x3043), /* A4 Tech Co., Ltd Bloody R8A Gaming Mouse */
1432 MAKE_VIDPID(0x09da, 0x31b5), /* A4 Tech Co., Ltd Bloody TL80 Terminator Laser Gaming Mouse */
1433 MAKE_VIDPID(0x09da, 0x3997), /* A4 Tech Co., Ltd Bloody RT7 Terminator Wireless */
1434 MAKE_VIDPID(0x09da, 0x3f8b), /* A4 Tech Co., Ltd Bloody V8 mouse */
1435 MAKE_VIDPID(0x09da, 0x51f4), /* Modecom MC-5006 Keyboard */
1436 MAKE_VIDPID(0x09da, 0x5589), /* A4 Tech Co., Ltd Terminator TL9 Laser Gaming Mouse */
1437 MAKE_VIDPID(0x09da, 0x7b22), /* A4 Tech Co., Ltd Bloody V5 */
1438 MAKE_VIDPID(0x09da, 0x7f2d), /* A4 Tech Co., Ltd Bloody R3 mouse */
1439 MAKE_VIDPID(0x09da, 0x8090), /* A4 Tech Co., Ltd X-718BK Oscar Optical Gaming Mouse */
1440 MAKE_VIDPID(0x09da, 0x9033), /* A4 Tech Co., X7 X-705K */
1441 MAKE_VIDPID(0x09da, 0x9066), /* A4 Tech Co., Sharkoon Fireglider Optical */
1442 MAKE_VIDPID(0x09da, 0x9090), /* A4 Tech Co., Ltd XL-730K / XL-750BK / XL-755BK Laser Mouse */
1443 MAKE_VIDPID(0x09da, 0x90c0), /* A4 Tech Co., Ltd X7 G800V keyboard */
1444 MAKE_VIDPID(0x09da, 0xf012), /* A4 Tech Co., Ltd Bloody V7 mouse */
1445 MAKE_VIDPID(0x09da, 0xf32a), /* A4 Tech Co., Ltd Bloody B540 keyboard */
1446 MAKE_VIDPID(0x09da, 0xf613), /* A4 Tech Co., Ltd Bloody V2 mouse */
1447 MAKE_VIDPID(0x09da, 0xf624), /* A4 Tech Co., Ltd Bloody B120 Keyboard */
1448
1449 MAKE_VIDPID(0x1b1c, 0x1b3c), /* Corsair Harpoon RGB gaming mouse */
1450
1451 MAKE_VIDPID(0x1d57, 0xad03), /* [T3] 2.4GHz and IR Air Mouse Remote Control */
1452
1453 MAKE_VIDPID(0x1e7d, 0x2e4a), /* Roccat Tyon Mouse */
1454
1455 MAKE_VIDPID(0x20a0, 0x422d), /* Winkeyless.kr Keyboards */
1456
1457 MAKE_VIDPID(0x2516, 0x001f), /* Cooler Master Storm Mizar Mouse */
1458 MAKE_VIDPID(0x2516, 0x0028), /* Cooler Master Storm Alcor Mouse */
1459 };
1460
1461 unsigned int i;
1462 Uint32 id;
1463 Uint16 vendor;
1464 Uint16 product;
1465
1466 SDL_GetJoystickGUIDInfo(guid, &vendor, &product, NULL);
1467
1468 /* Check the joystick blacklist */
1469 id = MAKE_VIDPID(vendor, product);
1470 for (i = 0; i < SDL_arraysize(joystick_blacklist); ++i) {
1471 if (id == joystick_blacklist[i]) {
1472 return SDL_TRUE;
1473 }
1474 }
1475
1476 if (SDL_IsJoystickPS4(vendor, product) && SDL_IsPS4RemapperRunning()) {
1477 return SDL_TRUE;
1478 }
1479
1482 return SDL_TRUE;
1483 }
1484
1485 return SDL_FALSE;
1486}
1487
1488/* return the guid for this index */
1490{
1491 SDL_JoystickDriver *driver;
1492 SDL_JoystickGUID guid;
1493
1495 if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
1496 guid = driver->GetDeviceGUID(device_index);
1497 } else {
1498 SDL_zero(guid);
1499 }
1501
1502 return guid;
1503}
1504
1506{
1507 Uint16 vendor;
1508 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1509
1510 SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1511 return vendor;
1512}
1513
1515{
1516 Uint16 product;
1517 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1518
1519 SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1520 return product;
1521}
1522
1524{
1525 Uint16 version;
1526 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1527
1528 SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1529 return version;
1530}
1531
1533{
1535 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1536
1539 if (SDL_IsGameController(device_index)) {
1541 }
1542 }
1543 return type;
1544}
1545
1547{
1548 SDL_JoystickDriver *driver;
1549 SDL_JoystickID instance_id = -1;
1550
1552 if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
1553 instance_id = driver->GetDeviceInstanceID(device_index);
1554 }
1556
1557 return instance_id;
1558}
1559
1561{
1562 int i, num_joysticks, device_index = -1;
1563
1565 num_joysticks = SDL_NumJoysticks();
1566 for (i = 0; i < num_joysticks; ++i) {
1567 if (SDL_JoystickGetDeviceInstanceID(i) == instance_id) {
1568 device_index = i;
1569 break;
1570 }
1571 }
1573
1574 return device_index;
1575}
1576
1578{
1579 if (!SDL_PrivateJoystickValid(joystick)) {
1580 SDL_JoystickGUID emptyGUID;
1581 SDL_zero(emptyGUID);
1582 return emptyGUID;
1583 }
1584 return joystick->guid;
1585}
1586
1587Uint16 SDL_JoystickGetVendor(SDL_Joystick * joystick)
1588{
1589 Uint16 vendor;
1590 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1591
1592 SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1593 return vendor;
1594}
1595
1596Uint16 SDL_JoystickGetProduct(SDL_Joystick * joystick)
1597{
1598 Uint16 product;
1599 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1600
1601 SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1602 return product;
1603}
1604
1606{
1607 Uint16 version;
1608 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1609
1610 SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1611 return version;
1612}
1613
1615{
1617 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1618
1621 if (joystick && joystick->is_game_controller) {
1623 }
1624 }
1625 return type;
1626}
1627
1628/* convert the guid to a printable string */
1629void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID)
1630{
1631 static const char k_rgchHexToASCII[] = "0123456789abcdef";
1632 int i;
1633
1634 if ((pszGUID == NULL) || (cbGUID <= 0)) {
1635 return;
1636 }
1637
1638 for (i = 0; i < sizeof(guid.data) && i < (cbGUID-1)/2; i++) {
1639 /* each input byte writes 2 ascii chars, and might write a null byte. */
1640 /* If we don't have room for next input byte, stop */
1641 unsigned char c = guid.data[i];
1642
1643 *pszGUID++ = k_rgchHexToASCII[c >> 4];
1644 *pszGUID++ = k_rgchHexToASCII[c & 0x0F];
1645 }
1646 *pszGUID = '\0';
1647}
1648
1649/*-----------------------------------------------------------------------------
1650 * Purpose: Returns the 4 bit nibble for a hex character
1651 * Input : c -
1652 * Output : unsigned char
1653 *-----------------------------------------------------------------------------*/
1654static unsigned char nibble(char c)
1655{
1656 if ((c >= '0') && (c <= '9')) {
1657 return (unsigned char)(c - '0');
1658 }
1659
1660 if ((c >= 'A') && (c <= 'F')) {
1661 return (unsigned char)(c - 'A' + 0x0a);
1662 }
1663
1664 if ((c >= 'a') && (c <= 'f')) {
1665 return (unsigned char)(c - 'a' + 0x0a);
1666 }
1667
1668 /* received an invalid character, and no real way to return an error */
1669 /* AssertMsg1(false, "Q_nibble invalid hex character '%c' ", c); */
1670 return 0;
1671}
1672
1673/* convert the string version of a joystick guid to the struct */
1675{
1676 SDL_JoystickGUID guid;
1677 int maxoutputbytes= sizeof(guid);
1678 size_t len = SDL_strlen(pchGUID);
1679 Uint8 *p;
1680 size_t i;
1681
1682 /* Make sure it's even */
1683 len = (len) & ~0x1;
1684
1685 SDL_memset(&guid, 0x00, sizeof(guid));
1686
1687 p = (Uint8 *)&guid;
1688 for (i = 0; (i < len) && ((p - (Uint8 *)&guid) < maxoutputbytes); i+=2, p++) {
1689 *p = (nibble(pchGUID[i]) << 4) | nibble(pchGUID[i+1]);
1690 }
1691
1692 return guid;
1693}
1694
1695/* update the power level for this joystick */
1696void SDL_PrivateJoystickBatteryLevel(SDL_Joystick * joystick, SDL_JoystickPowerLevel ePowerLevel)
1697{
1698 joystick->epowerlevel = ePowerLevel;
1699}
1700
1701/* return its power level */
1703{
1704 if (!SDL_PrivateJoystickValid(joystick)) {
1706 }
1707 return joystick->epowerlevel;
1708}
1709
1710/* vi: set ts=4 sw=4 expandtab: */
#define SDL_INIT_JOYSTICK
Definition: SDL.h:80
#define SDL_INIT_EVENTS
Definition: SDL.h:83
#define SDL_AtomicIncRef(a)
Increment an atomic variable used as a reference count.
Definition: SDL_atomic.h:252
#define SDL_SetError
#define SDL_memset
#define SDL_InitSubSystem
#define SDL_abs
#define SDL_DelHintCallback
#define SDL_PushEvent
#define SDL_strncmp
#define SDL_GetKeyboardFocus
#define SDL_WasInit
#define SDL_LockMutex
#define SDL_strlen
#define SDL_strcasecmp
#define SDL_EventState
#define SDL_CreateMutex
#define SDL_free
#define SDL_strdup
#define SDL_Delay
#define SDL_PeepEvents
#define SDL_DestroyMutex
#define SDL_AddHintCallback
#define SDL_QuitSubSystem
#define SDL_calloc
#define SDL_UnlockMutex
#define SDL_IsGameController
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
@ SDL_JOYDEVICEADDED
Definition: SDL_events.h:116
@ SDL_JOYBUTTONDOWN
Definition: SDL_events.h:114
@ SDL_JOYDEVICEREMOVED
Definition: SDL_events.h:117
@ SDL_JOYBUTTONUP
Definition: SDL_events.h:115
@ SDL_JOYBALLMOTION
Definition: SDL_events.h:112
@ SDL_JOYAXISMOTION
Definition: SDL_events.h:111
@ SDL_JOYHATMOTION
Definition: SDL_events.h:113
#define SDL_QUERY
Definition: SDL_events.h:756
#define SDL_GetEventState(type)
Definition: SDL_events.h:772
#define SDL_DISABLE
Definition: SDL_events.h:758
@ SDL_ADDEVENT
Definition: SDL_events.h:615
@ SDL_PEEKEVENT
Definition: SDL_events.h:616
@ SDL_GETEVENT
Definition: SDL_events.h:617
#define SDL_RELEASED
Definition: SDL_events.h:49
#define SDL_ENABLE
Definition: SDL_events.h:759
#define SDL_PRESSED
Definition: SDL_events.h:50
void SDL_GameControllerHandleDelayedGuideButton(SDL_Joystick *joystick)
void SDL_GameControllerQuitMappings(void)
SDL_bool SDL_IsGameControllerNameAndGUID(const char *name, SDL_JoystickGUID guid)
SDL_bool SDL_ShouldIgnoreGameController(const char *name, SDL_JoystickGUID guid)
int SDL_GameControllerInitMappings(void)
#define SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
A variable that lets you enable joystick (and gamecontroller) events even when your app is in the bac...
Definition: SDL_hints.h:496
#define SDLCALL
Definition: SDL_internal.h:49
#define SDL_small_alloc(type, count, pisstack)
Definition: SDL_internal.h:39
#define SDL_small_free(ptr, isstack)
Definition: SDL_internal.h:40
SDL_bool SDL_JoystickGetAxisInitialState(SDL_Joystick *joystick, int axis, Sint16 *state)
Definition: SDL_joystick.c:480
SDL_JoystickID SDL_JoystickGetDeviceInstanceID(int device_index)
Uint16 SDL_JoystickGetProductVersion(SDL_Joystick *joystick)
int SDL_JoystickGetPlayerIndex(SDL_Joystick *joystick)
Definition: SDL_joystick.c:622
SDL_JoystickGUID SDL_JoystickGetDeviceGUID(int device_index)
Uint8 SDL_JoystickGetButton(SDL_Joystick *joystick, int button)
Definition: SDL_joystick.c:547
static SDL_JoystickDriver * SDL_joystick_drivers[]
Definition: SDL_joystick.c:48
static SDL_bool SDL_JoystickAxesCenteredAtZero(SDL_Joystick *joystick)
Definition: SDL_joystick.c:251
SDL_JoystickID SDL_JoystickInstanceID(SDL_Joystick *joystick)
Definition: SDL_joystick.c:581
int SDL_PrivateJoystickBall(SDL_Joystick *joystick, Uint8 ball, Sint16 xrel, Sint16 yrel)
Definition: SDL_joystick.c:930
int SDL_JoystickGetBall(SDL_Joystick *joystick, int ball, int *dx, int *dy)
Definition: SDL_joystick.c:519
SDL_bool SDL_IsJoystickXbox360(Uint16 vendor, Uint16 product)
SDL_JoystickPowerLevel SDL_JoystickCurrentPowerLevel(SDL_Joystick *joystick)
static SDL_bool SDL_PrivateJoystickShouldIgnoreEvent()
Definition: SDL_joystick.c:740
void SDL_PrivateJoystickBatteryLevel(SDL_Joystick *joystick, SDL_JoystickPowerLevel ePowerLevel)
const char * SDL_JoystickNameForIndex(int device_index)
Definition: SDL_joystick.c:215
static unsigned char nibble(char c)
int SDL_NumJoysticks(void)
Definition: SDL_joystick.c:148
static SDL_bool SDL_IsJoystickProductFlightStick(Uint32 vidpid)
int SDL_PrivateJoystickHat(SDL_Joystick *joystick, Uint8 hat, Uint8 value)
Definition: SDL_joystick.c:890
Uint16 SDL_JoystickGetDeviceProduct(int device_index)
Uint16 SDL_JoystickGetDeviceProductVersion(int device_index)
SDL_JoystickGUID SDL_JoystickGetGUIDFromString(const char *pchGUID)
void SDL_PrivateJoystickRemoved(SDL_JoystickID device_instance)
Definition: SDL_joystick.c:805
int SDL_JoystickInit(void)
Definition: SDL_joystick.c:114
SDL_bool SDL_GetDriverAndJoystickIndex(int device_index, SDL_JoystickDriver **driver, int *driver_index)
Definition: SDL_joystick.c:173
Uint16 SDL_JoystickGetDeviceVendor(int device_index)
SDL_Joystick * SDL_JoystickOpen(int device_index)
Definition: SDL_joystick.c:285
SDL_bool SDL_IsJoystickHIDAPI(SDL_JoystickGUID guid)
static void SDL_JoystickAllowBackgroundEventsChanged(void *userdata, const char *name, const char *oldValue, const char *hint)
Definition: SDL_joystick.c:104
int SDL_JoystickNumBalls(SDL_Joystick *joystick)
Definition: SDL_joystick.c:436
SDL_Joystick * SDL_JoystickFromInstanceID(SDL_JoystickID joyid)
Definition: SDL_joystick.c:594
int SDL_JoystickNumHats(SDL_Joystick *joystick)
Definition: SDL_joystick.c:424
int SDL_PrivateJoystickAxis(SDL_Joystick *joystick, Uint8 axis, Sint16 value)
Definition: SDL_joystick.c:833
SDL_bool SDL_ShouldIgnoreJoystick(const char *name, SDL_JoystickGUID guid)
void SDL_JoystickQuit(void)
Definition: SDL_joystick.c:697
void SDL_JoystickClose(SDL_Joystick *joystick)
Definition: SDL_joystick.c:643
SDL_JoystickGUID SDL_JoystickGetGUID(SDL_Joystick *joystick)
SDL_bool SDL_IsJoystickPS4(Uint16 vendor, Uint16 product)
int SDL_JoystickGetDevicePlayerIndex(int device_index)
Definition: SDL_joystick.c:231
SDL_bool SDL_JoystickGetAttached(SDL_Joystick *joystick)
Definition: SDL_joystick.c:568
SDL_bool SDL_IsJoystickXboxOne(Uint16 vendor, Uint16 product)
Uint16 SDL_JoystickGetProduct(SDL_Joystick *joystick)
static SDL_bool SDL_IsJoystickProductWheel(Uint32 vidpid)
void SDL_PrivateJoystickAdded(SDL_JoystickID device_instance)
Definition: SDL_joystick.c:755
SDL_bool SDL_IsJoystickNintendoSwitchPro(Uint16 vendor, Uint16 product)
void SDL_LockJoysticks(void)
Definition: SDL_joystick.c:87
static void UpdateEventsForDeviceRemoval()
Definition: SDL_joystick.c:780
void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
static SDL_bool SDL_IsJoystickProductThrottle(Uint32 vidpid)
static SDL_bool SDL_joystick_allows_background_events
Definition: SDL_joystick.c:80
static SDL_mutex * SDL_joystick_lock
Definition: SDL_joystick.c:83
Uint16 SDL_JoystickGetVendor(SDL_Joystick *joystick)
SDL_JoystickType SDL_JoystickGetType(SDL_Joystick *joystick)
SDL_bool SDL_IsJoystickSteamController(Uint16 vendor, Uint16 product)
static SDL_bool SDL_updating_joystick
Definition: SDL_joystick.c:82
int SDL_JoystickRumble(SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble, Uint32 duration_ms)
Definition: SDL_joystick.c:631
void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID)
void SDL_UnlockJoysticks(void)
Definition: SDL_joystick.c:95
static const char * SDL_FixupJoystickName(const char *name)
Definition: SDL_joystick.c:198
Uint8 SDL_JoystickGetHat(SDL_Joystick *joystick, int hat)
Definition: SDL_joystick.c:499
static SDL_bool SDL_IsPS4RemapperRunning(void)
void SDL_JoystickUpdate(void)
int SDL_JoystickEventState(int state)
static SDL_Joystick * SDL_joysticks
Definition: SDL_joystick.c:81
SDL_JoystickType SDL_JoystickGetDeviceType(int device_index)
static SDL_atomic_t SDL_next_joystick_instance_id
Definition: SDL_joystick.c:84
int SDL_JoystickNumAxes(SDL_Joystick *joystick)
Definition: SDL_joystick.c:412
const char * SDL_JoystickName(SDL_Joystick *joystick)
Definition: SDL_joystick.c:612
static SDL_JoystickType SDL_GetJoystickGUIDType(SDL_JoystickGUID guid)
SDL_JoystickID SDL_GetNextJoystickInstanceID()
Definition: SDL_joystick.c:163
Sint16 SDL_JoystickGetAxis(SDL_Joystick *joystick, int axis)
Definition: SDL_joystick.c:460
int SDL_PrivateJoystickValid(SDL_Joystick *joystick)
Definition: SDL_joystick.c:394
int SDL_JoystickGetDeviceIndexFromInstanceID(SDL_JoystickID instance_id)
SDL_bool SDL_IsJoystickXInput(SDL_JoystickGUID guid)
int SDL_PrivateJoystickButton(SDL_Joystick *joystick, Uint8 button, Uint8 state)
Definition: SDL_joystick.c:966
int SDL_JoystickNumButtons(SDL_Joystick *joystick)
Definition: SDL_joystick.c:448
SDL_JoystickType
Definition: SDL_joystick.h:84
@ SDL_JOYSTICK_TYPE_DANCE_PAD
Definition: SDL_joystick.h:90
@ SDL_JOYSTICK_TYPE_ARCADE_PAD
Definition: SDL_joystick.h:93
@ SDL_JOYSTICK_TYPE_UNKNOWN
Definition: SDL_joystick.h:85
@ SDL_JOYSTICK_TYPE_ARCADE_STICK
Definition: SDL_joystick.h:88
@ SDL_JOYSTICK_TYPE_WHEEL
Definition: SDL_joystick.h:87
@ SDL_JOYSTICK_TYPE_THROTTLE
Definition: SDL_joystick.h:94
@ SDL_JOYSTICK_TYPE_GUITAR
Definition: SDL_joystick.h:91
@ SDL_JOYSTICK_TYPE_FLIGHT_STICK
Definition: SDL_joystick.h:89
@ SDL_JOYSTICK_TYPE_GAMECONTROLLER
Definition: SDL_joystick.h:86
@ SDL_JOYSTICK_TYPE_DRUM_KIT
Definition: SDL_joystick.h:92
SDL_JoystickPowerLevel
Definition: SDL_joystick.h:98
@ SDL_JOYSTICK_POWER_UNKNOWN
Definition: SDL_joystick.h:99
Sint32 SDL_JoystickID
Definition: SDL_joystick.h:81
#define SDL_HAT_CENTERED
Definition: SDL_joystick.h:329
#define SDL_JOYSTICK_AXIS_MAX
Definition: SDL_joystick.h:301
GLuint GLuint GLsizei GLenum type
Definition: SDL_opengl.h:1571
struct _cl_event * event
GLuint id
GLenum GLsizei len
const GLubyte * c
GLuint const GLchar * name
GLfloat GLfloat p
GLsizei const GLfloat * value
#define SDL_zero(x)
Definition: SDL_stdinc.h:416
SDL_bool
Definition: SDL_stdinc.h:162
@ SDL_TRUE
Definition: SDL_stdinc.h:164
@ SDL_FALSE
Definition: SDL_stdinc.h:163
#define SDL_arraysize(array)
Definition: SDL_stdinc.h:115
uint32_t Uint32
Definition: SDL_stdinc.h:203
int16_t Sint16
Definition: SDL_stdinc.h:185
uint16_t Uint16
Definition: SDL_stdinc.h:191
uint8_t Uint8
Definition: SDL_stdinc.h:179
SDL_JoystickDriver SDL_BSD_JoystickDriver
SDL_JoystickDriver SDL_EMSCRIPTEN_JoystickDriver
SDL_JoystickDriver SDL_ANDROID_JoystickDriver
SDL_JoystickDriver SDL_DUMMY_JoystickDriver
SDL_JoystickDriver SDL_LINUX_JoystickDriver
SDL_JoystickDriver SDL_HIDAPI_JoystickDriver
SDL_JoystickDriver SDL_DARWIN_JoystickDriver
#define MAKE_VIDPID(VID, PID)
SDL_JoystickDriver SDL_WINDOWS_JoystickDriver
SDL_JoystickDriver SDL_HAIKU_JoystickDriver
SDL_JoystickDriver SDL_IOS_JoystickDriver
SDL_bool SDL_HasWindows(void)
Definition: SDL_video.c:1711
struct xkb_state * state
return Display return Display Bool Bool int int int return Display XEvent Bool(*) XPointer return Display return Display Drawable _Xconst char unsigned int unsigned int return Display Pixmap Pixmap XColor XColor unsigned int unsigned int return Display _Xconst char char int char return Display Visual unsigned int int int char unsigned int unsigned int in i)
Definition: SDL_x11sym.h:50
#define NULL
Definition: begin_code.h:167
EControllerType
@ k_eControllerType_SteamController
@ k_eControllerType_SteamControllerV2
@ k_eControllerType_SwitchProController
@ k_eControllerType_PS4Controller
@ k_eControllerType_XBox360Controller
@ k_eControllerType_XBoxOneController
@ k_eControllerType_UnknownNonSteamController
@ k_eControllerType_SwitchInputOnlyController
static EControllerType GuessControllerType(int nVID, int nPID)
SDL_JoystickGUID(* GetDeviceGUID)(int device_index)
void(* Detect)(void)
SDL_JoystickID(* GetDeviceInstanceID)(int device_index)
int(* GetCount)(void)
void(* Update)(SDL_Joystick *joystick)
void(* Quit)(void)
int(* GetDevicePlayerIndex)(int device_index)
const char *(* GetDeviceName)(int device_index)
int(* Open)(SDL_Joystick *joystick, int device_index)
Uint8 data[16]
Definition: SDL_joystick.h:71
A type representing an atomic integer value. It is a struct so people don't accidentally use numeric ...
Definition: SDL_atomic.h:216
SDL_Texture * button
SDL_Texture * axis
SDL_bool retval
static SDL_Event events[EVENT_BUF_SIZE]
Definition: testgesture.c:39
static SDL_mutex * mutex
Definition: testlock.c:23
General event structure.
Definition: SDL_events.h:558
SDL_JoyDeviceEvent jdevice
Definition: SDL_events.h:573