This bug report was migrated from our old Bugzilla tracker.

These attachments are available in the static archive:

• Test probelm (test.c, text/x-csrc, 2015-05-01 20:09:16 +0000, 1743 bytes)

Reported in version: 2.0.3
Reported for operating system, platform: Mac OS X (All), x86_64

Comments on the original bug report:

On 2015-05-01 20:09:16 +0000, wrote:

Created attachment 2145
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.