SDL_GamepadAxisEvent(3type)

💖 NAME 💖

okay so bestie, welcome to the SDL3 DATATYPES section of the manual, and today's main character is SDL_GamepadAxisEvent — the gamepad axis motion event structure, aka everything hiding under event.gaxis.*. 🎮✨

Like. When your controller's stick goes wiggle, this is the struct that shows up at the function. It's giving "your thumb moved and the whole system needs to know." 💅

---

✨ SYNOPSIS ✨

grab your include, babe:

#include <SDL3/SDL_events.h>

typedef struct SDL_GamepadAxisEvent
{
    SDL_EventType type; /**< SDL_EVENT_GAMEPAD_AXIS_MOTION */
    Uint32 reserved;
    Uint64 timestamp;   /**< In nanoseconds, populated using SDL_GetTicksNS() */
    SDL_JoystickID which; /**< The joystick instance id */
    Uint8 axis;         /**< The gamepad axis (SDL_GamepadAxis) */
    Uint8 padding1;
    Uint8 padding2;
    Uint8 padding3;
    Sint16 value;       /**< The axis value (range: -32768 to 32767) */
    Uint16 padding4;
} SDL_GamepadAxisEvent;

---

🦋 let's break down the fit (the struct, bestie) 🦋

Every single member, no gatekeeping:

• SDL_EventType type — this is the event type field, and for this struct it's SDL_EVENT_GAMEPAD_AXIS_MOTION. that's the whole vibe check right there.
• Uint32 reserved — reserved. don't touch it, don't look at it, it's not for you. 🙈
• Uint64 timestamp — in nanoseconds, populated using SDL_GetTicksNS(). so like, when did this happen, down to the nanosecond. icon behavior honestly.
• SDL_JoystickID which — the joystick instance id. which controller said that. 👑
• Uint8 axis — the gamepad axis, of type SDL_GamepadAxis. which stick, which trigger, you know the drill.
• Uint8 padding1, Uint8 padding2, Uint8 padding3 — padding. three of them. they are padding. that's the whole job. ✨
• Sint16 value — the axis value, with range: -32768 to 32767. that's the actual movement, the numbers, the drama.
• Uint16 padding4 — one more padding. a little encore. 🎀

no cap: the padding1–padding4 fields and reserved are just there — don't go reading meaning into them, they're not the moment.

---

🌸 AVAILABILITY 🌸

This struct is available since SDL 3.2.0. so if you're on something older... bestie. 😭 upgrade.

---

🫶 that's the whole page 🫶

and that's it, that's the struct, you ate. 💅

mwah — brought to you by Simple Directmedia Layer, version SDL 3.4.18. go make something iconic with it. 🌈⭐💜