| /* |
| Simple DirectMedia Layer |
| Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org> |
| |
| This software is provided 'as-is', without any express or implied |
| warranty. In no event will the authors be held liable for any damages |
| arising from the use of this software. |
| |
| Permission is granted to anyone to use this software for any purpose, |
| including commercial applications, and to alter it and redistribute it |
| freely, subject to the following restrictions: |
| |
| 1. The origin of this software must not be misrepresented; you must not |
| claim that you wrote the original software. If you use this software |
| in a product, an acknowledgment in the product documentation would be |
| appreciated but is not required. |
| 2. Altered source versions must be plainly marked as such, and must not be |
| misrepresented as being the original software. |
| 3. This notice may not be removed or altered from any source distribution. |
| */ |
| |
| #include "SDL_internal.h" |
| |
| #ifdef SDL_JOYSTICK_EMSCRIPTEN |
| |
| #include <stdio.h> // For the definition of NULL |
| |
| #include "SDL_sysjoystick_c.h" |
| #include "../SDL_joystick_c.h" |
| #include "../usb_ids.h" |
| |
| static SDL_joylist_item *JoystickByIndex(int index); |
| |
| static SDL_joylist_item *SDL_joylist = NULL; |
| static SDL_joylist_item *SDL_joylist_tail = NULL; |
| static int numjoysticks = 0; |
| |
| EM_JS(int, SDL_GetEmscriptenJoystickVendor, (int device_index), { |
| // Let's assume that if we're calling these function then the gamepad object definitely exists |
| let gamepad = navigator['getGamepads']()[device_index]; |
| |
| // Chrome, Edge, Opera: Wireless Controller (STANDARD GAMEPAD Vendor: 054c Product: 09cc) |
| let vendor_str = 'Vendor: '; |
| if (gamepad['id']['indexOf'](vendor_str) > 0) { |
| let vendor_str_index = gamepad['id']['indexOf'](vendor_str) + vendor_str['length']; |
| return parseInt(gamepad['id']['substr'](vendor_str_index, 4), 16); |
| } |
| |
| // Firefox, Safari: 046d-c216-Logitech Dual Action (or 46d-c216-Logicool Dual Action) |
| let id_split = gamepad['id']['split']('-'); |
| if (id_split['length'] > 1 && !isNaN(parseInt(id_split[0], 16))) { |
| return parseInt(id_split[0], 16); |
| } |
| |
| return 0; |
| }); |
| |
| EM_JS(int, SDL_GetEmscriptenJoystickProduct, (int device_index), { |
| let gamepad = navigator['getGamepads']()[device_index]; |
| |
| // Chrome, Edge, Opera: Wireless Controller (STANDARD GAMEPAD Vendor: 054c Product: 09cc) |
| let product_str = 'Product: '; |
| if (gamepad['id']['indexOf'](product_str) > 0) { |
| let product_str_index = gamepad['id']['indexOf'](product_str) + product_str['length']; |
| return parseInt(gamepad['id']['substr'](product_str_index, 4), 16); |
| } |
| |
| // Firefox, Safari: 046d-c216-Logitech Dual Action (or 46d-c216-Logicool Dual Action) |
| let id_split = gamepad['id']['split']('-'); |
| if (id_split['length'] > 1 && !isNaN(parseInt(id_split[1], 16))) { |
| return parseInt(id_split[1], 16); |
| } |
| |
| return 0; |
| }); |
| |
| EM_JS(int, SDL_IsEmscriptenJoystickXInput, (int device_index), { |
| let gamepad = navigator['getGamepads']()[device_index]; |
| |
| // Chrome, Edge, Opera: Xbox 360 Controller (XInput STANDARD GAMEPAD) |
| // Firefox: xinput |
| // TODO: Safari |
| return gamepad['id']['toLowerCase']()['indexOf']('xinput') >= 0; |
| }); |
| |
| static EM_BOOL Emscripten_JoyStickConnected(int eventType, const EmscriptenGamepadEvent *gamepadEvent, void *userData) |
| { |
| SDL_joylist_item *item; |
| int i; |
| Uint16 vendor, product; |
| bool is_xinput; |
| |
| SDL_LockJoysticks(); |
| |
| if (JoystickByIndex(gamepadEvent->index) != NULL) { |
| goto done; |
| } |
| |
| item = (SDL_joylist_item *)SDL_malloc(sizeof(SDL_joylist_item)); |
| if (!item) { |
| goto done; |
| } |
| |
| SDL_zerop(item); |
| item->index = gamepadEvent->index; |
| |
| vendor = SDL_GetEmscriptenJoystickVendor(gamepadEvent->index); |
| product = SDL_GetEmscriptenJoystickProduct(gamepadEvent->index); |
| is_xinput = SDL_IsEmscriptenJoystickXInput(gamepadEvent->index); |
| |
| // Use a generic VID/PID representing an XInput controller |
| if (!vendor && !product && is_xinput) { |
| vendor = USB_VENDOR_MICROSOFT; |
| product = USB_PRODUCT_XBOX360_XUSB_CONTROLLER; |
| } |
| |
| item->name = SDL_CreateJoystickName(vendor, product, NULL, gamepadEvent->id); |
| if (!item->name) { |
| SDL_free(item); |
| goto done; |
| } |
| |
| if (vendor && product) { |
| item->guid = SDL_CreateJoystickGUID(SDL_HARDWARE_BUS_UNKNOWN, vendor, product, 0, NULL, item->name, 0, 0); |
| } else { |
| item->guid = SDL_CreateJoystickGUIDForName(item->name); |
| } |
| |
| if (is_xinput) { |
| item->guid.data[14] = 'x'; // See SDL_IsJoystickXInput |
| } |
| |
| item->mapping = SDL_strdup(gamepadEvent->mapping); |
| if (!item->mapping) { |
| SDL_free(item->name); |
| SDL_free(item); |
| goto done; |
| } |
| |
| const int real_button_count = gamepadEvent->numButtons; |
| const int real_axis_count = gamepadEvent->numAxes; |
| int first_trigger_button = -1; |
| int first_hat_button = -1; |
| int num_buttons = gamepadEvent->numButtons; |
| int num_axes = gamepadEvent->numAxes; |
| bool triggers_are_buttons = false; |
| if ((SDL_strcmp(gamepadEvent->mapping, "standard") == 0) && (num_buttons >= 16)) { // maps to a game console gamepad layout, turn the d-pad into a hat, treat triggers as analog. |
| num_buttons -= 4; // 4 dpad buttons become a hat. |
| first_hat_button = 12; |
| |
| if (num_axes == 4) { // Chrome gives the triggers analog button values, Firefox exposes them as extra axes. Both have the digital buttons. |
| num_axes += 2; // the two trigger "buttons" |
| triggers_are_buttons = true; |
| } |
| |
| // dump the digital trigger buttons in any case. |
| first_trigger_button = 6; |
| num_buttons -= 2; |
| } |
| |
| item->first_hat_button = first_hat_button; |
| item->first_trigger_button = first_trigger_button; |
| item->triggers_are_buttons = triggers_are_buttons; |
| item->nhats = (first_hat_button >= 0) ? 1 : 0; |
| item->naxes = num_axes; |
| item->nbuttons = num_buttons; |
| item->device_instance = SDL_GetNextObjectID(); |
| |
| item->timestamp = gamepadEvent->timestamp; |
| |
| int buttonidx = 0; |
| for (i = 0; i < real_button_count; i++, buttonidx++) { |
| if (buttonidx == first_hat_button) { |
| buttonidx += 4; // skip these buttons, we're treating them as hat input. |
| } else if (buttonidx == first_trigger_button) { |
| buttonidx += 2; // skip these buttons, we're treating them as axes. |
| } |
| item->analogButton[i] = gamepadEvent->analogButton[buttonidx]; |
| item->digitalButton[i] = gamepadEvent->digitalButton[buttonidx]; |
| } |
| |
| for (i = 0; i < real_axis_count; i++) { |
| item->axis[i] = gamepadEvent->axis[i]; |
| } |
| |
| if (item->triggers_are_buttons) { |
| item->axis[real_axis_count] = (gamepadEvent->analogButton[first_trigger_button] * 2.0f) - 1.0f; |
| item->axis[real_axis_count+1] = (gamepadEvent->analogButton[first_trigger_button+1] * 2.0f) - 1.0f; |
| } |
| |
| SDL_assert(item->nhats <= 1); // there is (currently) only ever one of these, faked from the d-pad buttons. |
| if (first_hat_button != -1) { |
| Uint8 value = SDL_HAT_CENTERED; |
| // this currently expects the first button to be up, then down, then left, then right. |
| if (gamepadEvent->digitalButton[first_hat_button + 0]) { |
| value |= SDL_HAT_UP; |
| } |
| if (gamepadEvent->digitalButton[first_hat_button + 1]) { |
| value |= SDL_HAT_DOWN; |
| } |
| if (gamepadEvent->digitalButton[first_hat_button + 2]) { |
| value |= SDL_HAT_LEFT; |
| } |
| if (gamepadEvent->digitalButton[first_hat_button + 3]) { |
| value |= SDL_HAT_RIGHT; |
| } |
| item->hat = value; |
| } |
| |
| if (!SDL_joylist_tail) { |
| SDL_joylist = SDL_joylist_tail = item; |
| } else { |
| SDL_joylist_tail->next = item; |
| SDL_joylist_tail = item; |
| } |
| |
| ++numjoysticks; |
| |
| SDL_PrivateJoystickAdded(item->device_instance); |
| |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Number of joysticks is %d", numjoysticks); |
| #endif |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Added joystick with index %d", item->index); |
| #endif |
| |
| done: |
| SDL_UnlockJoysticks(); |
| |
| return 1; |
| } |
| |
| static EM_BOOL Emscripten_JoyStickDisconnected(int eventType, const EmscriptenGamepadEvent *gamepadEvent, void *userData) |
| { |
| SDL_joylist_item *item = SDL_joylist; |
| SDL_joylist_item *prev = NULL; |
| |
| SDL_LockJoysticks(); |
| |
| while (item) { |
| if (item->index == gamepadEvent->index) { |
| break; |
| } |
| prev = item; |
| item = item->next; |
| } |
| |
| if (!item) { |
| goto done; |
| } |
| |
| if (item->joystick) { |
| item->joystick->hwdata = NULL; |
| } |
| |
| if (prev) { |
| prev->next = item->next; |
| } else { |
| SDL_assert(SDL_joylist == item); |
| SDL_joylist = item->next; |
| } |
| if (item == SDL_joylist_tail) { |
| SDL_joylist_tail = prev; |
| } |
| |
| // Need to decrement the joystick count before we post the event |
| --numjoysticks; |
| |
| SDL_PrivateJoystickRemoved(item->device_instance); |
| |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Removed joystick with id %d", item->device_instance); |
| #endif |
| SDL_free(item->name); |
| SDL_free(item->mapping); |
| SDL_free(item); |
| |
| done: |
| SDL_UnlockJoysticks(); |
| |
| return 1; |
| } |
| |
| // Function to perform any system-specific joystick related cleanup |
| static void EMSCRIPTEN_JoystickQuit(void) |
| { |
| SDL_joylist_item *item = NULL; |
| SDL_joylist_item *next = NULL; |
| |
| for (item = SDL_joylist; item; item = next) { |
| next = item->next; |
| SDL_free(item->mapping); |
| SDL_free(item->name); |
| SDL_free(item); |
| } |
| |
| SDL_joylist = SDL_joylist_tail = NULL; |
| |
| numjoysticks = 0; |
| |
| emscripten_set_gamepadconnected_callback(NULL, 0, NULL); |
| emscripten_set_gamepaddisconnected_callback(NULL, 0, NULL); |
| } |
| |
| // Function to scan the system for joysticks. |
| static bool EMSCRIPTEN_JoystickInit(void) |
| { |
| int rc, i, numjs; |
| EmscriptenGamepadEvent gamepadState; |
| |
| numjoysticks = 0; |
| |
| rc = emscripten_sample_gamepad_data(); |
| |
| // Check if gamepad is supported by browser |
| if (rc == EMSCRIPTEN_RESULT_NOT_SUPPORTED) { |
| return SDL_SetError("Gamepads not supported"); |
| } |
| |
| numjs = emscripten_get_num_gamepads(); |
| |
| // handle already connected gamepads |
| if (numjs > 0) { |
| for (i = 0; i < numjs; i++) { |
| rc = emscripten_get_gamepad_status(i, &gamepadState); |
| if (rc == EMSCRIPTEN_RESULT_SUCCESS) { |
| Emscripten_JoyStickConnected(EMSCRIPTEN_EVENT_GAMEPADCONNECTED, |
| &gamepadState, |
| NULL); |
| } |
| } |
| } |
| |
| rc = emscripten_set_gamepadconnected_callback(NULL, |
| 0, |
| Emscripten_JoyStickConnected); |
| |
| if (rc != EMSCRIPTEN_RESULT_SUCCESS) { |
| EMSCRIPTEN_JoystickQuit(); |
| return SDL_SetError("Could not set gamepad connect callback"); |
| } |
| |
| rc = emscripten_set_gamepaddisconnected_callback(NULL, |
| 0, |
| Emscripten_JoyStickDisconnected); |
| if (rc != EMSCRIPTEN_RESULT_SUCCESS) { |
| EMSCRIPTEN_JoystickQuit(); |
| return SDL_SetError("Could not set gamepad disconnect callback"); |
| } |
| |
| return true; |
| } |
| |
| // Returns item matching given SDL device index. |
| static SDL_joylist_item *JoystickByDeviceIndex(int device_index) |
| { |
| SDL_joylist_item *item = SDL_joylist; |
| |
| while (0 < device_index) { |
| --device_index; |
| item = item->next; |
| } |
| |
| return item; |
| } |
| |
| // Returns item matching given HTML gamepad index. |
| static SDL_joylist_item *JoystickByIndex(int index) |
| { |
| SDL_joylist_item *item = SDL_joylist; |
| |
| if (index < 0) { |
| return NULL; |
| } |
| |
| while (item) { |
| if (item->index == index) { |
| break; |
| } |
| item = item->next; |
| } |
| |
| return item; |
| } |
| |
| static int EMSCRIPTEN_JoystickGetCount(void) |
| { |
| return numjoysticks; |
| } |
| |
| static void EMSCRIPTEN_JoystickDetect(void) |
| { |
| } |
| |
| static bool EMSCRIPTEN_JoystickIsDevicePresent(Uint16 vendor_id, Uint16 product_id, Uint16 version, const char *name) |
| { |
| // We don't override any other drivers |
| return false; |
| } |
| |
| static const char *EMSCRIPTEN_JoystickGetDeviceName(int device_index) |
| { |
| return JoystickByDeviceIndex(device_index)->name; |
| } |
| |
| static const char *EMSCRIPTEN_JoystickGetDevicePath(int device_index) |
| { |
| return NULL; |
| } |
| |
| static int EMSCRIPTEN_JoystickGetDeviceSteamVirtualGamepadSlot(int device_index) |
| { |
| return -1; |
| } |
| |
| static int EMSCRIPTEN_JoystickGetDevicePlayerIndex(int device_index) |
| { |
| return -1; |
| } |
| |
| static void EMSCRIPTEN_JoystickSetDevicePlayerIndex(int device_index, int player_index) |
| { |
| } |
| |
| static SDL_JoystickID EMSCRIPTEN_JoystickGetDeviceInstanceID(int device_index) |
| { |
| return JoystickByDeviceIndex(device_index)->device_instance; |
| } |
| |
| static bool EMSCRIPTEN_JoystickOpen(SDL_Joystick *joystick, int device_index) |
| { |
| SDL_joylist_item *item = JoystickByDeviceIndex(device_index); |
| bool rumble_available = false; |
| |
| if (!item) { |
| return SDL_SetError("No such device"); |
| } |
| |
| if (item->joystick) { |
| return SDL_SetError("Joystick already opened"); |
| } |
| |
| joystick->hwdata = (struct joystick_hwdata *)item; |
| item->joystick = joystick; |
| |
| // HTML5 Gamepad API doesn't offer hats, but we can fake it from the d-pad buttons on the "standard" mapping. |
| joystick->nhats = item->nhats; |
| joystick->nbuttons = item->nbuttons; |
| joystick->naxes = item->naxes; |
| |
| rumble_available = EM_ASM_INT({ |
| let gamepads = navigator['getGamepads'](); |
| if (!gamepads) { |
| return 0; |
| } |
| let gamepad = gamepads[$0]; |
| if (!gamepad || !gamepad['vibrationActuator']) { |
| return 0; |
| } |
| return 1; |
| }, item->index); |
| |
| if (rumble_available) { |
| SDL_SetBooleanProperty(SDL_GetJoystickProperties(joystick), SDL_PROP_JOYSTICK_CAP_RUMBLE_BOOLEAN, true); |
| } |
| |
| return true; |
| } |
| |
| /* Function to update the state of a joystick - called as a device poll. |
| * This function shouldn't update the joystick structure directly, |
| * but instead should call SDL_PrivateJoystick*() to deliver events |
| * and update joystick device state. |
| */ |
| static void EMSCRIPTEN_JoystickUpdate(SDL_Joystick *joystick) |
| { |
| EmscriptenGamepadEvent gamepadState; |
| SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata; |
| int i, result; |
| Uint64 timestamp = SDL_GetTicksNS(); |
| |
| emscripten_sample_gamepad_data(); |
| |
| if (item) { |
| result = emscripten_get_gamepad_status(item->index, &gamepadState); |
| if (result == EMSCRIPTEN_RESULT_SUCCESS) { |
| if (gamepadState.timestamp == 0 || gamepadState.timestamp != item->timestamp) { |
| const int first_hat_button = item->first_hat_button; |
| const int first_trigger_button = item->first_trigger_button; |
| const int real_button_count = gamepadState.numButtons; |
| const int real_axis_count = gamepadState.numAxes; |
| |
| int buttonidx = 0; |
| for (i = 0; i < real_button_count; i++, buttonidx++) { |
| if (buttonidx == first_hat_button) { |
| buttonidx += 4; // skip these buttons, we're treating them as hat input. |
| } else if (buttonidx == first_trigger_button) { |
| buttonidx += 2; // skip these buttons, we're treating them as axes. |
| } |
| if (item->digitalButton[i] != gamepadState.digitalButton[buttonidx]) { |
| const bool down = (gamepadState.digitalButton[buttonidx] != 0); |
| SDL_SendJoystickButton(timestamp, item->joystick, i, down); |
| } |
| |
| // store values to compare them in the next update |
| item->analogButton[i] = gamepadState.analogButton[buttonidx]; |
| item->digitalButton[i] = gamepadState.digitalButton[buttonidx]; |
| } |
| |
| for (i = 0; i < real_axis_count; i++) { |
| if (item->axis[i] != gamepadState.axis[i]) { |
| SDL_SendJoystickAxis(timestamp, item->joystick, i, (Sint16)(32767.0f * gamepadState.axis[i])); |
| item->axis[i] = gamepadState.axis[i]; |
| } |
| } |
| |
| if (item->triggers_are_buttons) { |
| for (i = 0; i < 2; i++) { |
| if (item->axis[real_axis_count+i] != gamepadState.analogButton[first_trigger_button+i]) { |
| SDL_SendJoystickAxis(timestamp, item->joystick, real_axis_count+i, (Sint16)(32767.0f * ((gamepadState.analogButton[first_trigger_button+i] * 2.0f) - 1.0f))); |
| item->axis[real_axis_count+i] = gamepadState.analogButton[first_trigger_button+i]; |
| } |
| } |
| } |
| |
| SDL_assert(item->nhats <= 1); // there is (currently) only ever one of these, faked from the d-pad buttons. |
| if (item->nhats) { |
| Uint8 value = SDL_HAT_CENTERED; |
| // this currently expects the first button to be up, then down, then left, then right. |
| if (gamepadState.digitalButton[first_hat_button + 0]) { |
| value |= SDL_HAT_UP; |
| } else if (gamepadState.digitalButton[first_hat_button + 1]) { |
| value |= SDL_HAT_DOWN; |
| } |
| if (gamepadState.digitalButton[first_hat_button + 2]) { |
| value |= SDL_HAT_LEFT; |
| } else if (gamepadState.digitalButton[first_hat_button + 3]) { |
| value |= SDL_HAT_RIGHT; |
| } |
| if (item->hat != value) { |
| item->hat = value; |
| SDL_SendJoystickHat(timestamp, item->joystick, 0, value); |
| } |
| } |
| |
| |
| item->timestamp = gamepadState.timestamp; |
| } |
| } |
| } |
| } |
| |
| // Function to close a joystick after use |
| static void EMSCRIPTEN_JoystickClose(SDL_Joystick *joystick) |
| { |
| SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata; |
| if (item) { |
| item->joystick = NULL; |
| } |
| } |
| |
| static SDL_GUID EMSCRIPTEN_JoystickGetDeviceGUID(int device_index) |
| { |
| return JoystickByDeviceIndex(device_index)->guid; |
| } |
| |
| static bool EMSCRIPTEN_JoystickRumble(SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble) |
| { |
| SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata; |
| |
| // clang-format off |
| bool result = EM_ASM_INT({ |
| let gamepads = navigator['getGamepads'](); |
| if (!gamepads) { |
| return 0; |
| } |
| let gamepad = gamepads[$0]; |
| if (!gamepad || !gamepad['vibrationActuator']) { |
| return 0; |
| } |
| |
| gamepad['vibrationActuator']['playEffect']('dual-rumble', { |
| 'startDelay': 0, |
| 'duration': 3000, |
| 'weakMagnitude': $1 / 0xFFFF, |
| 'strongMagnitude': $2 / 0xFFFF, |
| }); |
| return 1; |
| }, item->index, low_frequency_rumble, high_frequency_rumble); |
| |
| return result; |
| } |
| |
| static bool EMSCRIPTEN_JoystickRumbleTriggers(SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static bool EMSCRIPTEN_JoystickGetGamepadMapping(int device_index, SDL_GamepadMapping *out) |
| { |
| return false; |
| } |
| |
| static bool EMSCRIPTEN_JoystickSetLED(SDL_Joystick *joystick, Uint8 red, Uint8 green, Uint8 blue) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static bool EMSCRIPTEN_JoystickSendEffect(SDL_Joystick *joystick, const void *data, int size) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static bool EMSCRIPTEN_JoystickSetSensorsEnabled(SDL_Joystick *joystick, bool enabled) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| SDL_JoystickDriver SDL_EMSCRIPTEN_JoystickDriver = { |
| EMSCRIPTEN_JoystickInit, |
| EMSCRIPTEN_JoystickGetCount, |
| EMSCRIPTEN_JoystickDetect, |
| EMSCRIPTEN_JoystickIsDevicePresent, |
| EMSCRIPTEN_JoystickGetDeviceName, |
| EMSCRIPTEN_JoystickGetDevicePath, |
| EMSCRIPTEN_JoystickGetDeviceSteamVirtualGamepadSlot, |
| EMSCRIPTEN_JoystickGetDevicePlayerIndex, |
| EMSCRIPTEN_JoystickSetDevicePlayerIndex, |
| EMSCRIPTEN_JoystickGetDeviceGUID, |
| EMSCRIPTEN_JoystickGetDeviceInstanceID, |
| EMSCRIPTEN_JoystickOpen, |
| EMSCRIPTEN_JoystickRumble, |
| EMSCRIPTEN_JoystickRumbleTriggers, |
| EMSCRIPTEN_JoystickSetLED, |
| EMSCRIPTEN_JoystickSendEffect, |
| EMSCRIPTEN_JoystickSetSensorsEnabled, |
| EMSCRIPTEN_JoystickUpdate, |
| EMSCRIPTEN_JoystickClose, |
| EMSCRIPTEN_JoystickQuit, |
| EMSCRIPTEN_JoystickGetGamepadMapping |
| }; |
| |
| #endif // SDL_JOYSTICK_EMSCRIPTEN |