SDL 2.0
SDL_joystick.c File Reference
#include "../SDL_internal.h"
#include "SDL.h"
#include "SDL_atomic.h"
#include "SDL_events.h"
#include "SDL_sysjoystick.h"
#include "SDL_assert.h"
#include "SDL_hints.h"
#include "../events/SDL_events_c.h"
#include "../video/SDL_sysvideo.h"
#include "controller_type.h"
#include "../core/windows/SDL_windows.h"
#include <tlhelp32.h>
+ Include dependency graph for SDL_joystick.c:

Go to the source code of this file.

Functions

void SDL_LockJoysticks (void)
 
void SDL_UnlockJoysticks (void)
 
static void SDL_JoystickAllowBackgroundEventsChanged (void *userdata, const char *name, const char *oldValue, const char *hint)
 
int SDL_JoystickInit (void)
 
int SDL_NumJoysticks (void)
 
SDL_JoystickID SDL_GetNextJoystickInstanceID ()
 
SDL_bool SDL_GetDriverAndJoystickIndex (int device_index, SDL_JoystickDriver **driver, int *driver_index)
 
static const char * SDL_FixupJoystickName (const char *name)
 
const char * SDL_JoystickNameForIndex (int device_index)
 
int SDL_JoystickGetDevicePlayerIndex (int device_index)
 
static SDL_bool SDL_JoystickAxesCenteredAtZero (SDL_Joystick *joystick)
 
SDL_Joystick * SDL_JoystickOpen (int device_index)
 
int SDL_PrivateJoystickValid (SDL_Joystick *joystick)
 
int SDL_JoystickNumAxes (SDL_Joystick *joystick)
 
int SDL_JoystickNumHats (SDL_Joystick *joystick)
 
int SDL_JoystickNumBalls (SDL_Joystick *joystick)
 
int SDL_JoystickNumButtons (SDL_Joystick *joystick)
 
Sint16 SDL_JoystickGetAxis (SDL_Joystick *joystick, int axis)
 
SDL_bool SDL_JoystickGetAxisInitialState (SDL_Joystick *joystick, int axis, Sint16 *state)
 
Uint8 SDL_JoystickGetHat (SDL_Joystick *joystick, int hat)
 
int SDL_JoystickGetBall (SDL_Joystick *joystick, int ball, int *dx, int *dy)
 
Uint8 SDL_JoystickGetButton (SDL_Joystick *joystick, int button)
 
SDL_bool SDL_JoystickGetAttached (SDL_Joystick *joystick)
 
SDL_JoystickID SDL_JoystickInstanceID (SDL_Joystick *joystick)
 
SDL_Joystick * SDL_JoystickFromInstanceID (SDL_JoystickID joyid)
 
const char * SDL_JoystickName (SDL_Joystick *joystick)
 
int SDL_JoystickGetPlayerIndex (SDL_Joystick *joystick)
 
int SDL_JoystickRumble (SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble, Uint32 duration_ms)
 
void SDL_JoystickClose (SDL_Joystick *joystick)
 
void SDL_JoystickQuit (void)
 
static SDL_bool SDL_PrivateJoystickShouldIgnoreEvent ()
 
void SDL_PrivateJoystickAdded (SDL_JoystickID device_instance)
 
static void UpdateEventsForDeviceRemoval ()
 
void SDL_PrivateJoystickRemoved (SDL_JoystickID device_instance)
 
int SDL_PrivateJoystickAxis (SDL_Joystick *joystick, Uint8 axis, Sint16 value)
 
int SDL_PrivateJoystickHat (SDL_Joystick *joystick, Uint8 hat, Uint8 value)
 
int SDL_PrivateJoystickBall (SDL_Joystick *joystick, Uint8 ball, Sint16 xrel, Sint16 yrel)
 
int SDL_PrivateJoystickButton (SDL_Joystick *joystick, Uint8 button, Uint8 state)
 
void SDL_JoystickUpdate (void)
 
int SDL_JoystickEventState (int state)
 
void SDL_GetJoystickGUIDInfo (SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
 
SDL_bool SDL_IsJoystickPS4 (Uint16 vendor, Uint16 product)
 
SDL_bool SDL_IsJoystickNintendoSwitchPro (Uint16 vendor, Uint16 product)
 
SDL_bool SDL_IsJoystickSteamController (Uint16 vendor, Uint16 product)
 
SDL_bool SDL_IsJoystickXbox360 (Uint16 vendor, Uint16 product)
 
SDL_bool SDL_IsJoystickXboxOne (Uint16 vendor, Uint16 product)
 
SDL_bool SDL_IsJoystickXInput (SDL_JoystickGUID guid)
 
SDL_bool SDL_IsJoystickHIDAPI (SDL_JoystickGUID guid)
 
static SDL_bool SDL_IsJoystickProductWheel (Uint32 vidpid)
 
static SDL_bool SDL_IsJoystickProductFlightStick (Uint32 vidpid)
 
static SDL_bool SDL_IsJoystickProductThrottle (Uint32 vidpid)
 
static SDL_JoystickType SDL_GetJoystickGUIDType (SDL_JoystickGUID guid)
 
static SDL_bool SDL_IsPS4RemapperRunning (void)
 
SDL_bool SDL_ShouldIgnoreJoystick (const char *name, SDL_JoystickGUID guid)
 
SDL_JoystickGUID SDL_JoystickGetDeviceGUID (int device_index)
 
Uint16 SDL_JoystickGetDeviceVendor (int device_index)
 
Uint16 SDL_JoystickGetDeviceProduct (int device_index)
 
Uint16 SDL_JoystickGetDeviceProductVersion (int device_index)
 
SDL_JoystickType SDL_JoystickGetDeviceType (int device_index)
 
SDL_JoystickID SDL_JoystickGetDeviceInstanceID (int device_index)
 
int SDL_JoystickGetDeviceIndexFromInstanceID (SDL_JoystickID instance_id)
 
SDL_JoystickGUID SDL_JoystickGetGUID (SDL_Joystick *joystick)
 
Uint16 SDL_JoystickGetVendor (SDL_Joystick *joystick)
 
Uint16 SDL_JoystickGetProduct (SDL_Joystick *joystick)
 
Uint16 SDL_JoystickGetProductVersion (SDL_Joystick *joystick)
 
SDL_JoystickType SDL_JoystickGetType (SDL_Joystick *joystick)
 
void SDL_JoystickGetGUIDString (SDL_JoystickGUID guid, char *pszGUID, int cbGUID)
 
static unsigned char nibble (char c)
 
SDL_JoystickGUID SDL_JoystickGetGUIDFromString (const char *pchGUID)
 
void SDL_PrivateJoystickBatteryLevel (SDL_Joystick *joystick, SDL_JoystickPowerLevel ePowerLevel)
 
SDL_JoystickPowerLevel SDL_JoystickCurrentPowerLevel (SDL_Joystick *joystick)
 

Variables

static SDL_JoystickDriverSDL_joystick_drivers []
 
static SDL_bool SDL_joystick_allows_background_events = SDL_FALSE
 
static SDL_Joystick * SDL_joysticks = NULL
 
static SDL_bool SDL_updating_joystick = SDL_FALSE
 
static SDL_mutexSDL_joystick_lock = NULL
 
static SDL_atomic_t SDL_next_joystick_instance_id
 

Function Documentation

◆ nibble()

static unsigned char nibble ( char  c)
static

Definition at line 1654 of file SDL_joystick.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}
const GLubyte * c

