DOKK / manpages / debian 13 / libsdl3-doc / SDL_GetDesktopDisplayMode.3.en
SDL_GetDesktopDisplayMode(3) SDL3 FUNCTIONS SDL_GetDesktopDisplayMode(3)

SDL_GetDesktopDisplayMode - Get information about the desktop's display mode.

Defined in SDL3/SDL_video.h

#include "SDL3/SDL.h"
const SDL_DisplayMode * SDL_GetDesktopDisplayMode(SDL_DisplayID displayID);

There's a difference between this function and

SDL_GetCurrentDisplayMode () when SDL runs fullscreen and has changed the resolution. In that case this function will return the previous native display mode, and not the current display mode.

the instance ID of the display to query.

(const SDL_DisplayMode
*) Returns a pointer to the desktop display mode or NULL on failure; call

SDL_GetError () for more information.

This function should only be called on the main thread.

This function is available since SDL 3.2.0.

(3), SDL_GetCurrentDisplayMode(3), (3), SDL_GetDisplays(3)

SDL 3.2.10 Simple Directmedia Layer