include/SDL_video.h
changeset 10019 36f7e8084508
parent 10010 cc07869515b2
child 10021 3beca914a2ad
     1.1 --- a/include/SDL_video.h	Wed Apr 22 16:50:48 2015 -0400
     1.2 +++ b/include/SDL_video.h	Mon Jan 04 23:52:40 2016 -0500
     1.3 @@ -312,6 +312,25 @@
     1.4  extern DECLSPEC int SDLCALL SDL_GetDisplayDPI(int displayIndex, float * ddpi, float * hdpi, float * vdpi);
     1.5  
     1.6  /**
     1.7 + *  \brief Get the usable desktop area represented by a display, with the
     1.8 + *         primary display located at 0,0
     1.9 + *
    1.10 + *  This is the same area as SDL_GetDisplayBounds() reports, but with portions
    1.11 + *  reserved by the system removed. For example, on Mac OS X, this subtracts
    1.12 + *  the area occupied by the menu bar and dock.
    1.13 + *
    1.14 + *  Setting a window to be fullscreen generally bypasses these unusable areas,
    1.15 + *  so these are good guidelines for the maximum space available to a
    1.16 + *  non-fullscreen window.
    1.17 + *
    1.18 + *  \return 0 on success, or -1 if the index is out of range.
    1.19 + *
    1.20 + *  \sa SDL_GetDisplayBounds()
    1.21 + *  \sa SDL_GetNumVideoDisplays()
    1.22 + */
    1.23 +extern DECLSPEC int SDLCALL SDL_GetDisplayUsableBounds(int displayIndex, SDL_Rect * rect);
    1.24 +
    1.25 +/**
    1.26   *  \brief Returns the number of available display modes.
    1.27   *
    1.28   *  \sa SDL_GetDisplayMode()