SDL_GetJoyst...sInitialState(3)

✨ NAME ✨

SDL_GetJoystickAxisInitialState — bestie, this is how you get the initial state of an axis control on a joystick 💖

(and yes, this is from the SDL3 FUNCTIONS manual, we're fancy here)

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_joystick.h>

bool SDL_GetJoystickAxisInitialState(SDL_Joystick *joystick, int axis, Sint16 *state);

---

🦋 DESCRIPTION 🦋

okay so the state you get back is a value ranging from -32768 to 32767. that's the whole vibe, full range, no cap 🎀

and the axis indices? they start at index 0. zero-based, like a normal person. periodt.

---

💅 FUNCTION PARAMETERS 💅

• joystick — an SDL_Joystick structure containing joystick information. it's giving "the whole joystick, ma'am" 👑
• axis — the axis to query; the axis indices start at index 0. yes, again, 0. starting from zero, iconic behavior ⭐
• state — upon return, the initial value is supplied here. it's an out-param bestie, so it gets filled in for you 🫶

---

🔥 RETURN VALUE 🔥

Returns true if this axis has any initial value, or false if not. that's it, that's the tea ☕

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. go off, multithreaded queen 👑

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on something older... it's not there, sorry bestie 😭

---

Simple Directmedia Layer ✨ SDL 3.4.18 — mwah, that's a wrap, go read your joystick axes and slay 💜🎀