SDL_HINT_GDK_TEXTINPUT_DESCRIPTION(3)

💖 SDL_HINT_GDK_TEXTINPUT_DESCRIPTION 💖

okay bestie, so this is a page from the SDL3 manual — the FUNCTIONS corner of it, specifically — and today's main character is a hint called SDL_HINT_GDK_TEXTINPUT_DESCRIPTION. she's lowkey niche but she's iconic. let's get into it ✨

---

✨ NAME ✨

SDL_HINT_GDK_TEXTINPUT_DESCRIPTION — this variable sets the description of the TextInput window on GDK platforms. that's it, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

like, literally just this:

#include <SDL3/SDL_hints.h>

#define SDL_HINT_GDK_TEXTINPUT_DESCRIPTION "SDL_GDK_TEXTINPUT_DESCRIPTION"

no cap, that's the entire flex. 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — this hint is available only if SDL_GDK_TEXTINPUT is defined. if that macro isn't defined, bestie, she simply does not exist. no SDL_GDK_TEXTINPUT, no hint. periodt.

and also 👑: this hint should be set before calling SDL_StartTextInput(). like, before before. set it first, then call. the order matters, iykyk. not me stressing about timing but here we are 😭

---

🌈 AVAILABILITY 🌈

this hint has been available since SDL 3.2.0. she's been out here slaying since 3.2.0 and honestly? we're obsessed. 💖

---

and that's the whole page, bestie!! 🎀 this one came straight outta the Simple Directmedia Layer docs, SDL 3.4.18 era, and the page itself goes by SDL_HINT_GDK_...T_DESCRIPTION(3). mwah, go set your hint before you start your text input, and stay gorgeous 💅💜🦋✨