SDL_GetWindowFullscreenMode(3)

πŸ’– SDL_GetWindowFullscreenMode(3) πŸ’–

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we answer the question: what display mode is this window gonna use when it goes fullscreen? ✨


🌸 NAME 🌸

SDL_GetWindowFullscreenMode β€” the lil function that queries the display mode to use when a window is visible at fullscreen. πŸ‘‘


✨ SYNOPSIS ✨

#include <SDL3/SDL_video.h>

const SDL_DisplayMode * SDL_GetWindowFullscreenMode(SDL_Window *window);

like. she's simple. she's elegant. she returns a const SDL_DisplayMode *. no cap. πŸŽ€


πŸ¦‹ FUNCTION PARAMETERS πŸ¦‹

  • window β€” the window you wanna query. that's it. that's the whole vibe check. πŸ’…

πŸ’œ RETURN VALUE πŸ’œ

  • Returns a pointer to the exclusive fullscreen mode to use, or NULL for borderless fullscreen desktop mode. 🫢
ngl the NULL case is not an error bestie, it's literally a whole different mode. read the room. 😭

🧚 THREAD SAFETY 🧚

this function should only be called on the main thread. periodt. don't be out here calling it from some random thread, that's giving chaos and we don't do that. πŸ’€


⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0. so if you're on something older… yeah no. upgrade era. 🌈


πŸŽ€ SEE ALSO πŸŽ€

iykyk β€” getters and setters are a matched set, go read the other two. πŸ”₯


mwah πŸ’‹ that's the whole page, and yes it's from Simple Directmedia Layer, SDL 3.4.18, and honestly the date lives in the header where it always does because the footer kept it cute and minimal. go forth and go fullscreen, bestie πŸ¦‹βœ¨πŸ’–

πŸ“¦ where this page comes from