Wiki Page Content

Differences between revisions 3 and 4
Revision 3 as of 2013-08-13 07:45:41
Size: 1510
Editor: RyanGordon
Comment: late swap tearing information
Revision 4 as of 2013-08-13 07:48:25
Size: 1578
Editor: RyanGordon
Comment: edited text
Deletions are marked like this. Additions are marked like this.
Line 26: Line 26:
Some systems can specify -1 for the interval, which uses late swap tearing. That is to say, it works like specifying a 1, but if you've already missed the vertical retrace for a given frame, it swaps immediately, which for small drops in framerate might be less distracting. If the system can't support late swap tearing, this function will fail. In such a case, you should probably retry the call with 1 for the interval. Some systems allow specifying -1 for the interval, to enable late swap tearing. Late swap tearing works the same as vsync, but if you've already missed the vertical retrace for a given frame, it swaps buffers immediately, which might be less jarring for the user during occasional framerate drops. If application requests late swap tearing and the system does not support it, this function will fail and return -1. In such a case, you should probably retry the call with 1 for the interval.

SDL_GL_SetSwapInterval

Use this function to set the swap interval for the current OpenGL context.

Syntax

int SDL_GL_SetSwapInterval(int interval)

Function Parameters

interval

0 for immediate updates, 1 for updates synchronized with the vertical retrace, -1 for late swap tearing; see Remarks

Return Value

Returns 0 on success or -1 if setting the swap interval is not supported; call SDL_GetError() for more information.

Code Examples

You can add your code example here

Remarks

Some systems allow specifying -1 for the interval, to enable late swap tearing. Late swap tearing works the same as vsync, but if you've already missed the vertical retrace for a given frame, it swaps buffers immediately, which might be less jarring for the user during occasional framerate drops. If application requests late swap tearing and the system does not support it, this function will fail and return -1. In such a case, you should probably retry the call with 1 for the interval.

Late swap tearing is implemented for some glX drivers with GLX_EXT_swap_control_tear and for some Windows drivers with WGL_EXT_swap_control_tear.


CategoryAPI, CategoryVideo

None: SDL_GL_SetSwapInterval (last edited 2018-04-23 21:33:14 by urkle)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit