Introduce new joypad features provided by SDL3 (WIP)

[Nintorch]

Partially based on #88590

Closes godotengine/godot-proposals#2829
Closes godotengine/godot-proposals#8519
Closes godotengine/godot-proposals#6930
Closes godotengine/godot-proposals#3799
Potentially closes #98008

Supersedes #88590
Supersedes #89193

Since SDL joypad driver was merged recently ( #106218 ), this PR adds support for new SDL joypad features that weren't previously possible due to older custom joypad implementations. These features include accelerometer, gyroscope, LED lights, touchpads and more.

The features that need to be done before this PR is ready for review/merge, i.e. the roadmap:

• Accelerometer/gyroscope enabling and getting
• SDL_GamepadHasSensor
• SDL_SetGamepadLED
• SDL_GetGamepadStringForAxis and SDL_GetGamepadStringForButton
• Input.get_joy_model() (because JoyType enum already exists) and Input.get_joy_scheme() (see SDL_GetGamepadType)
• SDL_GetGamepadPowerInfo
• SDL_GetGamepadSensorDataRate
• SDL_GetGamepadConnectionState
• SDL_JoystickType
• SDL_GetNumJoystickButtons, SDL_GetNumJoystickAxes
• SDL_GetJoystickVendor, SDL_GetJoystickProduct for Input.get_joy_info() (see Get joypad's vendor ID, product ID and name on Windows for XInput devices. #98861 )
• Touchpad functions
• Dualsense adaptive triggers (see Any plans on Dualsense adaptive trigger support? libsdl-org/SDL#5125 and Xbox One Trigger Impulse via the Widnows Runtime API libsdl-org/SDL#4859 (comment) )
• • https://github.com/ValveSoftware/Proton/blob/ea07c02886cd1b1527761fb2222538fb9a92af33/lsteamclient/steamworks_sdk_157/isteamdualsense.h
• • I can't test it myself, because I don't have a Dualsense
• Xbox rumble triggers support
• Make sure Joycons work properly, including accelerometer and gyroscope
• Separate JoyScheme entry for horizontal joycons and fix the names for face buttons
• Godot events for accelerometer/gyroscope (InputEventJoypadAccelerometer, InputEventJoypadGyroscope)
• Touchpad events
• Battery/power events
• Accelerometer/gyroscope calibration methods (Input.start_joy_motion_calibration(), Input.step_joy_motion_calibration(), Input.stop_joy_motion_calibration())
• Make all of the code thread safe, if it's not already (see bruvzg's PR)
• Linux support
• macOS support
• Add new files to the SDL update script
• Documentation with examples
• • Documentation for joypad device types (SDL_JoystickType): https://learn.microsoft.com/en-us/windows/win32/xinput/xinput-and-controller-subtypes
• • Input.get_joy_info() fields

TODO when Godot starts supporting SDL for other platforms:

• Android support
• iOS support
• Web support?

TODO for separate PRs:

• Rework Godot's hat functionality (at the moment it only supports 1 hat) (also see Hats on HOTAS are mapped as d-pad #83322 and HOTAS Problem (some axes and buttons not recognized) and godot closing on remove joy mapping (Thrustmaster TWCS Trottle) #65330 ), SDL_GetNumJoystickHats
• Input.get_pov_hat_vector() (see Add InputEventJoypadHat godot-proposals#9850 )
• SDL_GetJoystickBall, SDL_GetNumJoystickBalls
• Hat (see Add InputEventJoypadHat godot-proposals#9850 ) and ball events
• Add new hat and ball functionality to InputMap
• Proper Joycon support?
• Fix potential memory leak in Input.get_joy_name()

Features that need to be discussed whether they should be implemented or not:

• SDL_GetJoystickSerial
• SDL_GetJoystickFirmwareVersion
• SDL_GetGamepadPath
• SDL_GetGamepadSteamHandle (for https://godotsteam.com/classes/input/ ?)
• Input.send_joy_packet() SDL_SendJoystickEffect

Here's a small project to test new joypad features (in case someone might build this WIP PR from scratch) :
JoypadTest.zip

(P.S. I opened this PR so early, because I want to let people know that this is being worked on and that I'm working on it :D)

[Calinou]

Supersedes #88590

Note that #88590 also implements DualSense adaptive triggers, which isn't on the roadmap of this PR currently. This could be done in a separate PR in any case, but I thought I'd mention it as SDL supports adaptive triggers.

[Nintorch]

Supersedes #88590

Note that #88590 also implements DualSense adaptive triggers, which isn't on the roadmap of this PR currently. This could be done in a separate PR in any case, but I thought I'd mention it as SDL supports adaptive triggers.

Good catch, thank you, I'll add that to the roadmap!

[Meorge]

I'm especially excited to see Joy-Con support listed here. I think those are really fun little controllers, so much so that I started making my own C++ library for interfacing with them and a Godot GDExtension based off of that - however, obviously being a GDExtension, it doesn't mesh very well with Godot's built-in APIs. Having the support be more built-in to the engine would be awesome!

I'm not sure how much overlap there is between SDL's Joy-Con support and what my library does, but if a lot of the Joy-Con-specific features don't have SDL APIs, I may be able to help on that front 😄

[Nintorch]

I made a list of features that need discussion before implementing, so if you think any of the listed features are important to have built into the engine, you can let me know!

[mubinulhaque]

Feature request for a separate PR: querying for separate keyboards and mice (SDL_GetKeyboards and SDL_GetMice respectively)

[Calinou]

Feature request for a separate PR: querying for separate keyboards and mice (SDL_GetKeyboards and SDL_GetMice respectively)

Multi-keyboard/mouse support seems subpar in SDL 3 from what I've heard, so it may not be worth the effort. This is based on what I've seen in the Perfect Dark PC port Discord (people have tried implementing it there, but quickly regretted it).

[LunaCapra]

Will the gamepad type for GameCube controllers be included? It seems to be the only one not added from SDL_GamepadType.

[Meorge]

I'm still very excited for Joy-Con support and would love to contribute where I can, but thinking about it more, I think specialized support for its features would fit better as a separate PR (if not some kind of plugin/addon). 😅

Maintainers should have more of a say in this of course, but I could see it being helpful to split this up into multiple smaller PRs so that each individual one is easier to test and verify.

That all being said, for this PR (whether it ends up being split later or not) I can certainly test its functionality on macOS. Let me know if/when you'd like me to give that a shot! 😄

[Nintorch]

Will the gamepad type for GameCube controllers be included? It seems to be the only one not added from SDL_GamepadType.

Godot is currently using the latest stable release of SDL (3.2.16), which doesn't support GameCube controllers :( https://github.com/libsdl-org/SDL/blob/c9a6709bd21750f1ad9597be21abace78c6378c9/include/SDL3/SDL_gamepad.h

[LunaCapra]

Will the gamepad type for GameCube controllers be included? It seems to be the only one not added from SDL_GamepadType.

Godot is currently using the latest stable release of SDL (3.2.16), which doesn't support GameCube controllers :( https://github.com/libsdl-org/SDL/blob/c9a6709bd21750f1ad9597be21abace78c6378c9/include/SDL3/SDL_gamepad.h

That's a shame. Maybe in the future then!