SDL_JoyButtonEvent(3type)

✨ SDL_JoyButtonEvent ✨

okay bestie, welcome to the SDL_JoyButtonEvent page 💖 this is a SDL3 DATATYPES situation, and it's literally the joystick button event structure — you'll find it chilling under event.jbutton.* 🎮

---

🌸 NAME 🌸

SDL_JoyButtonEvent — the joystick button event structure (aka event.jbutton.*) 👑

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_events.h>

typedef struct SDL_JoyButtonEvent
{
    SDL_EventType type; /**< SDL_EVENT_JOYSTICK_BUTTON_DOWN or SDL_EVENT_JOYSTICK_BUTTON_UP */
    Uint32 reserved;
    Uint64 timestamp;   /**< In nanoseconds, populated using SDL_GetTicksNS() */
    SDL_JoystickID which; /**< The joystick instance id */
    Uint8 button;       /**< The joystick button index */
    bool down;      /**< true if the button is pressed */
    Uint8 padding1;
    Uint8 padding2;
} SDL_JoyButtonEvent;

---

💅 DESCRIPTION 💅

so like, picture this: somebody smashes a button on their joystick and SDL is like "noted 📝" and hands you one of these bad boys. no cap, that's the whole vibe.

let's do a little field-by-field vibe check, shall we? 🧚

• type — an SDL_EventType, and it's either SDL_EVENT_JOYSTICK_BUTTON_DOWN or SDL_EVENT_JOYSTICK_BUTTON_UP. that's it, those are the only two options, periodt 💀
• reserved — a Uint32 just sitting there. reserved. do not perceive it 🙈
• timestamp — a Uint64, measured in nanoseconds, populated using SDL_GetTicksNS(). so you know exactly when the button got pressed, down to the nanosecond, main character energy fr fr ⏱️
• which — an SDL_JoystickID, the joystick instance id. which joystick was it? this field knows 🔥
• button — a Uint8, the joystick button index. which button? this field knows too 👑
• down — a bool, true if the button is pressed. iconic behaviour honestly 💖
• padding1 — a Uint8. padding. yes bestie, the name is the whole description 🎀
• padding2 — a Uint8. padding's sequel. the way that struct alignment needs it... iykyk ✨

lowkey important: reserved, padding1 and padding2 are not for you. they exist so the struct lines up nicely. leave them alone bestie 🫶

---

🌈 AVAILABILITY 🌈

this struct has been around since SDL 3.2.0 — so if you're on 3.2.0 or later, she's available and she's serving 🫶

---

and that's the whole page, you ate that 🍓 go forth and handle your joystick buttons with confidence, bestie. no notes. 💜

this lil' datatype page comes from Simple Directmedia Layer, version SDL 3.4.18 — mwah, slay, bye 👋✨