Referenced by LAW_Decode(), and SDL_JoystickGetGUIDFromString().

◆ SDL_FixupJoystickName()

static const char * SDL_FixupJoystickName ( const char *  name)
static

Definition at line 198 of file SDL_joystick.c.

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}
#define SDL_strncmp
#define SDL_strlen
GLuint const GLchar * name

References SDL_strlen, and SDL_strncmp.

Referenced by SDL_JoystickName(), and SDL_JoystickNameForIndex().

◆ SDL_GetDriverAndJoystickIndex()

SDL_bool SDL_GetDriverAndJoystickIndex ( int  device_index,
SDL_JoystickDriver **  driver,
int *  driver_index 
)

Definition at line 173 of file SDL_joystick.c.

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}
#define SDL_SetError
static SDL_JoystickDriver * SDL_joystick_drivers[]
Definition: SDL_joystick.c:48
@ SDL_TRUE
Definition: SDL_stdinc.h:164
@ SDL_FALSE
Definition: SDL_stdinc.h:163
#define SDL_arraysize(array)
Definition: SDL_stdinc.h:115
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
int(* GetCount)(void)

References SDL_JoystickDriver::GetCount, i, SDL_arraysize, SDL_FALSE, SDL_joystick_drivers, SDL_SetError, and SDL_TRUE.

Referenced by SDL_JoystickGetDeviceGUID(), SDL_JoystickGetDeviceInstanceID(), SDL_JoystickGetDevicePlayerIndex(), SDL_JoystickNameForIndex(), and SDL_JoystickOpen().

◆ SDL_GetJoystickGUIDInfo()

void SDL_GetJoystickGUIDInfo ( SDL_JoystickGUID  guid,
Uint16 vendor,
Uint16 product,
Uint16 version 
)

Definition at line 1125 of file SDL_joystick.c.

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}
uint16_t Uint16
Definition: SDL_stdinc.h:191
Uint8 data[16]
Definition: SDL_joystick.h:71

References SDL_JoystickGUID::data.

Referenced by SDL_GetJoystickGUIDType(), SDL_JoystickGetDeviceProduct(), SDL_JoystickGetDeviceProductVersion(), SDL_JoystickGetDeviceVendor(), SDL_JoystickGetProduct(), SDL_JoystickGetProductVersion(), SDL_JoystickGetVendor(), SDL_ShouldIgnoreGameController(), and SDL_ShouldIgnoreJoystick().

◆ SDL_GetJoystickGUIDType()

static SDL_JoystickType SDL_GetJoystickGUIDType ( SDL_JoystickGUID  guid)
static

Definition at line 1272 of file SDL_joystick.c.

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}
static SDL_bool SDL_IsJoystickProductFlightStick(Uint32 vidpid)
static SDL_bool SDL_IsJoystickProductWheel(Uint32 vidpid)
void SDL_GetJoystickGUIDInfo(SDL_JoystickGUID guid, Uint16 *vendor, Uint16 *product, Uint16 *version)
static SDL_bool SDL_IsJoystickProductThrottle(Uint32 vidpid)
SDL_bool SDL_IsJoystickXInput(SDL_JoystickGUID guid)
@ 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
uint32_t Uint32
Definition: SDL_stdinc.h:203
#define MAKE_VIDPID(VID, PID)
#define NULL
Definition: begin_code.h:167
@ k_eControllerType_UnknownNonSteamController
static EControllerType GuessControllerType(int nVID, int nPID)

References SDL_JoystickGUID::data, GuessControllerType(), k_eControllerType_UnknownNonSteamController, MAKE_VIDPID, NULL, SDL_GetJoystickGUIDInfo(), SDL_IsJoystickProductFlightStick(), SDL_IsJoystickProductThrottle(), SDL_IsJoystickProductWheel(), SDL_IsJoystickXInput(), SDL_JOYSTICK_TYPE_ARCADE_PAD, SDL_JOYSTICK_TYPE_ARCADE_STICK, SDL_JOYSTICK_TYPE_DANCE_PAD, SDL_JOYSTICK_TYPE_DRUM_KIT, SDL_JOYSTICK_TYPE_FLIGHT_STICK, SDL_JOYSTICK_TYPE_GAMECONTROLLER, SDL_JOYSTICK_TYPE_GUITAR, SDL_JOYSTICK_TYPE_THROTTLE, SDL_JOYSTICK_TYPE_UNKNOWN, and SDL_JOYSTICK_TYPE_WHEEL.

Referenced by SDL_JoystickGetDeviceType(), and SDL_JoystickGetType().

◆ SDL_GetNextJoystickInstanceID()

SDL_JoystickID SDL_GetNextJoystickInstanceID ( void  )

Definition at line 163 of file SDL_joystick.c.

164{
166}
#define SDL_AtomicIncRef(a)
Increment an atomic variable used as a reference count.
Definition: SDL_atomic.h:252
static SDL_atomic_t SDL_next_joystick_instance_id
Definition: SDL_joystick.c:84

References SDL_AtomicIncRef, and SDL_next_joystick_instance_id.

Referenced by IOS_AddJoystickDevice().

◆ SDL_IsJoystickHIDAPI()

SDL_bool SDL_IsJoystickHIDAPI ( SDL_JoystickGUID  guid)

Definition at line 1208 of file SDL_joystick.c.

1209{
1210 return (guid.data[14] == 'h') ? SDL_TRUE : SDL_FALSE;
1211}

References SDL_JoystickGUID::data, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_PrivateGetControllerMappingForGUID(), and SDL_PrivateGetControllerMappingForNameAndGUID().

◆ SDL_IsJoystickNintendoSwitchPro()

