include/SDL_video.h
changeset 5546 cd2167525827
parent 5535 96594ac5fd1a
child 6138 4c64952a58fb
     1.1 --- a/include/SDL_video.h	Thu Apr 21 09:50:29 2011 -0700
     1.2 +++ b/include/SDL_video.h	Fri Apr 22 09:06:29 2011 -0700
     1.3 @@ -551,9 +551,12 @@
     1.4                                                      SDL_bool fullscreen);
     1.5  
     1.6  /**
     1.7 - *  \brief Get an SDL surface associated with the window.
     1.8 + *  \brief Get the SDL surface associated with the window.
     1.9   *
    1.10 - *  \return A surface in the optimal format for the window, or NULL on error.
    1.11 + *  \return The window's framebuffer surface, or NULL on error. 
    1.12 + *
    1.13 + *  A new surface will be created with the optimal format for the window,
    1.14 + *  if necessary. This surface will be freed when the window is destroyed.
    1.15   *
    1.16   *  \note You may not combine this with 3D or the rendering API on this window.
    1.17   *