include/SDL_hints.h
changeset 11694 2ce56475ad57
parent 11658 fbfdee28682d
child 11745 bb8a8a1996d1
     1.1 --- a/include/SDL_hints.h	Mon Nov 06 15:29:24 2017 -0500
     1.2 +++ b/include/SDL_hints.h	Tue Nov 07 09:10:32 2017 -0800
     1.3 @@ -798,14 +798,22 @@
     1.4  #define SDL_HINT_RPI_VIDEO_LAYER           "SDL_RPI_VIDEO_LAYER"
     1.5  
     1.6  /**
     1.7 - * \brief Tell SDL the KMS/DRM video driver that we want double buffer only.
     1.8 + * \brief Tell the video driver that we only want a double buffer.
     1.9   *
    1.10 - * By default KMS/DRM will use a triple buffer solution that wastes no CPU
    1.11 - * time on waiting for vsync after issuing a flip, but introduces a frame of
    1.12 - * latency. Waiting for vsync immediately after issuing a flip on the other
    1.13 - * hand is recommended for cases where low latency is an important factor.
    1.14 + * By default, most lowlevel 2D APIs will use a triple buffer scheme that 
    1.15 + * wastes no CPU time on waiting for vsync after issuing a flip, but
    1.16 + * introduces a frame of latency. On the other hand, using a double buffer
    1.17 + * scheme instead is recommended for cases where low latency is an important
    1.18 + * factor because we save a whole frame of latency.
    1.19 + * We do so by waiting for vsync immediately after issuing a flip, usually just
    1.20 + * after eglSwapBuffers call in the backend's *_SwapWindow function.
    1.21 + *
    1.22 + * Since it's driver-specific, it's only supported where possible and
    1.23 + * implemented. Currently supported the following drivers:
    1.24 + * - KMSDRM (kmsdrm)
    1.25 + * - Raspberry Pi (raspberrypi)
    1.26   */
    1.27 -#define SDL_HINT_KMSDRM_DOUBLE_BUFFER      "SDL_KMSDRM_DOUBLE_BUFFER"
    1.28 +#define SDL_HINT_VIDEO_DOUBLE_BUFFER      "SDL_VIDEO_DOUBLE_BUFFER"
    1.29  
    1.30  /**
    1.31   *  \brief  A variable controlling what driver to use for OpenGL ES contexts.