SDL_GamepadAxis(3type)

✨ SDL_GamepadAxis(3type) ✨

okay bestie, gather round 💖 this one lives in the SDL3 DATATYPES corner of the SDL_GamepadAxis(3type) manual, and it's literally just the glow-up list of every axis a gamepad can have. no cap.

---

🌸 NAME 🌸

SDL_GamepadAxis — the list of axes available on a gamepad 🎮✨

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_gamepad.h>

typedef enum SDL_GamepadAxis
{
    SDL_GAMEPAD_AXIS_INVALID = -1,
    SDL_GAMEPAD_AXIS_LEFTX,
    SDL_GAMEPAD_AXIS_LEFTY,
    SDL_GAMEPAD_AXIS_RIGHTX,
    SDL_GAMEPAD_AXIS_RIGHTY,
    SDL_GAMEPAD_AXIS_LEFT_TRIGGER,
    SDL_GAMEPAD_AXIS_RIGHT_TRIGGER,
    SDL_GAMEPAD_AXIS_COUNT
} SDL_GamepadAxis;

look at her. an icon. an enum. 💅 every single value is right there, exactly as written, don't you dare rename any of them.

---

💜 DESCRIPTION 💜

so the thumbstick axes? their values range from SDL_JOYSTICK_AXIS_MIN to SDL_JOYSTICK_AXIS_MAX, and they're centered within about ~8000 of zero. that wiggle room around zero is a whole thing, okay — advanced UI will let users set or autodetect the dead zone, and ngl that dead zone varies between gamepads, every single one is a little different 🙈

and the trigger axes? those go from 0 (released, not pressed, chilling) up to SDL_JOYSTICK_AXIS_MAX (fully pressed, going feral) — but ONLY when they're reported by SDL_GetGamepadAxis(). ⚠️

bestie listen. that is NOT the same range you'll get from the lower-level SDL_GetJoystickAxis(). different function, different numbers. do not mix them up, i am begging 🫶

---

⭐ AVAILABILITY ⭐

this enum has been available since SDL 3.2.0. periodt. 👑

---

and that's the whole vibe check 🧚 from the fine folks at Simple Directmedia Layer, this is the SDL 3.4.18 era, page SDL_GamepadAxis(3type) — go forth and read your axes responsibly, mwah 💖🎀🍓