include/SDL_hints.h
changeset 11694 2ce56475ad57
parent 11658 fbfdee28682d
child 11745 bb8a8a1996d1
equal deleted inserted replaced
11693:4c8bd26f1aab 11694:2ce56475ad57
   796  * The default is 10000.
   796  * The default is 10000.
   797  */
   797  */
   798 #define SDL_HINT_RPI_VIDEO_LAYER           "SDL_RPI_VIDEO_LAYER"
   798 #define SDL_HINT_RPI_VIDEO_LAYER           "SDL_RPI_VIDEO_LAYER"
   799 
   799 
   800 /**
   800 /**
   801  * \brief Tell SDL the KMS/DRM video driver that we want double buffer only.
   801  * \brief Tell the video driver that we only want a double buffer.
   802  *
   802  *
   803  * By default KMS/DRM will use a triple buffer solution that wastes no CPU
   803  * By default, most lowlevel 2D APIs will use a triple buffer scheme that 
   804  * time on waiting for vsync after issuing a flip, but introduces a frame of
   804  * wastes no CPU time on waiting for vsync after issuing a flip, but
   805  * latency. Waiting for vsync immediately after issuing a flip on the other
   805  * introduces a frame of latency. On the other hand, using a double buffer
   806  * hand is recommended for cases where low latency is an important factor.
   806  * scheme instead is recommended for cases where low latency is an important
   807  */
   807  * factor because we save a whole frame of latency.
   808 #define SDL_HINT_KMSDRM_DOUBLE_BUFFER      "SDL_KMSDRM_DOUBLE_BUFFER"
   808  * We do so by waiting for vsync immediately after issuing a flip, usually just
       
   809  * after eglSwapBuffers call in the backend's *_SwapWindow function.
       
   810  *
       
   811  * Since it's driver-specific, it's only supported where possible and
       
   812  * implemented. Currently supported the following drivers:
       
   813  * - KMSDRM (kmsdrm)
       
   814  * - Raspberry Pi (raspberrypi)
       
   815  */
       
   816 #define SDL_HINT_VIDEO_DOUBLE_BUFFER      "SDL_VIDEO_DOUBLE_BUFFER"
   809 
   817 
   810 /**
   818 /**
   811  *  \brief  A variable controlling what driver to use for OpenGL ES contexts.
   819  *  \brief  A variable controlling what driver to use for OpenGL ES contexts.
   812  *
   820  *
   813  *  On some platforms, currently Windows and X11, OpenGL drivers may support
   821  *  On some platforms, currently Windows and X11, OpenGL drivers may support