Created attachment 2145 [details]
Test probelm

In the documentation, it's recommended to use SDL_LockTexture() over SDL_UpdateTexture() (https://wiki.libsdl.org/SDL_UpdateTexture) for streaming textures (contradicting the advice given in the migration guide, https://wiki.libsdl.org/MigrationGuide#If_your_game_just_wants_to_get_fully-rendered_frames_to_the_screen).

The problem is that under the OpenGL render driver on Mac OS X, using SDL_LockTexture() causes tearing when SDL_RENDER_PRESENTVSYNC is set.

I've attached a sample program that demonstrates the behavior.

I'm guessing it's because SDL_LockTexture() retrieves a pointer to memory shared with the GPU. That's fine, but it should be the memory for the texture buffer not currently being displayed on the screen.

The workaround is to use SDL_UpdateTexture(). This workaround isn't ideal because it generates an extra buffer copy when the software renderer is used. It would be better to fix the OpenGL renderer so that each SDL texture references two different OpenGL textures if memory-sharing is being used.