GLUTICONIFYWINDOW(3)

✨ NAME ✨

ok so this is glutIconifyWindow — the OpenGLUT bestie that iconifies your current window 💅

📚 LIBRARY 📚

OpenGLUT — window stuff 🪟✨

🎀 SYNOPSIS 🎀

#include <openglut.h>

void
glutIconifyWindow(void);

like. that's it. no args. no return value. she just does it 🫶

💖 DESCRIPTION 💖

okay so listen. almost every window system out there has some kind of "minimized" or "iconified" state, right? and every single system OpenGLUT currently supports has one. yes, all of them. no cap.

what iconification actually means is a lil bit system-dependent — like, it's giving "depends on the vibe of your OS" — but what this function does is send a request to the window system asking it to pls put your window into that state 🙏

when a window is iconified, graphic output is usually suspended. and user input? may be partially or wholly suspended. so like, don't expect your rendering loop to keep popping off 😭

now here's the important part bestie. if and when your window gets iconified by the window system, the system can uniconify it at literally any time. usually that happens because the user asked for it. which means — and I need you to hear me on this — do NOT use this function to hide a window. that's not what she's for!! she's here to help unclutter the user's display, and she's more or less consensual with the user. if you genuinely want the window gone-gone, use glutHideWindow() instead. periodt. 💀

🚨 CAVEATS 🚨

okay so the receipts, because you know I keep them:

• Applies only to onscreen, top-level windows. don't get cute with it elsewhere.
• Not guaranteed to have any effect — and the effect may be arbitrarily delayed. she said "request", not "promise" 🙈
• there is no callback that specifically tells you when (or if) your window is iconified. so like. you just won't know. that's the deal. 🧚

👀 SEE ALSO 👀

• glutSetIconTitle(3)
• glutHideWindow(3)
• glutShowWindow(3)

go read those too, iykyk 🌸

so this page is UNDATED and comes to you from UNTITLED() — yeah the version/date situation is a whole mystery, no one's claiming it, it's giving anonymous baddie energy 💅✨ slay, go iconify something 🦋