SDL_GetGamepadTouchpadFinger(3)

💖 SDL_GetGamepadTouchpadFinger(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, this one lives in SDL_GetGamepadTouchpadFinger(3) and it's literally the glow-up you need for reading lil fingies on a gamepad touchpad 🫶

---

✨ NAME ✨

SDL_GetGamepadTouchpadFinger — get the current state of a finger on a touchpad on a gamepad. yes. a finger. on a touchpad. on a gamepad. we contain multitudes 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gamepad.h>

bool SDL_GetGamepadTouchpadFinger(SDL_Gamepad *gamepad, int touchpad, int finger, bool *down, float *x, float *y, float *pressure);

look at her. seven params. she's booked and busy ✨

---

🎀 FUNCTION PARAMETERS 🎀

• gamepad — a gamepad. (the whole vibe, the main character, the device we're snooping on 🎮)
• touchpad — a touchpad. (which one, bestie, some gamepads are giving options)
• finger — a finger. (which finger, we don't judge 🙈)
• down — a pointer filled with true if the finger is down, false otherwise, may be NULL. so like... is it touching or not, fr fr
• x — a pointer filled with the x position, normalized 0 to 1, with the origin in the upper left, may be NULL. tiny numbers, huge meaning 💖
• y — a pointer filled with the y position, normalized 0 to 1, with the origin in the upper left, may be NULL. same deal but the other direction 🦋
• pressure — a pointer filled with pressure value, may be NULL. how hard are we pressing, bestie 😭

not me noticing that down, x, y and pressure are all allowed to be NULL — you can lowkey just ask for the one thing you want and ignore the rest, that's iconic of her ngl

---

⭐ RETURN VALUE ⭐

Returns true on success or false on failure; call SDL_GetError() for more information. so if she says false, go ask SDL_GetError() what's wrong, she always spills the tea 🍓

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. every thread. all of them. periodt 👑

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. if you're on something older than that... babe. upgrade. 💀

---

👑 SEE ALSO 👑

• SDL_GetNumGamepadTouchpadFingers(3) — go count how many fingers this touchpad can even track before you start indexing into them, iykyk

---

Simple Directmedia Layer · SDL 3.4.18 · SDL_GetGamepadTouchpadFinger(3) — and that's the whole page bestie, mwah, go read them fingies 💅💖✨