SDL_bool SDL_IsJoystickNintendoSwitchPro ( Uint16  vendor,
Uint16  product 
)

Definition at line 1167 of file SDL_joystick.c.

1168{
1169 EControllerType eType = GuessControllerType(vendor, product);
1170 return (eType == k_eControllerType_SwitchProController ||
1172}
EControllerType
@ k_eControllerType_SwitchProController
@ k_eControllerType_SwitchInputOnlyController

References GuessControllerType(), k_eControllerType_SwitchInputOnlyController, and k_eControllerType_SwitchProController.

◆ SDL_IsJoystickProductFlightStick()

static SDL_bool SDL_IsJoystickProductFlightStick ( Uint32  vidpid)
static

Definition at line 1240 of file SDL_joystick.c.

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}

References i, MAKE_VIDPID, SDL_arraysize, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_GetJoystickGUIDType().

◆ SDL_IsJoystickProductThrottle()

static SDL_bool SDL_IsJoystickProductThrottle ( Uint32  vidpid)
static

Definition at line 1256 of file SDL_joystick.c.

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}

References i, MAKE_VIDPID, SDL_arraysize, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_GetJoystickGUIDType().

◆ SDL_IsJoystickProductWheel()

static SDL_bool SDL_IsJoystickProductWheel ( Uint32  vidpid)
static

Definition at line 1213 of file SDL_joystick.c.

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}

References i, MAKE_VIDPID, SDL_arraysize, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_GetJoystickGUIDType().

◆ SDL_IsJoystickPS4()

SDL_bool SDL_IsJoystickPS4 ( Uint16  vendor,
Uint16  product 
)

Definition at line 1161 of file SDL_joystick.c.

1162{
1163 return (GuessControllerType(vendor, product) == k_eControllerType_PS4Controller);
1164}
@ k_eControllerType_PS4Controller

References GuessControllerType(), and k_eControllerType_PS4Controller.

Referenced by SDL_ShouldIgnoreJoystick().

◆ SDL_IsJoystickSteamController()

SDL_bool SDL_IsJoystickSteamController ( Uint16  vendor,
Uint16  product 
)

Definition at line 1175 of file SDL_joystick.c.

1176{
1177 EControllerType eType = GuessControllerType(vendor, product);
1178 return (eType == k_eControllerType_SteamController ||
1180}
@ k_eControllerType_SteamController
@ k_eControllerType_SteamControllerV2

References GuessControllerType(), k_eControllerType_SteamController, and k_eControllerType_SteamControllerV2.

◆ SDL_IsJoystickXbox360()

SDL_bool SDL_IsJoystickXbox360 ( Uint16  vendor,
Uint16  product 
)

Definition at line 1183 of file SDL_joystick.c.

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}
@ k_eControllerType_XBox360Controller

References GuessControllerType(), k_eControllerType_XBox360Controller, and SDL_FALSE.

◆ SDL_IsJoystickXboxOne()

SDL_bool SDL_IsJoystickXboxOne ( Uint16  vendor,
Uint16  product 
)

Definition at line 1196 of file SDL_joystick.c.

1197{
1198 return (GuessControllerType(vendor, product) == k_eControllerType_XBoxOneController);
1199}
@ k_eControllerType_XBoxOneController

References GuessControllerType(), and k_eControllerType_XBoxOneController.

◆ SDL_IsJoystickXInput()

SDL_bool SDL_IsJoystickXInput ( SDL_JoystickGUID  guid)

Definition at line 1202 of file SDL_joystick.c.

1203{
1204 return (guid.data[14] == 'x') ? SDL_TRUE : SDL_FALSE;
1205}

References SDL_JoystickGUID::data, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_GetJoystickGUIDType(), and SDL_PrivateGetControllerMappingForGUID().

◆ SDL_IsPS4RemapperRunning()

static SDL_bool SDL_IsPS4RemapperRunning ( void  )
static

Definition at line 1326 of file SDL_joystick.c.

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}
#define SDL_strcasecmp
SDL_bool
Definition: SDL_stdinc.h:162

References i, SDL_arraysize, SDL_FALSE, SDL_strcasecmp, and SDL_TRUE.

Referenced by SDL_ShouldIgnoreJoystick().

◆ SDL_JoystickAllowBackgroundEventsChanged()

static void SDL_JoystickAllowBackgroundEventsChanged ( void userdata,
const char *  name,
const char *  oldValue,
const char *  hint 
)
static

Definition at line 104 of file SDL_joystick.c.

105{
106 if (hint && *hint == '1') {
108 } else {
110 }
111}
static SDL_bool SDL_joystick_allows_background_events
Definition: SDL_joystick.c:80

References SDL_FALSE, SDL_joystick_allows_background_events, and SDL_TRUE.

Referenced by SDL_JoystickInit(), and SDL_JoystickQuit().

◆ SDL_JoystickAxesCenteredAtZero()

static SDL_bool SDL_JoystickAxesCenteredAtZero ( SDL_Joystick *  joystick)
static

Definition at line 251 of file SDL_joystick.c.

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}
Uint16 SDL_JoystickGetProduct(SDL_Joystick *joystick)
Uint16 SDL_JoystickGetVendor(SDL_Joystick *joystick)

References i, MAKE_VIDPID, SDL_arraysize, SDL_FALSE, SDL_JoystickGetProduct(), SDL_JoystickGetVendor(), and SDL_TRUE.

Referenced by SDL_JoystickOpen().

◆ SDL_JoystickClose()

void SDL_JoystickClose ( SDL_Joystick *  joystick)

Close a joystick previously opened with SDL_JoystickOpen().

Definition at line 643 of file SDL_joystick.c.

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}
#define SDL_free
void SDL_LockJoysticks(void)
Definition: SDL_joystick.c:87
static SDL_bool SDL_updating_joystick
Definition: SDL_joystick.c:82
void SDL_UnlockJoysticks(void)
Definition: SDL_joystick.c:95
static SDL_Joystick * SDL_joysticks
Definition: SDL_joystick.c:81
int SDL_PrivateJoystickValid(SDL_Joystick *joystick)
Definition: SDL_joystick.c:394

References NULL, SDL_free, SDL_joysticks, SDL_LockJoysticks(), SDL_PrivateJoystickValid(), SDL_UnlockJoysticks(), and SDL_updating_joystick.

Referenced by SDL_JoystickOpen(), SDL_JoystickQuit(), and SDL_JoystickUpdate().

◆ SDL_JoystickCurrentPowerLevel()

SDL_JoystickPowerLevel SDL_JoystickCurrentPowerLevel ( SDL_Joystick *  joystick)

