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