====== (This is the documentation for SDL3, which is under heavy development and the API is changing! [https://wiki.libsdl.org/SDL2/ SDL2] is the current stable version!) ======
= SDL_SetWindowDisplayMode =

Set the display mode to use when a window is visible at fullscreen.

== Syntax ==

<syntaxhighlight lang='c'>
int SDL_SetWindowDisplayMode(SDL_Window *window, const SDL_DisplayMode *mode);
</syntaxhighlight>

== Function Parameters ==

{|
|'''window'''
|the window to affect
|-
|'''mode'''
|the [[SDL_DisplayMode]] structure representing the mode to use, or NULL to use the window's dimensions and the desktop's format and refresh rate
|}

== Return Value ==

Returns 0 on success or a negative error code on failure; call
[[SDL_GetError]]() for more information.

== Remarks ==

This only affects the display mode used when the window is fullscreen. To
change the window size when the window is not fullscreen, use
[[SDL_SetWindowSize]]().

== Version ==

This function is available since SDL 3.0.0.

== Related Functions ==

:[[SDL_GetWindowDisplayMode]]
:[[SDL_SetWindowFullscreen]]

----
[[CategoryAPI]], [[CategoryVideo]]