Return the battery level of this joystick

Definition at line 1702 of file SDL_joystick.c.

1703{
1704 if (!SDL_PrivateJoystickValid(joystick)) {
1706 }
1707 return joystick->epowerlevel;
1708}
@ SDL_JOYSTICK_POWER_UNKNOWN
Definition: SDL_joystick.h:99

References SDL_JOYSTICK_POWER_UNKNOWN, and SDL_PrivateJoystickValid().

◆ SDL_JoystickEventState()

int SDL_JoystickEventState ( int  state)

Enable/disable joystick event polling.

If joystick events are disabled, you must call SDL_JoystickUpdate() yourself and check the state of the joystick when you want joystick information.

The state can be one of SDL_QUERY, SDL_ENABLE or SDL_IGNORE.

Definition at line 1094 of file SDL_joystick.c.

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}
#define SDL_EventState
@ 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_DISABLE
Definition: SDL_events.h:758
#define SDL_ENABLE
Definition: SDL_events.h:759
struct xkb_state * state

References i, SDL_arraysize, SDL_DISABLE, SDL_ENABLE, SDL_EventState, SDL_JOYAXISMOTION, SDL_JOYBALLMOTION, SDL_JOYBUTTONDOWN, SDL_JOYBUTTONUP, SDL_JOYDEVICEADDED, SDL_JOYDEVICEREMOVED, SDL_JOYHATMOTION, SDL_QUERY, and state.

◆ SDL_JoystickFromInstanceID()

SDL_Joystick * SDL_JoystickFromInstanceID ( SDL_JoystickID  joyid)

Return the SDL_Joystick associated with an instance id.

Definition at line 594 of file SDL_joystick.c.

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}

References SDL_joysticks, SDL_LockJoysticks(), and SDL_UnlockJoysticks().

◆ SDL_JoystickGetAttached()

SDL_bool SDL_JoystickGetAttached ( SDL_Joystick *  joystick)

Returns SDL_TRUE if the joystick has been opened and currently connected, or SDL_FALSE if it has not.

Definition at line 568 of file SDL_joystick.c.

569{
570 if (!SDL_PrivateJoystickValid(joystick)) {
571 return SDL_FALSE;
572 }
573
574 return joystick->attached;
575}

References SDL_FALSE, and SDL_PrivateJoystickValid().

◆ SDL_JoystickGetAxis()

Sint16 SDL_JoystickGetAxis ( SDL_Joystick *  joystick,
int  axis 
)

Get the current state of an axis control on a joystick.

The state is a value ranging from -32768 to 32767.

The axis indices start at index 0.

Definition at line 460 of file SDL_joystick.c.

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}
int16_t Sint16
Definition: SDL_stdinc.h:185
SDL_Texture * axis

References axis, SDL_PrivateJoystickValid(), SDL_SetError, and state.

◆ SDL_JoystickGetAxisInitialState()

SDL_bool SDL_JoystickGetAxisInitialState ( SDL_Joystick *  joystick,
int  axis,
Sint16 state 
)

Get the initial state of an axis control on a joystick.

The state is a value ranging from -32768 to 32767.

The axis indices start at index 0.

Returns
SDL_TRUE if this axis has any initial value, or SDL_FALSE if not.

Definition at line 480 of file SDL_joystick.c.

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}

References axis, SDL_FALSE, SDL_PrivateJoystickValid(), SDL_SetError, and state.

◆ SDL_JoystickGetBall()

int SDL_JoystickGetBall ( SDL_Joystick *  joystick,
int  ball,
int *  dx,
int *  dy 
)

Get the ball axis change since the last poll.

Returns
0, or -1 if you passed it invalid parameters.

The ball indices start at index 0.

Definition at line 519 of file SDL_joystick.c.

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}
SDL_bool retval

References retval, SDL_PrivateJoystickValid(), and SDL_SetError.

◆ SDL_JoystickGetButton()

Uint8 SDL_JoystickGetButton ( SDL_Joystick *  joystick,
int  button 
)

Get the current state of a button on a joystick.

The button indices start at index 0.

Definition at line 547 of file SDL_joystick.c.

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}
uint8_t Uint8
Definition: SDL_stdinc.h:179
SDL_Texture * button

References button, SDL_PrivateJoystickValid(), SDL_SetError, and state.

◆ SDL_JoystickGetDeviceGUID()

SDL_JoystickGUID SDL_JoystickGetDeviceGUID ( int  device_index)

Return the GUID for the joystick at this index This can be called before any joysticks are opened.

Definition at line 1489 of file SDL_joystick.c.

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}
SDL_bool SDL_GetDriverAndJoystickIndex(int device_index, SDL_JoystickDriver **driver, int *driver_index)
Definition: SDL_joystick.c:173
#define SDL_zero(x)
Definition: SDL_stdinc.h:416
SDL_JoystickGUID(* GetDeviceGUID)(int device_index)

References SDL_JoystickDriver::GetDeviceGUID, SDL_GetDriverAndJoystickIndex(), SDL_LockJoysticks(), SDL_UnlockJoysticks(), and SDL_zero.

Referenced by SDL_JoystickGetDeviceProduct(), SDL_JoystickGetDeviceProductVersion(), SDL_JoystickGetDeviceType(), and SDL_JoystickGetDeviceVendor().

◆ SDL_JoystickGetDeviceIndexFromInstanceID()

int SDL_JoystickGetDeviceIndexFromInstanceID ( SDL_JoystickID  instance_id)

Definition at line 1560 of file SDL_joystick.c.

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}
SDL_JoystickID SDL_JoystickGetDeviceInstanceID(int device_index)
int SDL_NumJoysticks(void)
Definition: SDL_joystick.c:148

References i, SDL_JoystickGetDeviceInstanceID(), SDL_LockJoysticks(), SDL_NumJoysticks(), and SDL_UnlockJoysticks().

Referenced by SDL_PrivateJoystickAdded().

◆ SDL_JoystickGetDeviceInstanceID()

SDL_JoystickID SDL_JoystickGetDeviceInstanceID ( int  device_index)

Get the instance ID of a joystick. This can be called before any joysticks are opened. If the index is out of range, this function will return -1.

Definition at line 1546 of file SDL_joystick.c.

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}
Sint32 SDL_JoystickID
Definition: SDL_joystick.h:81
SDL_JoystickID(* GetDeviceInstanceID)(int device_index)

References SDL_JoystickDriver::GetDeviceInstanceID, SDL_GetDriverAndJoystickIndex(), SDL_LockJoysticks(), and SDL_UnlockJoysticks().

