include: Tweaked some vsync-related documentation.

Reference PR #9903.
This commit is contained in:
Ryan C. Gordon 2024-05-27 16:57:21 -04:00
parent 6524f9c9b8
commit e508d82f74
No known key found for this signature in database
GPG key ID: FA148B892AB48044
2 changed files with 18 additions and 18 deletions

View file

@ -2144,15 +2144,15 @@ extern SDL_DECLSPEC int SDLCALL SDL_AddVulkanRenderSemaphores(SDL_Renderer *rend
*
* When a renderer is created, vsync defaults to SDL_RENDERER_VSYNC_DISABLED.
*
* \param renderer The renderer to toggle
* \param vsync the vertical refresh sync interval, 1 to synchronize present
* with every vertical refresh, 2 to synchronize present with
* every second vertical refresh, etc.,
* SDL_RENDERER_VSYNC_ADAPTIVE for late swap tearing (adaptive
* vsync), or SDL_RENDERER_VSYNC_DISABLED to disable. Not every
* value is supported by every renderer, so you should check the
* return value to see whether the requested setting is
* supported.
* The `vsync` parameter can be 1 to synchronize present with every vertical
* refresh, 2 to synchronize present with every second vertical refresh, etc.,
* SDL_WINDOW_SURFACE_VSYNC_ADAPTIVE for late swap tearing (adaptive vsync),
* or SDL_WINDOW_SURFACE_VSYNC_DISABLED to disable. Not every value is
* supported by every driver, so you should check the return value to see
* whether the requested setting is supported.
*
* \param renderer The renderer to toggle.
* \param vsync the vertical refresh sync interval.
* \returns 0 on success or a negative error code on failure; call
* SDL_GetError() for more information.
*