Clarify (lack of) support for desktop OpenGL on the Raspberry Pi

libsdl-org · Oct 21, 2014 · 96fd9ce · 96fd9ce
1 parent 5f193f0
commit 96fd9ce
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/docs/README-raspberrypi.md b/docs/README-raspberrypi.md
@@ -150,6 +150,23 @@ this determining the CAPS LOCK behavior:
 
     sudo dpkg-reconfigure locales
 
+================================================================================
+ OpenGL problems
+================================================================================
+
+If you have desktop OpenGL headers installed at build time in your RPi or cross 
+compilation environment, support for it will be built in. However, the chipset 
+does not actually have support for it, which causes issues in certain SDL apps 
+since the presence of OpenGL support supersedes the ES/ES2 variants.
+The workaround is to disable OpenGL at configuration time:
+
+    ./configure --disable-video-opengl
+
+Or if the application uses the Render functions, you can use the SDL_RENDER_DRIVER
+environment variable:
+
+    export SDL_RENDER_DRIVER=opengles2
+
 ================================================================================
  Notes
 ================================================================================