SDL  2.0
SDL_joystick.c
Go to the documentation of this file.
1 /*
2  Simple DirectMedia Layer
3  Copyright (C) 1997-2018 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 };
81 static SDL_Joystick *SDL_joysticks = NULL;
83 static SDL_mutex *SDL_joystick_lock = NULL; /* This needs to support recursive locks */
85 
86 void
88 {
89  if (SDL_joystick_lock) {
90  SDL_LockMutex(SDL_joystick_lock);
91  }
92 }
93 
94 void
96 {
97  if (SDL_joystick_lock) {
98  SDL_UnlockMutex(SDL_joystick_lock);
99  }
100 }
101 
102 
103 static void SDLCALL
104 SDL_JoystickAllowBackgroundEventsChanged(void *userdata, const char *name, const char *oldValue, const char *hint)
105 {
106  if (hint && *hint == '1') {
108  } else {
110  }
111 }
112 
113 int
115 {
116  int i, status;
117 
119 
120  /* Create the joystick list lock */
121  if (!SDL_joystick_lock) {
122  SDL_joystick_lock = SDL_CreateMutex();
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  */
147 int
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 {
165  return SDL_AtomicIncRef(&SDL_next_joystick_instance_id);
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  */
172 SDL_bool
173 SDL_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  */
197 static 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  */
214 const char *
215 SDL_JoystickNameForIndex(int device_index)
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 
230 int
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  */
250 static SDL_bool
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  */
284 SDL_Joystick *
285 SDL_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) {
318  SDL_OutOfMemory();
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 
327  if (driver->Open(joystick, device_index) < 0) {
328  SDL_free(joystick);
330  return NULL;
331  }
332 
333  joystickname = driver->GetDeviceName(device_index);
334  if (joystickname) {
335  joystick->name = SDL_strdup(joystickname);
336  } else {
337  joystick->name = NULL;
338  }
339 
340  joystick->guid = driver->GetDeviceGUID(device_index);
341 
342  if (joystick->naxes > 0) {
343  joystick->axes = (SDL_JoystickAxisInfo *) SDL_calloc(joystick->naxes, sizeof(SDL_JoystickAxisInfo));
344  }
345  if (joystick->nhats > 0) {
346  joystick->hats = (Uint8 *) SDL_calloc(joystick->nhats, sizeof(Uint8));
347  }
348  if (joystick->nballs > 0) {
349  joystick->balls = (struct balldelta *) SDL_calloc(joystick->nballs, sizeof(*joystick->balls));
350  }
351  if (joystick->nbuttons > 0) {
352  joystick->buttons = (Uint8 *) SDL_calloc(joystick->nbuttons, sizeof(Uint8));
353  }
354  if (((joystick->naxes > 0) && !joystick->axes)
355  || ((joystick->nhats > 0) && !joystick->hats)
356  || ((joystick->nballs > 0) && !joystick->balls)
357  || ((joystick->nbuttons > 0) && !joystick->buttons)) {
358  SDL_OutOfMemory();
359  SDL_JoystickClose(joystick);
361  return NULL;
362  }
363  joystick->epowerlevel = SDL_JOYSTICK_POWER_UNKNOWN;
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  */
393 int
394 SDL_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  */
411 int
412 SDL_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  */
423 int
424 SDL_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  */
435 int
436 SDL_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  */
447 int
448 SDL_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  */
459 Sint16
460 SDL_JoystickGetAxis(SDL_Joystick * joystick, int axis)
461 {
462  Sint16 state;
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  */
479 SDL_bool
480 SDL_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  */
498 Uint8
499 SDL_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  */
518 int
519 SDL_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  */
546 Uint8
547 SDL_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  */
567 SDL_bool
568 SDL_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  */
581 SDL_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  */
593 SDL_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  */
611 const char *
612 SDL_JoystickName(SDL_Joystick * joystick)
613 {
614  if (!SDL_PrivateJoystickValid(joystick)) {
615  return NULL;
616  }
617 
618  return SDL_FixupJoystickName(joystick->name);
619 }
620 
621 int
622 SDL_JoystickGetPlayerIndex(SDL_Joystick * joystick)
623 {
624  if (!SDL_PrivateJoystickValid(joystick)) {
625  return -1;
626  }
627  return joystick->player_index;
628 }
629 
630 int
631 SDL_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  */
642 void
643 SDL_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 
660  if (SDL_updating_joystick) {
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 
696 void
698 {
699  int i;
700 
701  /* Make sure we're not getting called in the middle of updating joysticks */
703 
705 
706  /* Stop the event polling */
707  while (SDL_joysticks) {
708  SDL_joysticks->ref_count = 1;
710  }
711 
712  /* Quit the joystick setup */
713  for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
714  SDL_joystick_drivers[i]->Quit();
715  }
716 
718 
719 #if !SDL_EVENTS_DISABLED
721 #endif
722 
725 
726  if (SDL_joystick_lock) {
727  SDL_DestroyMutex(SDL_joystick_lock);
728  SDL_joystick_lock = NULL;
729  }
730 
732 }
733 
734 
735 static SDL_bool
737 {
739  return SDL_FALSE;
740  }
741 
742  if (SDL_HasWindows() && SDL_GetKeyboardFocus() == NULL) {
743  /* We have windows but we don't have focus, ignore the event. */
744  return SDL_TRUE;
745  }
746  return SDL_FALSE;
747 }
748 
749 /* These are global for SDL_sysjoystick.c and SDL_events.c */
750 
752 {
753 #if !SDL_EVENTS_DISABLED
755  int device_index;
756 
757  device_index = SDL_JoystickGetDeviceIndexFromInstanceID(device_instance);
758  if (device_index < 0) {
759  return;
760  }
761 
762  event.type = SDL_JOYDEVICEADDED;
763 
764  if (SDL_GetEventState(event.type) == SDL_ENABLE) {
765  event.jdevice.which = device_index;
766  SDL_PushEvent(&event);
767  }
768 #endif /* !SDL_EVENTS_DISABLED */
769 }
770 
771 /*
772  * If there is an existing add event in the queue, it needs to be modified
773  * to have the right value for which, because the number of controllers in
774  * the system is now one less.
775  */
777 {
778  int i, num_events;
779  SDL_Event *events;
780 
782  if (num_events <= 0) {
783  return;
784  }
785 
786  events = SDL_stack_alloc(SDL_Event, num_events);
787  if (!events) {
788  return;
789  }
790 
791  num_events = SDL_PeepEvents(events, num_events, SDL_GETEVENT, SDL_JOYDEVICEADDED, SDL_JOYDEVICEADDED);
792  for (i = 0; i < num_events; ++i) {
793  --events[i].jdevice.which;
794  }
795  SDL_PeepEvents(events, num_events, SDL_ADDEVENT, 0, 0);
796 
797  SDL_stack_free(events);
798 }
799 
801 {
802  SDL_Joystick *joystick;
803 
804 #if !SDL_EVENTS_DISABLED
806 
807  event.type = SDL_JOYDEVICEREMOVED;
808 
809  if (SDL_GetEventState(event.type) == SDL_ENABLE) {
810  event.jdevice.which = device_instance;
811  SDL_PushEvent(&event);
812  }
813 
815 #endif /* !SDL_EVENTS_DISABLED */
816 
817  /* Mark this joystick as no longer attached */
818  for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
819  if (joystick->instance_id == device_instance) {
820  joystick->attached = SDL_FALSE;
821  joystick->force_recentering = SDL_TRUE;
822  break;
823  }
824  }
825 }
826 
827 int
828 SDL_PrivateJoystickAxis(SDL_Joystick * joystick, Uint8 axis, Sint16 value)
829 {
830  int posted;
831 
832  /* Make sure we're not getting garbage or duplicate events */
833  if (axis >= joystick->naxes) {
834  return 0;
835  }
836  if (!joystick->axes[axis].has_initial_value) {
837  joystick->axes[axis].initial_value = value;
838  joystick->axes[axis].value = value;
839  joystick->axes[axis].zero = value;
840  joystick->axes[axis].has_initial_value = SDL_TRUE;
841  }
842  if (value == joystick->axes[axis].value) {
843  return 0;
844  }
845  if (!joystick->axes[axis].sent_initial_value) {
846  /* Make sure we don't send motion until there's real activity on this axis */
847  const int MAX_ALLOWED_JITTER = SDL_JOYSTICK_AXIS_MAX / 80; /* ShanWan PS3 controller needed 96 */
848  if (SDL_abs(value - joystick->axes[axis].value) <= MAX_ALLOWED_JITTER) {
849  return 0;
850  }
851  joystick->axes[axis].sent_initial_value = SDL_TRUE;
852  joystick->axes[axis].value = value; /* Just so we pass the check above */
853  SDL_PrivateJoystickAxis(joystick, axis, joystick->axes[axis].initial_value);
854  }
855 
856  /* We ignore events if we don't have keyboard focus, except for centering
857  * events.
858  */
860  if ((value > joystick->axes[axis].zero && value >= joystick->axes[axis].value) ||
861  (value < joystick->axes[axis].zero && value <= joystick->axes[axis].value)) {
862  return 0;
863  }
864  }
865 
866  /* Update internal joystick state */
867  joystick->axes[axis].value = value;
868 
869  /* Post the event, if desired */
870  posted = 0;
871 #if !SDL_EVENTS_DISABLED
874  event.type = SDL_JOYAXISMOTION;
875  event.jaxis.which = joystick->instance_id;
876  event.jaxis.axis = axis;
877  event.jaxis.value = value;
878  posted = SDL_PushEvent(&event) == 1;
879  }
880 #endif /* !SDL_EVENTS_DISABLED */
881  return posted;
882 }
883 
884 int
885 SDL_PrivateJoystickHat(SDL_Joystick * joystick, Uint8 hat, Uint8 value)
886 {
887  int posted;
888 
889  /* Make sure we're not getting garbage or duplicate events */
890  if (hat >= joystick->nhats) {
891  return 0;
892  }
893  if (value == joystick->hats[hat]) {
894  return 0;
895  }
896 
897  /* We ignore events if we don't have keyboard focus, except for centering
898  * events.
899  */
901  if (value != SDL_HAT_CENTERED) {
902  return 0;
903  }
904  }
905 
906  /* Update internal joystick state */
907  joystick->hats[hat] = value;
908 
909  /* Post the event, if desired */
910  posted = 0;
911 #if !SDL_EVENTS_DISABLED
914  event.jhat.type = SDL_JOYHATMOTION;
915  event.jhat.which = joystick->instance_id;
916  event.jhat.hat = hat;
917  event.jhat.value = value;
918  posted = SDL_PushEvent(&event) == 1;
919  }
920 #endif /* !SDL_EVENTS_DISABLED */
921  return posted;
922 }
923 
924 int
925 SDL_PrivateJoystickBall(SDL_Joystick * joystick, Uint8 ball,
926  Sint16 xrel, Sint16 yrel)
927 {
928  int posted;
929 
930  /* Make sure we're not getting garbage events */
931  if (ball >= joystick->nballs) {
932  return 0;
933  }
934 
935  /* We ignore events if we don't have keyboard focus. */
937  return 0;
938  }
939 
940  /* Update internal mouse state */
941  joystick->balls[ball].dx += xrel;
942  joystick->balls[ball].dy += yrel;
943 
944  /* Post the event, if desired */
945  posted = 0;
946 #if !SDL_EVENTS_DISABLED
949  event.jball.type = SDL_JOYBALLMOTION;
950  event.jball.which = joystick->instance_id;
951  event.jball.ball = ball;
952  event.jball.xrel = xrel;
953  event.jball.yrel = yrel;
954  posted = SDL_PushEvent(&event) == 1;
955  }
956 #endif /* !SDL_EVENTS_DISABLED */
957  return posted;
958 }
959 
960 int
962 {
963  int posted;
964 #if !SDL_EVENTS_DISABLED
966 
967  switch (state) {
968  case SDL_PRESSED:
969  event.type = SDL_JOYBUTTONDOWN;
970  break;
971  case SDL_RELEASED:
972  event.type = SDL_JOYBUTTONUP;
973  break;
974  default:
975  /* Invalid state -- bail */
976  return 0;
977  }
978 #endif /* !SDL_EVENTS_DISABLED */
979 
980  /* Make sure we're not getting garbage or duplicate events */
981  if (button >= joystick->nbuttons) {
982  return 0;
983  }
984  if (state == joystick->buttons[button]) {
985  return 0;
986  }
987 
988  /* We ignore events if we don't have keyboard focus, except for button
989  * release. */
991  if (state == SDL_PRESSED) {
992  return 0;
993  }
994  }
995 
996  /* Update internal joystick state */
997  joystick->buttons[button] = state;
998 
999  /* Post the event, if desired */
1000  posted = 0;
1001 #if !SDL_EVENTS_DISABLED
1002  if (SDL_GetEventState(event.type) == SDL_ENABLE) {
1003  event.jbutton.which = joystick->instance_id;
1004  event.jbutton.button = button;
1005  event.jbutton.state = state;
1006  posted = SDL_PushEvent(&event) == 1;
1007  }
1008 #endif /* !SDL_EVENTS_DISABLED */
1009  return posted;
1010 }
1011 
1012 void
1014 {
1015  int i;
1016  SDL_Joystick *joystick;
1017 
1019 
1020  if (SDL_updating_joystick) {
1021  /* The joysticks are already being updated */
1023  return;
1024  }
1025 
1027 
1028  /* Make sure the list is unlocked while dispatching events to prevent application deadlocks */
1030 
1031  for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
1032  if (joystick->attached) {
1033  joystick->driver->Update(joystick);
1034 
1035  if (joystick->delayed_guide_button) {
1037  }
1038  }
1039 
1040  if (joystick->force_recentering) {
1041  /* Tell the app that everything is centered/unpressed... */
1042  for (i = 0; i < joystick->naxes; i++) {
1043  if (joystick->axes[i].has_initial_value) {
1044  SDL_PrivateJoystickAxis(joystick, i, joystick->axes[i].zero);
1045  }
1046  }
1047 
1048  for (i = 0; i < joystick->nbuttons; i++) {
1049  SDL_PrivateJoystickButton(joystick, i, 0);
1050  }
1051 
1052  for (i = 0; i < joystick->nhats; i++) {
1054  }
1055 
1056  joystick->force_recentering = SDL_FALSE;
1057  }
1058  }
1059 
1061 
1063 
1064  /* If any joysticks were closed while updating, free them here */
1065  for (joystick = SDL_joysticks; joystick; joystick = joystick->next) {
1066  if (joystick->ref_count <= 0) {
1067  SDL_JoystickClose(joystick);
1068  }
1069  }
1070 
1071  /* this needs to happen AFTER walking the joystick list above, so that any
1072  dangling hardware data from removed devices can be free'd
1073  */
1074  for (i = 0; i < SDL_arraysize(SDL_joystick_drivers); ++i) {
1075  SDL_joystick_drivers[i]->Detect();
1076  }
1077 
1079 }
1080 
1081 int
1083 {
1084 #if SDL_EVENTS_DISABLED
1085  return SDL_DISABLE;
1086 #else
1087  const Uint32 event_list[] = {
1090  };
1091  unsigned int i;
1092 
1093  switch (state) {
1094  case SDL_QUERY:
1095  state = SDL_DISABLE;
1096  for (i = 0; i < SDL_arraysize(event_list); ++i) {
1097  state = SDL_EventState(event_list[i], SDL_QUERY);
1098  if (state == SDL_ENABLE) {
1099  break;
1100  }
1101  }
1102  break;
1103  default:
1104  for (i = 0; i < SDL_arraysize(event_list); ++i) {
1105  SDL_EventState(event_list[i], state);
1106  }
1107  break;
1108  }
1109  return state;
1110 #endif /* SDL_EVENTS_DISABLED */
1111 }
1112 
1113 void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
1114 {
1115  Uint16 *guid16 = (Uint16 *)guid.data;
1116 
1117  /* If the GUID fits the form of BUS 0000 VENDOR 0000 PRODUCT 0000, return the data */
1118  if (/* guid16[0] is device bus type */
1119  guid16[1] == 0x0000 &&
1120  /* guid16[2] is vendor ID */
1121  guid16[3] == 0x0000 &&
1122  /* guid16[4] is product ID */
1123  guid16[5] == 0x0000
1124  /* guid16[6] is product version */
1125  ) {
1126  if (vendor) {
1127  *vendor = guid16[2];
1128  }
1129  if (product) {
1130  *product = guid16[4];
1131  }
1132  if (version) {
1133  *version = guid16[6];
1134  }
1135  } else {
1136  if (vendor) {
1137  *vendor = 0;
1138  }
1139  if (product) {
1140  *product = 0;
1141  }
1142  if (version) {
1143  *version = 0;
1144  }
1145  }
1146 }
1147 
1148 SDL_bool
1150 {
1151  return (GuessControllerType(vendor, product) == k_eControllerType_PS4Controller);
1152 }
1153 
1154 SDL_bool
1156 {
1157  return (GuessControllerType(vendor, product) == k_eControllerType_SwitchProController);
1158 }
1159 
1160 SDL_bool
1162 {
1163  return BIsSteamController(GuessControllerType(vendor, product));
1164 }
1165 
1166 SDL_bool
1168 {
1169  /* Filter out some bogus values here */
1170  if (vendor == 0x0000 && product == 0x0000) {
1171  return SDL_FALSE;
1172  }
1173  if (vendor == 0x0001 && product == 0x0001) {
1174  return SDL_FALSE;
1175  }
1176  return (GuessControllerType(vendor, product) == k_eControllerType_XBox360Controller);
1177 }
1178 
1179 SDL_bool
1181 {
1182  return (GuessControllerType(vendor, product) == k_eControllerType_XBoxOneController);
1183 }
1184 
1185 SDL_bool
1187 {
1188  return (guid.data[14] == 'x') ? SDL_TRUE : SDL_FALSE;
1189 }
1190 
1191 SDL_bool
1193 {
1194  return (guid.data[14] == 'h') ? SDL_TRUE : SDL_FALSE;
1195 }
1196 
1198 {
1199  static Uint32 wheel_joysticks[] = {
1200  MAKE_VIDPID(0x046d, 0xc294), /* Logitech generic wheel */
1201  MAKE_VIDPID(0x046d, 0xc295), /* Logitech Momo Force */
1202  MAKE_VIDPID(0x046d, 0xc298), /* Logitech Driving Force Pro */
1203  MAKE_VIDPID(0x046d, 0xc299), /* Logitech G25 */
1204  MAKE_VIDPID(0x046d, 0xc29a), /* Logitech Driving Force GT */
1205  MAKE_VIDPID(0x046d, 0xc29b), /* Logitech G27 */
1206  MAKE_VIDPID(0x046d, 0xc261), /* Logitech G920 (initial mode) */
1207  MAKE_VIDPID(0x046d, 0xc262), /* Logitech G920 (active mode) */
1208  MAKE_VIDPID(0x044f, 0xb65d), /* Thrustmaster Wheel FFB */
1209  MAKE_VIDPID(0x044f, 0xb66d), /* Thrustmaster Wheel FFB */
1210  MAKE_VIDPID(0x044f, 0xb677), /* Thrustmaster T150 */
1211  MAKE_VIDPID(0x044f, 0xb664), /* Thrustmaster TX (initial mode) */
1212  MAKE_VIDPID(0x044f, 0xb669), /* Thrustmaster TX (active mode) */
1213  };
1214  int i;
1215 
1216  for (i = 0; i < SDL_arraysize(wheel_joysticks); ++i) {
1217  if (vidpid == wheel_joysticks[i]) {
1218  return SDL_TRUE;
1219  }
1220  }
1221  return SDL_FALSE;
1222 }
1223 
1225 {
1226  static Uint32 flightstick_joysticks[] = {
1227  MAKE_VIDPID(0x044f, 0x0402), /* HOTAS Warthog Joystick */
1228  MAKE_VIDPID(0x0738, 0x2221), /* Saitek Pro Flight X-56 Rhino Stick */
1229  };
1230  int i;
1231 
1232  for (i = 0; i < SDL_arraysize(flightstick_joysticks); ++i) {
1233  if (vidpid == flightstick_joysticks[i]) {
1234  return SDL_TRUE;
1235  }
1236  }
1237  return SDL_FALSE;
1238 }
1239 
1241 {
1242  static Uint32 throttle_joysticks[] = {
1243  MAKE_VIDPID(0x044f, 0x0404), /* HOTAS Warthog Throttle */
1244  MAKE_VIDPID(0x0738, 0xa221), /* Saitek Pro Flight X-56 Rhino Throttle */
1245  };
1246  int i;
1247 
1248  for (i = 0; i < SDL_arraysize(throttle_joysticks); ++i) {
1249  if (vidpid == throttle_joysticks[i]) {
1250  return SDL_TRUE;
1251  }
1252  }
1253  return SDL_FALSE;
1254 }
1255 
1257 {
1258  Uint16 vendor;
1259  Uint16 product;
1260  Uint32 vidpid;
1261 
1262  if (SDL_IsJoystickXInput(guid)) {
1263  /* XInput GUID, get the type based on the XInput device subtype */
1264  switch (guid.data[15]) {
1265  case 0x01: /* XINPUT_DEVSUBTYPE_GAMEPAD */
1267  case 0x02: /* XINPUT_DEVSUBTYPE_WHEEL */
1268  return SDL_JOYSTICK_TYPE_WHEEL;
1269  case 0x03: /* XINPUT_DEVSUBTYPE_ARCADE_STICK */
1271  case 0x04: /* XINPUT_DEVSUBTYPE_FLIGHT_STICK */
1273  case 0x05: /* XINPUT_DEVSUBTYPE_DANCE_PAD */
1275  case 0x06: /* XINPUT_DEVSUBTYPE_GUITAR */
1276  case 0x07: /* XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE */
1277  case 0x0B: /* XINPUT_DEVSUBTYPE_GUITAR_BASS */
1278  return SDL_JOYSTICK_TYPE_GUITAR;
1279  case 0x08: /* XINPUT_DEVSUBTYPE_DRUM_KIT */
1281  case 0x13: /* XINPUT_DEVSUBTYPE_ARCADE_PAD */
1283  default:
1285  }
1286  }
1287 
1288  SDL_GetJoystickGUIDInfo(guid, &vendor, &product, NULL);
1289  vidpid = MAKE_VIDPID(vendor, product);
1290 
1291  if (SDL_IsJoystickProductWheel(vidpid)) {
1292  return SDL_JOYSTICK_TYPE_WHEEL;
1293  }
1294 
1295  if (SDL_IsJoystickProductFlightStick(vidpid)) {
1297  }
1298 
1299  if (SDL_IsJoystickProductThrottle(vidpid)) {
1301  }
1302 
1305  }
1306 
1308 }
1309 
1311 {
1312 #ifdef __WIN32__
1313  const char *mapper_processes[] = {
1314  "DS4Windows.exe",
1315  "InputMapper.exe",
1316  };
1317  int i;
1318  PROCESSENTRY32 pe32;
1319  SDL_bool found = SDL_FALSE;
1320 
1321  /* Take a snapshot of all processes in the system */
1322  HANDLE hProcessSnap = CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0);
1323  if (hProcessSnap != INVALID_HANDLE_VALUE) {
1324  pe32.dwSize = sizeof(PROCESSENTRY32);
1325  if (Process32First(hProcessSnap, &pe32)) {
1326  do
1327  {
1328  for (i = 0; i < SDL_arraysize(mapper_processes); ++i) {
1329  if (SDL_strcasecmp(pe32.szExeFile, mapper_processes[i]) == 0) {
1330  found = SDL_TRUE;
1331  }
1332  }
1333  } while (Process32Next(hProcessSnap, &pe32) && !found);
1334  }
1335  CloseHandle(hProcessSnap);
1336  }
1337  return found;
1338 #else
1339  return SDL_FALSE;
1340 #endif
1341 }
1342 
1344 {
1345  Uint16 vendor;
1346  Uint16 product;
1347 
1348  SDL_GetJoystickGUIDInfo(guid, &vendor, &product, NULL);
1349 
1350  if (SDL_IsJoystickPS4(vendor, product) && SDL_IsPS4RemapperRunning()) {
1351  return SDL_TRUE;
1352  }
1353 
1354  if (SDL_IsGameControllerNameAndGUID(name, guid) &&
1355  SDL_ShouldIgnoreGameController(name, guid)) {
1356  return SDL_TRUE;
1357  }
1358 
1359  return SDL_FALSE;
1360 }
1361 
1362 /* return the guid for this index */
1364 {
1365  SDL_JoystickDriver *driver;
1366  SDL_JoystickGUID guid;
1367 
1369  if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
1370  guid = driver->GetDeviceGUID(device_index);
1371  } else {
1372  SDL_zero(guid);
1373  }
1375 
1376  return guid;
1377 }
1378 
1380 {
1381  Uint16 vendor;
1382  SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1383 
1384  SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1385  return vendor;
1386 }
1387 
1389 {
1390  Uint16 product;
1391  SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1392 
1393  SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1394  return product;
1395 }
1396 
1398 {
1399  Uint16 version;
1400  SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1401 
1402  SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1403  return version;
1404 }
1405 
1407 {
1409  SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1410 
1411  type = SDL_GetJoystickGUIDType(guid);
1412  if (type == SDL_JOYSTICK_TYPE_UNKNOWN) {
1413  if (SDL_IsGameController(device_index)) {
1415  }
1416  }
1417  return type;
1418 }
1419 
1421 {
1422  SDL_JoystickDriver *driver;
1423  SDL_JoystickID instance_id = -1;
1424 
1426  if (SDL_GetDriverAndJoystickIndex(device_index, &driver, &device_index)) {
1427  instance_id = driver->GetDeviceInstanceID(device_index);
1428  }
1430 
1431  return instance_id;
1432 }
1433 
1435 {
1436  int i, num_joysticks, device_index = -1;
1437 
1439  num_joysticks = SDL_NumJoysticks();
1440  for (i = 0; i < num_joysticks; ++i) {
1441  if (SDL_JoystickGetDeviceInstanceID(i) == instance_id) {
1442  device_index = i;
1443  break;
1444  }
1445  }
1447 
1448  return device_index;
1449 }
1450 
1451 SDL_JoystickGUID SDL_JoystickGetGUID(SDL_Joystick * joystick)
1452 {
1453  if (!SDL_PrivateJoystickValid(joystick)) {
1454  SDL_JoystickGUID emptyGUID;
1455  SDL_zero(emptyGUID);
1456  return emptyGUID;
1457  }
1458  return joystick->guid;
1459 }
1460 
1461 Uint16 SDL_JoystickGetVendor(SDL_Joystick * joystick)
1462 {
1463  Uint16 vendor;
1464  SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1465 
1466  SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1467  return vendor;
1468 }
1469 
1470 Uint16 SDL_JoystickGetProduct(SDL_Joystick * joystick)
1471 {
1472  Uint16 product;
1473  SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1474 
1475  SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1476  return product;
1477 }
1478 
1479 Uint16 SDL_JoystickGetProductVersion(SDL_Joystick * joystick)
1480 {
1481  Uint16 version;
1482  SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1483 
1484  SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1485  return version;
1486 }
1487 
1488 SDL_JoystickType SDL_JoystickGetType(SDL_Joystick * joystick)
1489 {
1491  SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1492 
1493  type = SDL_GetJoystickGUIDType(guid);
1494  if (type == SDL_JOYSTICK_TYPE_UNKNOWN) {
1495  if (joystick && joystick->is_game_controller) {
1497  }
1498  }
1499  return type;
1500 }
1501 
1502 /* convert the guid to a printable string */
1503 void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID)
1504 {
1505  static const char k_rgchHexToASCII[] = "0123456789abcdef";
1506  int i;
1507 
1508  if ((pszGUID == NULL) || (cbGUID <= 0)) {
1509  return;
1510  }
1511 
1512  for (i = 0; i < sizeof(guid.data) && i < (cbGUID-1)/2; i++) {
1513  /* each input byte writes 2 ascii chars, and might write a null byte. */
1514  /* If we don't have room for next input byte, stop */
1515  unsigned char c = guid.data[i];
1516 
1517  *pszGUID++ = k_rgchHexToASCII[c >> 4];
1518  *pszGUID++ = k_rgchHexToASCII[c & 0x0F];
1519  }
1520  *pszGUID = '\0';
1521 }
1522 
1523 /*-----------------------------------------------------------------------------
1524  * Purpose: Returns the 4 bit nibble for a hex character
1525  * Input : c -
1526  * Output : unsigned char
1527  *-----------------------------------------------------------------------------*/
1528 static unsigned char nibble(char c)
1529 {
1530  if ((c >= '0') && (c <= '9')) {
1531  return (unsigned char)(c - '0');
1532  }
1533 
1534  if ((c >= 'A') && (c <= 'F')) {
1535  return (unsigned char)(c - 'A' + 0x0a);
1536  }
1537 
1538  if ((c >= 'a') && (c <= 'f')) {
1539  return (unsigned char)(c - 'a' + 0x0a);
1540  }
1541 
1542  /* received an invalid character, and no real way to return an error */
1543  /* AssertMsg1(false, "Q_nibble invalid hex character '%c' ", c); */
1544  return 0;
1545 }
1546 
1547 /* convert the string version of a joystick guid to the struct */
1549 {
1550  SDL_JoystickGUID guid;
1551  int maxoutputbytes= sizeof(guid);
1552  size_t len = SDL_strlen(pchGUID);
1553  Uint8 *p;
1554  size_t i;
1555 
1556  /* Make sure it's even */
1557  len = (len) & ~0x1;
1558 
1559  SDL_memset(&guid, 0x00, sizeof(guid));
1560 
1561  p = (Uint8 *)&guid;
1562  for (i = 0; (i < len) && ((p - (Uint8 *)&guid) < maxoutputbytes); i+=2, p++) {
1563  *p = (nibble(pchGUID[i]) << 4) | nibble(pchGUID[i+1]);
1564  }
1565 
1566  return guid;
1567 }
1568 
1569 /* update the power level for this joystick */
1570 void SDL_PrivateJoystickBatteryLevel(SDL_Joystick * joystick, SDL_JoystickPowerLevel ePowerLevel)
1571 {
1572  joystick->epowerlevel = ePowerLevel;
1573 }
1574 
1575 /* return its power level */
1577 {
1578  if (!SDL_PrivateJoystickValid(joystick)) {
1580  }
1581  return joystick->epowerlevel;
1582 }
1583 
1584 /* vi: set ts=4 sw=4 expandtab: */
static SDL_bool SDL_IsJoystickProductWheel(Uint32 vidpid)
Uint16 SDL_JoystickGetVendor(SDL_Joystick *joystick)
void SDL_JoystickUpdate(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:476
#define SDL_abs
#define SDL_INIT_EVENTS
Definition: SDL.h:83
#define SDL_LockMutex
void SDL_LockJoysticks(void)
Definition: SDL_joystick.c:87
int SDL_JoystickGetBall(SDL_Joystick *joystick, int ball, int *dx, int *dy)
Definition: SDL_joystick.c:519
int SDL_PrivateJoystickValid(SDL_Joystick *joystick)
Definition: SDL_joystick.c:394
SDL_JoyDeviceEvent jdevice
Definition: SDL_events.h:573
GLuint GLfloat GLfloat GLfloat x1
SDL_bool SDL_JoystickGetAxisInitialState(SDL_Joystick *joystick, int axis, Sint16 *state)
Definition: SDL_joystick.c:480
#define MAKE_VIDPID(VID, PID)
SDL_Texture * button
void SDL_JoystickClose(SDL_Joystick *joystick)
Definition: SDL_joystick.c:643
void SDL_PrivateJoystickRemoved(SDL_JoystickID device_instance)
Definition: SDL_joystick.c:800
Uint16 SDL_JoystickGetProduct(SDL_Joystick *joystick)
void SDL_GameControllerQuitMappings(void)
int SDL_PrivateJoystickHat(SDL_Joystick *joystick, Uint8 hat, Uint8 value)
Definition: SDL_joystick.c:885
int SDL_JoystickGetPlayerIndex(SDL_Joystick *joystick)
Definition: SDL_joystick.c:622
int SDL_GameControllerInitMappings(void)
#define SDL_IsGameController
SDL_bool SDL_IsJoystickPS4(Uint16 vendor, Uint16 product)
A type representing an atomic integer value. It is a struct so people don't accidentally use numeric ...
Definition: SDL_atomic.h:198
SDL_bool SDL_IsJoystickSteamController(Uint16 vendor, Uint16 product)
SDL_JoystickDriver SDL_DUMMY_JoystickDriver
int SDL_JoystickGetDeviceIndexFromInstanceID(SDL_JoystickID instance_id)
SDL_bool SDL_IsJoystickNintendoSwitchPro(Uint16 vendor, Uint16 product)
static SDL_mutex * SDL_joystick_lock
Definition: SDL_joystick.c:83
void(* Update)(SDL_Joystick *joystick)
#define SDL_CreateMutex
#define SDL_QuitSubSystem
int SDL_JoystickInit(void)
Definition: SDL_joystick.c:114
struct xkb_state * state
GLfloat GLfloat p
static SDL_Event events[EVENT_BUF_SIZE]
Definition: testgesture.c:35
SDL_bool SDL_ShouldIgnoreJoystick(const char *name, SDL_JoystickGUID guid)
int SDL_PrivateJoystickButton(SDL_Joystick *joystick, Uint8 button, Uint8 state)
Definition: SDL_joystick.c:961
int SDL_JoystickNumHats(SDL_Joystick *joystick)
Definition: SDL_joystick.c:424
uint16_t Uint16
Definition: SDL_stdinc.h:191
#define SDL_ENABLE
Definition: SDL_events.h:756
static SDL_atomic_t SDL_next_joystick_instance_id
Definition: SDL_joystick.c:84
void SDL_GameControllerHandleDelayedGuideButton(SDL_Joystick *joystick)
static EControllerType GuessControllerType(int nVID, int nPID)
#define SDL_InitSubSystem
Uint16 SDL_JoystickGetDeviceProduct(int device_index)
SDL_Texture * axis
Uint16 SDL_JoystickGetProductVersion(SDL_Joystick *joystick)
int(* GetCount)(void)
#define SDL_GetKeyboardFocus
void(* Detect)(void)
#define SDL_strcasecmp
Uint8 data[16]
Definition: SDL_joystick.h:71
int(* GetDevicePlayerIndex)(int device_index)
int SDL_JoystickGetDevicePlayerIndex(int device_index)
Definition: SDL_joystick.c:231
#define SDL_strncmp
Uint16 SDL_JoystickGetDeviceProductVersion(int device_index)
GLenum GLsizei len
int SDL_PrivateJoystickAxis(SDL_Joystick *joystick, Uint8 axis, Sint16 value)
Definition: SDL_joystick.c:828
GLuint const GLchar * name
SDL_JoystickPowerLevel SDL_JoystickCurrentPowerLevel(SDL_Joystick *joystick)
SDL_bool SDL_IsJoystickXboxOne(Uint16 vendor, Uint16 product)
SDL_JoystickDriver SDL_DARWIN_JoystickDriver
SDL_JoystickDriver SDL_IOS_JoystickDriver
static SDL_bool SDL_IsJoystickProductFlightStick(Uint32 vidpid)
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
SDL_JoystickDriver SDL_WINDOWS_JoystickDriver
SDL_bool retval
static void UpdateEventsForDeviceRemoval()
Definition: SDL_joystick.c:776
const char * SDL_JoystickName(SDL_Joystick *joystick)
Definition: SDL_joystick.c:612
int SDL_JoystickEventState(int state)
#define SDL_JOYSTICK_AXIS_MAX
Definition: SDL_joystick.h:301
int SDL_PrivateJoystickBall(SDL_Joystick *joystick, Uint8 ball, Sint16 xrel, Sint16 yrel)
Definition: SDL_joystick.c:925
int SDL_NumJoysticks(void)
Definition: SDL_joystick.c:148
static SDL_JoystickDriver * SDL_joystick_drivers[]
Definition: SDL_joystick.c:48
static SDL_bool SDL_joystick_allows_background_events
Definition: SDL_joystick.c:80
#define SDL_GetEventState(type)
Definition: SDL_events.h:769
Sint32 SDL_JoystickID
Definition: SDL_joystick.h:81
#define SDL_PeepEvents
const char *(* GetDeviceName)(int device_index)
static SDL_bool SDL_IsPS4RemapperRunning(void)
uint8_t Uint8
Definition: SDL_stdinc.h:179
#define SDL_free
#define SDL_stack_alloc(type, count)
Definition: SDL_stdinc.h:354
struct _cl_event * event
void(* Quit)(void)
SDL_JoystickGUID SDL_JoystickGetGUID(SDL_Joystick *joystick)
#define SDL_PushEvent
const GLubyte * c
SDL_bool SDL_ShouldIgnoreGameController(const char *name, SDL_JoystickGUID guid)
SDL_bool SDL_IsJoystickXInput(SDL_JoystickGUID guid)
GLsizei const GLfloat * value
#define SDL_zero(x)
Definition: SDL_stdinc.h:416
static SDL_bool BIsSteamController(EControllerType eType)
SDL_bool SDL_IsJoystickHIDAPI(SDL_JoystickGUID guid)
SDL_Joystick * SDL_JoystickOpen(int device_index)
Definition: SDL_joystick.c:285
SDL_JoystickDriver SDL_LINUX_JoystickDriver
void SDL_UnlockJoysticks(void)
Definition: SDL_joystick.c:95
SDL_JoystickDriver SDL_HIDAPI_JoystickDriver
int(* Open)(SDL_Joystick *joystick, int device_index)
int SDL_JoystickNumAxes(SDL_Joystick *joystick)
Definition: SDL_joystick.c:412
#define SDL_AtomicIncRef(a)
Increment an atomic variable used as a reference count.
Definition: SDL_atomic.h:234
SDL_JoystickPowerLevel
Definition: SDL_joystick.h:97
static const char * SDL_FixupJoystickName(const char *name)
Definition: SDL_joystick.c:198
SDL_JoystickType
Definition: SDL_joystick.h:83
SDL_Joystick * SDL_JoystickFromInstanceID(SDL_JoystickID joyid)
Definition: SDL_joystick.c:594
SDL_bool SDL_IsGameControllerNameAndGUID(const char *name, SDL_JoystickGUID guid)
SDL_JoystickGUID(* GetDeviceGUID)(int device_index)
#define SDL_assert(condition)
Definition: SDL_assert.h:169
SDL_JoystickGUID SDL_JoystickGetDeviceGUID(int device_index)
SDL_JoystickGUID SDL_JoystickGetGUIDFromString(const char *pchGUID)
SDL_JoystickID SDL_JoystickGetDeviceInstanceID(int device_index)
void SDL_PrivateJoystickAdded(SDL_JoystickID device_instance)
Definition: SDL_joystick.c:751
#define SDL_DISABLE
Definition: SDL_events.h:755
#define NULL
Definition: begin_code.h:164
int SDL_JoystickNumBalls(SDL_Joystick *joystick)
Definition: SDL_joystick.c:436
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
SDL_bool
Definition: SDL_stdinc.h:161
#define SDL_SetError
SDL_JoystickDriver SDL_ANDROID_JoystickDriver
static unsigned char nibble(char c)
SDL_JoystickDriver SDL_HAIKU_JoystickDriver
#define SDL_DestroyMutex
SDL_JoystickID SDL_JoystickInstanceID(SDL_Joystick *joystick)
Definition: SDL_joystick.c:581
#define SDL_calloc
int SDL_JoystickRumble(SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble, Uint32 duration_ms)
Definition: SDL_joystick.c:631
SDL_bool SDL_HasWindows(void)
Definition: SDL_video.c:1707
void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
SDL_JoystickID SDL_GetNextJoystickInstanceID()
Definition: SDL_joystick.c:163
#define SDL_strlen
#define SDL_strdup
void SDL_PrivateJoystickBatteryLevel(SDL_Joystick *joystick, SDL_JoystickPowerLevel ePowerLevel)
#define SDL_EventState
SDL_bool SDL_IsJoystickXbox360(Uint16 vendor, Uint16 product)
uint32_t Uint32
Definition: SDL_stdinc.h:203
#define SDL_AddHintCallback
int SDL_JoystickNumButtons(SDL_Joystick *joystick)
Definition: SDL_joystick.c:448
#define SDL_DelHintCallback
void SDL_JoystickGetGUIDString(SDL_JoystickGUID guid, char *pszGUID, int cbGUID)
SDL_JoystickID(* GetDeviceInstanceID)(int device_index)
GLuint GLuint GLsizei GLenum type
Definition: SDL_opengl.h:1571
static SDL_bool SDL_JoystickAxesCenteredAtZero(SDL_Joystick *joystick)
Definition: SDL_joystick.c:251
#define SDL_UnlockMutex
static SDL_bool SDL_PrivateJoystickShouldIgnoreEvent()
Definition: SDL_joystick.c:736
#define SDL_arraysize(array)
Definition: SDL_stdinc.h:115
General event structure.
Definition: SDL_events.h:557
Uint8 SDL_JoystickGetButton(SDL_Joystick *joystick, int button)
Definition: SDL_joystick.c:547
SDL_JoystickDriver SDL_BSD_JoystickDriver
Uint8 SDL_JoystickGetHat(SDL_Joystick *joystick, int hat)
Definition: SDL_joystick.c:499
void SDL_JoystickQuit(void)
Definition: SDL_joystick.c:697
static void SDL_JoystickAllowBackgroundEventsChanged(void *userdata, const char *name, const char *oldValue, const char *hint)
Definition: SDL_joystick.c:104
#define SDL_PRESSED
Definition: SDL_events.h:50
#define SDL_QUERY
Definition: SDL_events.h:753
SDL_bool SDL_GetDriverAndJoystickIndex(int device_index, SDL_JoystickDriver **driver, int *driver_index)
Definition: SDL_joystick.c:173
#define SDL_stack_free(data)
Definition: SDL_stdinc.h:355
#define SDL_HAT_CENTERED
Definition: SDL_joystick.h:329
SDL_bool SDL_JoystickGetAttached(SDL_Joystick *joystick)
Definition: SDL_joystick.c:568
static SDL_JoystickType SDL_GetJoystickGUIDType(SDL_JoystickGUID guid)
#define SDL_RELEASED
Definition: SDL_events.h:49
SDL_JoystickDriver SDL_EMSCRIPTEN_JoystickDriver
Uint16 SDL_JoystickGetDeviceVendor(int device_index)
#define SDLCALL
Definition: SDL_internal.h:45
SDL_JoystickType SDL_JoystickGetDeviceType(int device_index)
static SDL_bool SDL_updating_joystick
Definition: SDL_joystick.c:82
SDL_JoystickType SDL_JoystickGetType(SDL_Joystick *joystick)
const char * SDL_JoystickNameForIndex(int device_index)
Definition: SDL_joystick.c:215
#define SDL_memset
static SDL_bool SDL_IsJoystickProductThrottle(Uint32 vidpid)
int16_t Sint16
Definition: SDL_stdinc.h:185
Uint32 type
Definition: SDL_events.h:559
static SDL_Joystick * SDL_joysticks
Definition: SDL_joystick.c:81
Sint16 SDL_JoystickGetAxis(SDL_Joystick *joystick, int axis)
Definition: SDL_joystick.c:460