#pragma section-numbers off
#pragma disable-camelcase

= SDL_SetWindowDisplayMode =
Use this function to set the display mode to use when a window is visible at fullscreen.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_SetWindowDisplayMode(SDL_Window*            window,
                             const SDL_DisplayMode* mode)
}}}

== 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.

== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

== 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]]().

== Related Functions ==
 .[[SDL_GetWindowDisplayMode]]
 .[[SDL_SetWindowFullscreen]]

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