SDL_GetCurrentDisplayMode
Use this function to get information about the current display mode.
Contents
Syntax
int SDL_GetCurrentDisplayMode(int displayIndex,
SDL_DisplayMode* mode)
Function Parameters
displayIndex |
the index of the display to query |
mode |
an SDL_DisplayMode structure filled in with the current display mode |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
// Using SDL2's SDL_GetCurrentDisplayMode()
#include "SDL.h"
int main(int argc, char* argv[])
{
int i;
// Declare display mode structure to be filled in.
SDL_DisplayMode current;
SDL_Init(SDL_INIT_VIDEO);
// Get current display mode of all displays.
for(i = 0; i < SDL_GetNumVideoDisplays(); ++i){
int should_be_zero = SDL_GetCurrentDisplayMode(i, ¤t);
if(should_be_zero != 0)
// In case of error...
SDL_Log("Could not get display mode for video display #%d: %s", i, SDL_GetError());
else
// On success, print the current display mode.
SDL_Log("Display #%d: current display mode is %dx%dpx @ %dhz.", i, current.w, current.h, current.refresh_rate);
}
// Clean up and exit the program.
SDL_Quit();
return 0;
}
Remarks
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.