Referenced by SDL_JoystickGetDeviceIndexFromInstanceID().

◆ SDL_JoystickGetDevicePlayerIndex()

int SDL_JoystickGetDevicePlayerIndex ( int  device_index)

Get the player index of a joystick, or -1 if it's not available This can be called before any joysticks are opened.

Definition at line 231 of file SDL_joystick.c.

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}
int(* GetDevicePlayerIndex)(int device_index)

References SDL_JoystickDriver::GetDevicePlayerIndex, SDL_GetDriverAndJoystickIndex(), SDL_LockJoysticks(), and SDL_UnlockJoysticks().

◆ SDL_JoystickGetDeviceProduct()

Uint16 SDL_JoystickGetDeviceProduct ( int  device_index)

Get the USB product ID of a joystick, if available. This can be called before any joysticks are opened. If the product ID isn't available this function returns 0.

Definition at line 1514 of file SDL_joystick.c.

1515{
1516 Uint16 product;
1517 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1518
1519 SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1520 return product;
1521}
SDL_JoystickGUID SDL_JoystickGetDeviceGUID(int device_index)

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetDeviceGUID().

◆ SDL_JoystickGetDeviceProductVersion()

Uint16 SDL_JoystickGetDeviceProductVersion ( int  device_index)

Get the product version of a joystick, if available. This can be called before any joysticks are opened. If the product version isn't available this function returns 0.

Definition at line 1523 of file SDL_joystick.c.

1524{
1525 Uint16 version;
1526 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1527
1528 SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1529 return version;
1530}

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetDeviceGUID().

◆ SDL_JoystickGetDeviceType()

SDL_JoystickType SDL_JoystickGetDeviceType ( int  device_index)

Get the type of a joystick, if available. This can be called before any joysticks are opened.

Definition at line 1532 of file SDL_joystick.c.

1533{
1535 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1536
1539 if (SDL_IsGameController(device_index)) {
1541 }
1542 }
1543 return type;
1544}
#define SDL_IsGameController
static SDL_JoystickType SDL_GetJoystickGUIDType(SDL_JoystickGUID guid)
SDL_JoystickType
Definition: SDL_joystick.h:84
GLuint GLuint GLsizei GLenum type
Definition: SDL_opengl.h:1571

References SDL_GetJoystickGUIDType(), SDL_IsGameController, SDL_JOYSTICK_TYPE_GAMECONTROLLER, SDL_JOYSTICK_TYPE_UNKNOWN, and SDL_JoystickGetDeviceGUID().

◆ SDL_JoystickGetDeviceVendor()

Uint16 SDL_JoystickGetDeviceVendor ( int  device_index)

Get the USB vendor ID of a joystick, if available. This can be called before any joysticks are opened. If the vendor ID isn't available this function returns 0.

Definition at line 1505 of file SDL_joystick.c.

1506{
1507 Uint16 vendor;
1508 SDL_JoystickGUID guid = SDL_JoystickGetDeviceGUID(device_index);
1509
1510 SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1511 return vendor;
1512}

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetDeviceGUID().

◆ SDL_JoystickGetGUID()

SDL_JoystickGUID SDL_JoystickGetGUID ( SDL_Joystick *  joystick)

Return the GUID for this opened joystick

Definition at line 1577 of file SDL_joystick.c.

1578{
1579 if (!SDL_PrivateJoystickValid(joystick)) {
1580 SDL_JoystickGUID emptyGUID;
1581 SDL_zero(emptyGUID);
1582 return emptyGUID;
1583 }
1584 return joystick->guid;
1585}

References SDL_PrivateJoystickValid(), and SDL_zero.

Referenced by SDL_JoystickGetProduct(), SDL_JoystickGetProductVersion(), SDL_JoystickGetType(), and SDL_JoystickGetVendor().

◆ SDL_JoystickGetGUIDFromString()

SDL_JoystickGUID SDL_JoystickGetGUIDFromString ( const char *  pchGUID)

Convert a string into a joystick guid

Definition at line 1674 of file SDL_joystick.c.

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}
#define SDL_memset
static unsigned char nibble(char c)
GLenum GLsizei len
GLfloat GLfloat p

References i, nibble(), SDL_memset, and SDL_strlen.

◆ SDL_JoystickGetGUIDString()

void SDL_JoystickGetGUIDString ( SDL_JoystickGUID  guid,
char *  pszGUID,
int  cbGUID 
)

Return a string representation for this guid. pszGUID must point to at least 33 bytes (32 for the string plus a NULL terminator).

Definition at line 1629 of file SDL_joystick.c.

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}

References SDL_JoystickGUID::data, i, and NULL.

◆ SDL_JoystickGetHat()

Uint8 SDL_JoystickGetHat ( SDL_Joystick *  joystick,
int  hat 
)

Get the current state of a POV hat on a joystick.

The hat indices start at index 0.

Returns
The return value is one of the following positions:

Definition at line 499 of file SDL_joystick.c.

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}

References SDL_PrivateJoystickValid(), SDL_SetError, and state.

◆ SDL_JoystickGetPlayerIndex()

int SDL_JoystickGetPlayerIndex ( SDL_Joystick *  joystick)

Get the player index of an opened joystick, or -1 if it's not available

For XInput controllers this returns the XInput user index.

Definition at line 622 of file SDL_joystick.c.

623{
624 if (!SDL_PrivateJoystickValid(joystick)) {
625 return -1;
626 }
627 return joystick->player_index;
628}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickGetProduct()

Uint16 SDL_JoystickGetProduct ( SDL_Joystick *  joystick)

Get the USB product ID of an opened joystick, if available. If the product ID isn't available this function returns 0.

Definition at line 1596 of file SDL_joystick.c.

1597{
1598 Uint16 product;
1599 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1600
1601 SDL_GetJoystickGUIDInfo(guid, NULL, &product, NULL);
1602 return product;
1603}
SDL_JoystickGUID SDL_JoystickGetGUID(SDL_Joystick *joystick)

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetGUID().

Referenced by SDL_JoystickAxesCenteredAtZero().

◆ SDL_JoystickGetProductVersion()

Uint16 SDL_JoystickGetProductVersion ( SDL_Joystick *  joystick)

Get the product version of an opened joystick, if available. If the product version isn't available this function returns 0.

Definition at line 1605 of file SDL_joystick.c.

1606{
1607 Uint16 version;
1608 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1609
1610 SDL_GetJoystickGUIDInfo(guid, NULL, NULL, &version);
1611 return version;
1612}

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetGUID().

◆ SDL_JoystickGetType()

