SDL_MinimizeWindow(3)

✨ SDL_MinimizeWindow(3) ✨

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_MinimizeWindow 💅 she's literally just here to shrink your window down to its lil iconic self 🎀

---

🌸 NAME 🌸

SDL_MinimizeWindow — request that the window be minimized to an iconic representation.

like. that's it. that's her job. ✨

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_video.h>

bool SDL_MinimizeWindow(SDL_Window *window);

---

💖 DESCRIPTION 💖

so here's the tea, bestie 🍓: if the window is in a fullscreen state, this request has no direct effect. none. zero. it's giving "asked nicely, got ignored." BUT — and this is the fun part — it may alter the state the window is returned to when leaving fullscreen. so it's not doing nothing, it's just doing something sneaky and future-you-flavored. 🙈

also, on some windowing systems this request is asynchronous, which means the new window state may not have been applied immediately upon the return of this function. yeah. she said "k, done" and then kept working behind your back 😭 if you genuinely need an immediate change, call SDL_SyncWindow() to block until the changes have taken effect. periodt.

and when the window state changes, an SDL_EVENT_WINDOW_MINIMIZED event will be emitted 🔥 note: since this is just a request, the windowing system can straight up deny the state change. not every request gets a yes, and that's the vibe check for you 💀

---

🎀 FUNCTION PARAMETERS 🎀

• window — the window to minimize. that's the one, bestie, that's the target 🫶

---

👑 RETURN VALUE 👑

returns true on success or false on failure 😭 and if it fails, call SDL_GetError() for more information — she'll tell you what went wrong, no cap.

---

🌈 THREAD SAFETY 🌈

this function should only be called on the main thread. no side quests, no background threads sneaking in. main character energy only. ✋

---

⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0. if your SDL is older than that, sorry babe, she doesn't exist yet 💀

---

💜 SEE ALSO 💜

• SDL_MaximizeWindow(3)
• SDL_RestoreWindow(3)
• SDL_SyncWindow(3)

the whole window-state squad, fr fr 🧚

---

Simple Directmedia Layer · SDL 3.4.18 · SDL_MinimizeWindow(3)

and that's the whole page bestie, ty for reading, go minimize something responsibly 💖✨🎀