SDL_HINT_VID...NU_VISIBILITY(3)

πŸ’– SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY(3) πŸ’–

okay bestie, pull up a chair, we're reading a page from the SDL3 FUNCTIONS manual and honestly? it's a little niche but it's giving very specific macOS energy and i'm obsessed πŸ“


✨ NAME ✨

SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY β€” a variable that says how visible the menu is when a window is fullscreen in Spaces on macOS. that's it, that's the whole job πŸŽ€


✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY "SDL_VIDEO_MAC_FULLSCREEN_MENU_VISIBILITY"

no cap, that's the whole incantation πŸͺ„


✨ DESCRIPTION ✨

so the variable can be set to these values, and each one is a whole different vibe:

  • "0" β€” the menu is hidden when the window is in a fullscreen space, and you cannot get to it by moving the mouse to the top of the screen. gone. inaccessible. poof πŸ’€
  • "1" β€” the menu is accessible when the window is in a fullscreen space. it's right there, reachable, thriving πŸ’…
  • "auto" β€” the menu is hidden if fullscreen mode was toggled on programmatically via SDL_SetWindowFullscreen(), and accessible if fullscreen was entered via the "fullscreen" button on the window title bar. this is the default πŸ‘‘
this hint can be set anytime. yes, ANYTIME. no timing stress, no "wait until init", you're free 🌈

✨ AVAILABILITY ✨

this hint has been around since SDL 3.2.0 β€” so if you're on anything older, bestie, it's simply not happening πŸ™ˆ


and that's the whole page!! every flag, every value, every default, all accounted for, nothing skipped, periodt πŸ’œ

this lil love letter to you came from the Simple Directmedia Layer crew, sitting at version SDL 3.4.18 β€” go be the main character of your own fullscreen setup, mwah 🫢✨

πŸ“¦ where this page comes from