SDL_JoystickType SDL_JoystickGetType ( SDL_Joystick *  joystick)

Get the type of an opened joystick.

Definition at line 1614 of file SDL_joystick.c.

1615{
1617 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1618
1621 if (joystick && joystick->is_game_controller) {
1623 }
1624 }
1625 return type;
1626}

References SDL_GetJoystickGUIDType(), SDL_JOYSTICK_TYPE_GAMECONTROLLER, SDL_JOYSTICK_TYPE_UNKNOWN, and SDL_JoystickGetGUID().

◆ SDL_JoystickGetVendor()

Uint16 SDL_JoystickGetVendor ( SDL_Joystick *  joystick)

Get the USB vendor ID of an opened joystick, if available. If the vendor ID isn't available this function returns 0.

Definition at line 1587 of file SDL_joystick.c.

1588{
1589 Uint16 vendor;
1590 SDL_JoystickGUID guid = SDL_JoystickGetGUID(joystick);
1591
1592 SDL_GetJoystickGUIDInfo(guid, &vendor, NULL, NULL);
1593 return vendor;
1594}

References NULL, SDL_GetJoystickGUIDInfo(), and SDL_JoystickGetGUID().

Referenced by SDL_JoystickAxesCenteredAtZero().

◆ SDL_JoystickInit()

int SDL_JoystickInit ( void  )

Definition at line 114 of file SDL_joystick.c.

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}
#define SDL_INIT_EVENTS
Definition: SDL.h:83
#define SDL_InitSubSystem
#define SDL_CreateMutex
#define SDL_AddHintCallback
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
static void SDL_JoystickAllowBackgroundEventsChanged(void *userdata, const char *name, const char *oldValue, const char *hint)
Definition: SDL_joystick.c:104
static SDL_mutex * SDL_joystick_lock
Definition: SDL_joystick.c:83

References i, NULL, SDL_AddHintCallback, SDL_arraysize, SDL_CreateMutex, SDL_GameControllerInitMappings(), SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS, SDL_INIT_EVENTS, SDL_InitSubSystem, SDL_joystick_drivers, SDL_joystick_lock, and SDL_JoystickAllowBackgroundEventsChanged().

Referenced by SDL_InitSubSystem().

◆ SDL_JoystickInstanceID()

SDL_JoystickID SDL_JoystickInstanceID ( SDL_Joystick *  joystick)

Get the instance ID of an opened joystick or -1 if the joystick is invalid.

Definition at line 581 of file SDL_joystick.c.

582{
583 if (!SDL_PrivateJoystickValid(joystick)) {
584 return -1;
585 }
586
587 return joystick->instance_id;
588}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickName()

const char * SDL_JoystickName ( SDL_Joystick *  joystick)

Return the name for this currently opened joystick. If no name can be found, this function returns NULL.

Definition at line 612 of file SDL_joystick.c.

613{
614 if (!SDL_PrivateJoystickValid(joystick)) {
615 return NULL;
616 }
617
618 return SDL_FixupJoystickName(joystick->name);
619}
static const char * SDL_FixupJoystickName(const char *name)
Definition: SDL_joystick.c:198

References NULL, SDL_FixupJoystickName(), and SDL_PrivateJoystickValid().

◆ SDL_JoystickNameForIndex()

const char * SDL_JoystickNameForIndex ( int  device_index)

Get the implementation dependent name of a joystick. This can be called before any joysticks are opened. If no name can be found, this function returns NULL.

Definition at line 215 of file SDL_joystick.c.

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}
const char *(* GetDeviceName)(int device_index)

References SDL_JoystickDriver::GetDeviceName, NULL, SDL_FixupJoystickName(), SDL_GetDriverAndJoystickIndex(), SDL_LockJoysticks(), and SDL_UnlockJoysticks().

◆ SDL_JoystickNumAxes()

int SDL_JoystickNumAxes ( SDL_Joystick *  joystick)

Get the number of general axis controls on a joystick.

Definition at line 412 of file SDL_joystick.c.

413{
414 if (!SDL_PrivateJoystickValid(joystick)) {
415 return -1;
416 }
417 return joystick->naxes;
418}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickNumBalls()

int SDL_JoystickNumBalls ( SDL_Joystick *  joystick)

Get the number of trackballs on a joystick.

Joystick trackballs have only relative motion events associated with them and their state cannot be polled.

Definition at line 436 of file SDL_joystick.c.

437{
438 if (!SDL_PrivateJoystickValid(joystick)) {
439 return -1;
440 }
441 return joystick->nballs;
442}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickNumButtons()

int SDL_JoystickNumButtons ( SDL_Joystick *  joystick)

Get the number of buttons on a joystick.

Definition at line 448 of file SDL_joystick.c.

449{
450 if (!SDL_PrivateJoystickValid(joystick)) {
451 return -1;
452 }
453 return joystick->nbuttons;
454}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickNumHats()

int SDL_JoystickNumHats ( SDL_Joystick *  joystick)

Get the number of POV hats on a joystick.

Definition at line 424 of file SDL_joystick.c.

425{
426 if (!SDL_PrivateJoystickValid(joystick)) {
427 return -1;
428 }
429 return joystick->nhats;
430}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickOpen()

SDL_Joystick * SDL_JoystickOpen ( int  device_index)

Open a joystick for use. The index passed as an argument refers to the N'th joystick on the system. This index is not the value which will identify this joystick in future joystick events. The joystick's instance id (SDL_JoystickID) will be used there instead.

Returns
A joystick identifier, or NULL if an error occurred.

Definition at line 285 of file SDL_joystick.c.

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}
#define SDL_strdup
#define SDL_calloc
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
static SDL_bool SDL_JoystickAxesCenteredAtZero(SDL_Joystick *joystick)
Definition: SDL_joystick.c:251
void SDL_JoystickClose(SDL_Joystick *joystick)
Definition: SDL_joystick.c:643
void(* Update)(SDL_Joystick *joystick)
int(* Open)(SDL_Joystick *joystick, int device_index)

References SDL_JoystickDriver::GetDeviceGUID, SDL_JoystickDriver::GetDeviceInstanceID, SDL_JoystickDriver::GetDeviceName, i, NULL, SDL_JoystickDriver::Open, SDL_calloc, SDL_free, SDL_GetDriverAndJoystickIndex(), SDL_IsGameController, SDL_JOYSTICK_POWER_UNKNOWN, SDL_JoystickAxesCenteredAtZero(), SDL_JoystickClose(), SDL_joysticks, SDL_LockJoysticks(), SDL_OutOfMemory, SDL_strdup, SDL_TRUE, SDL_UnlockJoysticks(), and SDL_JoystickDriver::Update.

