ALLEGRO_JOYSTICK_STATE(3alleg5)

💖 NAME 💖

ALLEGRO_JOYSTICK_STATE — it's the Allegro 5 API bestie, and this one is literally just a lil container for "what is my joystick doing rn" 🎮✨

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;

okay so first thing, you gotta pull in the header with that #include, and then boom — ALLEGRO_JOYSTICK_STATE is a typedef'd struct, that's the whole vibe 🫶

---

🦋 DESCRIPTION 🦋

So like. This struct is the snapshot machine 📸 — it holds a picture of a joystick's axes and buttons at one particular instant. Not a live feed, not a stream, just a frozen lil moment, iykyk.

⚠️ Every single field in here is public and read-only. You look, you do not touch, periodt 💅

Here's the shape of it, verbatim:

struct {
   float axis[num_axes];             // -1.0 to 1.0
} stick[num_sticks];
int button[num_buttons];             // 0 to 32767

So you got your stick array, one entry per stick, num_sticks of them 🕹️ and each one carries axis[num_axes] — those are floats running from -1.0 to 1.0, that's the full range, no cap fr.

Then there's button[num_buttons] — plain old ints, and they run from 0 to 32767 🔥 (yes that's the documented range, don't come for me, it's in the source of truth).

That's it. That's the struct. Lowkey elegant, highkey useful 💜

---

✨ SEE ALSO ✨

• al_get_joystick_state(3alleg5) — the bestie that actually hands you one of these snapshots 👑

---

and that's the whole page, bestie!! 🎀 this came straight out of the Allegro reference manual, filed under ALLEGRO_JOYSTICK_STATE(3alleg5) — go forth and read those axes responsibly 🧚🌈⭐