SDL_GetDisplayForWindow(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

✨ SDL_GetDisplayForWindow ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual 💖 this one's called SDL_GetDisplayForWindow and it's literally here to tell you which display a window is chillin' on. no cap.

🎀 NAME 🎀

SDL_GetDisplayForWindow — get the display associated with a window. periodt.

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_video.h>

SDL_DisplayID SDL_GetDisplayForWindow(SDL_Window *window);

🦋 FUNCTION PARAMETERS 🦋

  • window — the window you wanna query. like, the one you're curious about 👀

💅 RETURN VALUE 💅

on success, it returns the instance ID of the display containing the center of the window. (yes, the center, bestie — that's the vibe check that decides everything ✨)

on failure? it returns 0. and if you're sitting there like "why tho 😭", call SDL_GetError() for more info. she will tell you everything.

🧚 THREAD SAFETY 🧚

this function should only be called on the main thread. do not try her on a side thread, she will not answer. main character energy only, fr fr.

⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0. iconic behavior, honestly.

🔥 SEE ALSO 🔥

Simple Directmedia Layer · SDL 3.4.18 · SDL_GetDisplayForWindow(3) — that's the whole tea, bestie 🫶 go forth and query those displays, you absolute legend 👑💖

📦 where this page comes from