◆ SDL_JoystickQuit()

void SDL_JoystickQuit ( void  )

Definition at line 697 of file SDL_joystick.c.

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}
#define SDL_DelHintCallback
#define SDL_Delay
#define SDL_DestroyMutex
#define SDL_QuitSubSystem
void SDL_GameControllerQuitMappings(void)
void(* Quit)(void)
static SDL_mutex * mutex
Definition: testlock.c:23

References i, mutex, NULL, SDL_JoystickDriver::Quit, SDL_arraysize, SDL_Delay, SDL_DelHintCallback, SDL_DestroyMutex, SDL_GameControllerQuitMappings(), SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS, SDL_INIT_EVENTS, SDL_joystick_drivers, SDL_joystick_lock, SDL_JoystickAllowBackgroundEventsChanged(), SDL_JoystickClose(), SDL_joysticks, SDL_LockJoysticks(), SDL_QuitSubSystem, SDL_UnlockJoysticks(), and SDL_updating_joystick.

Referenced by SDL_QuitSubSystem().

◆ SDL_JoystickRumble()

int SDL_JoystickRumble ( SDL_Joystick *  joystick,
Uint16  low_frequency_rumble,
Uint16  high_frequency_rumble,
Uint32  duration_ms 
)

Trigger a rumble effect Each call to this function cancels any previous rumble effect, and calling it with 0 intensity stops any rumbling.

Parameters
joystickThe joystick to vibrate
low_frequency_rumbleThe intensity of the low frequency (left) rumble motor, from 0 to 0xFFFF
high_frequency_rumbleThe intensity of the high frequency (right) rumble motor, from 0 to 0xFFFF
duration_msThe duration of the rumble effect, in milliseconds
Returns
0, or -1 if rumble isn't supported on this joystick

Definition at line 631 of file SDL_joystick.c.

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}

References SDL_PrivateJoystickValid().

◆ SDL_JoystickUpdate()

void SDL_JoystickUpdate ( void  )

Update the current state of the open joysticks.

This is called automatically by the event loop if any joystick events are enabled.

Definition at line 1018 of file SDL_joystick.c.

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}
#define SDL_INIT_JOYSTICK
Definition: SDL.h:80
#define SDL_WasInit
void SDL_GameControllerHandleDelayedGuideButton(SDL_Joystick *joystick)
int SDL_PrivateJoystickHat(SDL_Joystick *joystick, Uint8 hat, Uint8 value)
Definition: SDL_joystick.c:890
int SDL_PrivateJoystickAxis(SDL_Joystick *joystick, Uint8 axis, Sint16 value)
Definition: SDL_joystick.c:833
int SDL_PrivateJoystickButton(SDL_Joystick *joystick, Uint8 button, Uint8 state)
Definition: SDL_joystick.c:966
#define SDL_HAT_CENTERED
Definition: SDL_joystick.h:329
void(* Detect)(void)

References SDL_JoystickDriver::Detect, i, SDL_arraysize, SDL_FALSE, SDL_GameControllerHandleDelayedGuideButton(), SDL_HAT_CENTERED, SDL_INIT_JOYSTICK, SDL_joystick_drivers, SDL_JoystickClose(), SDL_joysticks, SDL_LockJoysticks(), SDL_PrivateJoystickAxis(), SDL_PrivateJoystickButton(), SDL_PrivateJoystickHat(), SDL_TRUE, SDL_UnlockJoysticks(), SDL_updating_joystick, and SDL_WasInit.

◆ SDL_LockJoysticks()

void SDL_LockJoysticks ( void  )

Locking for multi-threaded access to the joystick API

If you are using the joystick API or handling events from multiple threads you should use these locking functions to protect access to the joysticks.

In particular, you are guaranteed that the joystick list won't change, so the API functions that take a joystick index will be valid, and joystick and game controller events will not be delivered.

Definition at line 87 of file SDL_joystick.c.

88{
91 }
92}
#define SDL_LockMutex

References SDL_joystick_lock, and SDL_LockMutex.

Referenced by SDL_JoystickClose(), SDL_JoystickFromInstanceID(), SDL_JoystickGetDeviceGUID(), SDL_JoystickGetDeviceIndexFromInstanceID(), SDL_JoystickGetDeviceInstanceID(), SDL_JoystickGetDevicePlayerIndex(), SDL_JoystickNameForIndex(), SDL_JoystickOpen(), SDL_JoystickQuit(), SDL_JoystickUpdate(), and SDL_NumJoysticks().

◆ SDL_NumJoysticks()

int SDL_NumJoysticks ( void  )

Count the number of joysticks attached to the system right now

Definition at line 148 of file SDL_joystick.c.

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}

References SDL_JoystickDriver::GetCount, i, SDL_arraysize, SDL_joystick_drivers, SDL_LockJoysticks(), and SDL_UnlockJoysticks().

Referenced by SDL_JoystickGetDeviceIndexFromInstanceID().

◆ SDL_PrivateJoystickAdded()

void SDL_PrivateJoystickAdded ( SDL_JoystickID  device_instance)

Definition at line 755 of file SDL_joystick.c.

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}
#define SDL_PushEvent
#define SDL_GetEventState(type)
Definition: SDL_events.h:772
int SDL_JoystickGetDeviceIndexFromInstanceID(SDL_JoystickID instance_id)
struct _cl_event * event
General event structure.
Definition: SDL_events.h:558

References SDL_ENABLE, SDL_GetEventState, SDL_JOYDEVICEADDED, SDL_JoystickGetDeviceIndexFromInstanceID(), and SDL_PushEvent.

Referenced by IOS_AddJoystickDevice().

◆ SDL_PrivateJoystickAxis()

int SDL_PrivateJoystickAxis ( SDL_Joystick *  joystick,
Uint8  axis,
Sint16  value 
)

Definition at line 833 of file SDL_joystick.c.

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}
#define SDL_abs
static SDL_bool SDL_PrivateJoystickShouldIgnoreEvent()
Definition: SDL_joystick.c:740
#define SDL_JOYSTICK_AXIS_MAX
Definition: SDL_joystick.h:301
GLsizei const GLfloat * value

References axis, SDL_abs, SDL_ENABLE, SDL_GetEventState, SDL_JOYAXISMOTION, SDL_JOYSTICK_AXIS_MAX, SDL_PrivateJoystickAxis(), SDL_PrivateJoystickShouldIgnoreEvent(), SDL_PushEvent, and SDL_TRUE.

