NAME¶

SDL_GetCurrentDisplayMode - Get information about the current display mode.

SYNOPSIS¶

#include <SDL3/SDL_video.h>

const SDL_DisplayMode * SDL_GetCurrentDisplayMode(SDL_DisplayID displayID);

DESCRIPTION¶

There's a difference between this function and SDL_GetDesktopDisplayMode() when SDL runs fullscreen and has changed the resolution. In that case this function will return the current display mode, and not the previous native display mode.

FUNCTION PARAMETERS¶

displayID

the instance ID of the display to query.

RETURN VALUE¶

Returns a pointer to the desktop display mode or NULL on failure; call SDL_GetError() for more information.

THREAD SAFETY¶

This function should only be called on the main thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_GetDesktopDisplayMode(3), SDL_GetDisplays(3)