logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_SetWindowFullscreenMode - Set the display mode to use when a window is visible and fullscreen.

Availability

       This function is available since SDL 3.2.0.

Description

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

       If  the  window  is  currently  in  the  fullscreen state, this request is asynchronous on some windowing
       systems and the new mode dimensions may not be applied immediately upon the return of this  function.  If
       an immediate change is required, call SDL_SyncWindow() to block until the changes have taken effect.

       When the new mode takes effect, an SDL_EVENT_WINDOW_RESIZED and/or an SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED
       event will be emitted with the new mode dimensions.

Function Parameters

window the window to affect.

       mode   a pointer to the display mode to use, which can be NULL for borderless fullscreen desktop mode, or
              one  of  the  fullscreen  modes  returned  by  SDL_GetFullscreenDisplayModes() to set an exclusive
              fullscreen mode.

Name

       SDL_SetWindowFullscreenMode - Set the display mode to use when a window is visible and fullscreen.

Return Value

       for more information.

See Also

SDL_GetWindowFullscreenMode(3), SDL_SetWindowFullscreen(3), SDL_SyncWindow(3)

Simple Directmedia Layer                           SDL 3.2.20                     SDL_SetWindowFullscreenMode(3)

Synopsis

#include<SDL3/SDL_video.h>boolSDL_SetWindowFullscreenMode(SDL_Window*window,constSDL_DisplayMode*mode);

Thread Safety

       This function should only be called on the main thread.

See Also