Referenced by IOS_AccelerometerUpdate(), IOS_MFIJoystickUpdate(), SDL_JoystickUpdate(), and SDL_PrivateJoystickAxis().

◆ SDL_PrivateJoystickBall()

int SDL_PrivateJoystickBall ( SDL_Joystick *  joystick,
Uint8  ball,
Sint16  xrel,
Sint16  yrel 
)

Definition at line 930 of file SDL_joystick.c.

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}

References SDL_ENABLE, SDL_GetEventState, SDL_JOYBALLMOTION, SDL_PrivateJoystickShouldIgnoreEvent(), and SDL_PushEvent.

◆ SDL_PrivateJoystickBatteryLevel()

void SDL_PrivateJoystickBatteryLevel ( SDL_Joystick *  joystick,
SDL_JoystickPowerLevel  ePowerLevel 
)

Definition at line 1696 of file SDL_joystick.c.

1697{
1698 joystick->epowerlevel = ePowerLevel;
1699}

◆ SDL_PrivateJoystickButton()

int SDL_PrivateJoystickButton ( SDL_Joystick *  joystick,
Uint8  button,
Uint8  state 
)

Definition at line 966 of file SDL_joystick.c.

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}
#define SDL_RELEASED
Definition: SDL_events.h:49
#define SDL_PRESSED
Definition: SDL_events.h:50

References button, SDL_ENABLE, SDL_GetEventState, SDL_JOYBUTTONDOWN, SDL_JOYBUTTONUP, SDL_PRESSED, SDL_PrivateJoystickShouldIgnoreEvent(), SDL_PushEvent, SDL_RELEASED, and state.

Referenced by IOS_MFIJoystickUpdate(), and SDL_JoystickUpdate().

◆ SDL_PrivateJoystickHat()

int SDL_PrivateJoystickHat ( SDL_Joystick *  joystick,
Uint8  hat,
Uint8  value 
)

Definition at line 890 of file SDL_joystick.c.

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}

References SDL_ENABLE, SDL_GetEventState, SDL_HAT_CENTERED, SDL_JOYHATMOTION, SDL_PrivateJoystickShouldIgnoreEvent(), and SDL_PushEvent.

Referenced by IOS_MFIJoystickUpdate(), and SDL_JoystickUpdate().

◆ SDL_PrivateJoystickRemoved()

void SDL_PrivateJoystickRemoved ( SDL_JoystickID  device_instance)

Definition at line 805 of file SDL_joystick.c.

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}
static void UpdateEventsForDeviceRemoval()
Definition: SDL_joystick.c:780

References SDL_ENABLE, SDL_FALSE, SDL_GetEventState, SDL_JOYDEVICEREMOVED, SDL_joysticks, SDL_PushEvent, SDL_TRUE, and UpdateEventsForDeviceRemoval().

Referenced by IOS_RemoveJoystickDevice().

◆ SDL_PrivateJoystickShouldIgnoreEvent()

static SDL_bool SDL_PrivateJoystickShouldIgnoreEvent ( )
static

Definition at line 740 of file SDL_joystick.c.

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}
#define SDL_GetKeyboardFocus
SDL_bool SDL_HasWindows(void)
Definition: SDL_video.c:1711

References NULL, SDL_FALSE, SDL_GetKeyboardFocus, SDL_HasWindows(), SDL_joystick_allows_background_events, and SDL_TRUE.

Referenced by SDL_PrivateJoystickAxis(), SDL_PrivateJoystickBall(), SDL_PrivateJoystickButton(), and SDL_PrivateJoystickHat().

◆ SDL_PrivateJoystickValid()

int SDL_PrivateJoystickValid ( SDL_Joystick *  joystick)

◆ SDL_ShouldIgnoreJoystick()

SDL_bool SDL_ShouldIgnoreJoystick ( const char *  name,
SDL_JoystickGUID  guid 
)

Definition at line 1359 of file SDL_joystick.c.

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}
SDL_bool SDL_IsGameControllerNameAndGUID(const char *name, SDL_JoystickGUID guid)
SDL_bool SDL_ShouldIgnoreGameController(const char *name, SDL_JoystickGUID guid)
SDL_bool SDL_IsJoystickPS4(Uint16 vendor, Uint16 product)
static SDL_bool SDL_IsPS4RemapperRunning(void)
GLuint id

References i, MAKE_VIDPID, NULL, SDL_arraysize, SDL_FALSE, SDL_GetJoystickGUIDInfo(), SDL_IsGameControllerNameAndGUID(), SDL_IsJoystickPS4(), SDL_IsPS4RemapperRunning(), SDL_ShouldIgnoreGameController(), and SDL_TRUE.

◆ SDL_UnlockJoysticks()

◆ UpdateEventsForDeviceRemoval()

static void UpdateEventsForDeviceRemoval ( )
static

Definition at line 780 of file SDL_joystick.c.

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}
#define SDL_PeepEvents
@ SDL_ADDEVENT
Definition: SDL_events.h:615
@ SDL_PEEKEVENT
Definition: SDL_events.h:616
@ SDL_GETEVENT
Definition: SDL_events.h:617
#define SDL_small_alloc(type, count, pisstack)
Definition: SDL_internal.h:39
#define SDL_small_free(ptr, isstack)
Definition: SDL_internal.h:40
static SDL_Event events[EVENT_BUF_SIZE]
Definition: testgesture.c:39
SDL_JoyDeviceEvent jdevice
Definition: SDL_events.h:573

References events, i, SDL_Event::jdevice, NULL, SDL_ADDEVENT, SDL_GETEVENT, SDL_JOYDEVICEADDED, SDL_PEEKEVENT, SDL_PeepEvents, SDL_small_alloc, SDL_small_free, and SDL_JoyDeviceEvent::which.

Referenced by SDL_PrivateJoystickRemoved().

Variable Documentation

◆ SDL_joystick_allows_background_events

SDL_bool SDL_joystick_allows_background_events = SDL_FALSE
static

◆ SDL_joystick_drivers

◆ SDL_joystick_lock

SDL_mutex* SDL_joystick_lock = NULL
static

◆ SDL_joysticks

◆ SDL_next_joystick_instance_id

SDL_atomic_t SDL_next_joystick_instance_id
static

Definition at line 84 of file SDL_joystick.c.

Referenced by SDL_GetNextJoystickInstanceID().

◆ SDL_updating_joystick

SDL_bool SDL_updating_joystick = SDL_FALSE
static

Definition at line 82 of file SDL_joystick.c.

Referenced by SDL_JoystickClose(), SDL_JoystickQuit(), and SDL_JoystickUpdate().