Wiki Page Content

Differences between revisions 12 and 13
Revision 12 as of 2013-07-26 15:35:30
Size: 1151
Editor: axper
Revision 13 as of 2014-06-22 07:49:25
Size: 1271
Editor: dthree
Comment: Is my format string redundant?
Deletions are marked like this. Additions are marked like this.
Line 24: Line 24:
You can add your code example here SDL_DisplayMode dm;
if (SDL_GetDesktopDisplayMode(0, &dm) != 0) {
    SDL_Log("SDL_GetDesktopDisplayMode failed: %s", SDL_GetError());
    return 1;


Use this function to get information about the desktop display mode.


int SDL_GetDesktopDisplayMode(int              displayIndex,
                              SDL_DisplayMode* mode)

Function Parameters


the index of the display to query


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

SDL_DisplayMode dm;
if (SDL_GetDesktopDisplayMode(0, &dm) != 0) {
    SDL_Log("SDL_GetDesktopDisplayMode failed: %s", SDL_GetError());
    return 1;


There's a difference between this function and SDL_GetCurrentDisplayMode when SDL runs fullscreen and has changed the resolution. In that case this function will return the previous native display mode, and not the current display mode.

CategoryAPI, CategoryVideo

None: SDL_GetDesktopDisplayMode (last edited 2014-06-22 11:22:22 by PhilippWiesemann)

Please include your contact information if you'd like to receive a reply.