SDL - Revision history

Kingu: added SDL_Controls link

2013-10-25T19:25:04Z

added SDL_Controls link

Notaz: /* Using SDL with OpenGL ES */

2013-04-21T16:21:15Z

‎Using SDL with OpenGL ES

Notaz: /* Cursor drift in fullscreen mode */

2013-04-21T16:19:01Z

‎Cursor drift in fullscreen mode

Notaz: Created page with "SDL is popular library for graphics, sound and input. This page lists some things to know when using it on pandora. ==Pandora optimized mode== The SDL library included in pan..."

2013-04-21T16:17:35Z

Created page with "SDL is popular library for graphics, sound and input. This page lists some things to know when using it on pandora. ==Pandora optimized mode== The SDL library included in pan..."

New page

SDL is popular library for graphics, sound and input. This page lists some things to know when using it on pandora.

==Pandora optimized mode==
The SDL library included in pandora has a special mode (SDL internal driver) to make use of OMAP's features, like hardware scaling and double buffering. This mode is disabled by default because it doesn't support windowed mode and has some compatibility problems with some games. Information about how to use it can be found in [http://notaz.gp2x.de/cgi-bin/gitweb.cgi?p=sdl_omap.git;a=blob;f=README.OMAP;hb=HEAD this readme].

==Issues with standard SDL mode on pandora==
===Cursor drift in fullscreen mode===
When cursor is hidden (after SDL_ShowCursor(0) is called), touchscreen coordinates start to drift away over time, i.e. if you touch center of the screen, SDL may start reporting you touched the right or left edge. This is because SDL switches to relative mouse mode and starts warping the cursor when it's hidden. This is supposedly intended for 3D action games where cursor should never hit edge of screen and player should be able to look at some direction by moving the mouse to single direction as much as he wants (on pandora that can be accomplished with nubs or external mouse). Because some games rely on that feature to be functional, it should be disabled manually by:
* Setting environment variable SDL_MOUSE_RELATIVE=0, which can be easily done in launch script like this:
<source lang="bash">
export SDL_MOUSE_RELATIVE=0
./yourapp
</source>
* Not calling SDL_ShowCursor(0) and setting up [http://blogs.distant-earth.com/wp/?p=293 transparent cursor].

===Using SDL with OpenGL ES===
This can be accomplished with SDL_GetWMInfo() call to get the required handles, like:
<source lang="c">
SDL_SysWMinfo sysWmInfo;
SDL_VERSION(&sysWmInfo.version);
SDL_GetWMInfo(&sysWmInfo);
eglDisplay = eglGetDisplay((EGLNativeDisplayType)sysWmInfo.info.x11.display);
...
eglSurface = eglCreateWindowSurface(eglDisplay, eglConfig, (NativeWindowType)sysWmInfo.info.x11.window, NULL);
</source>
This will allow to use GL on the window. Note that if you use fullscreen mode, because of how SGX drivers are implemented, you may get better performance if you ''don't'' specify display/window handles to run the GL driver in framebuffer mode, like this:
<source lang="c">
eglDisplay = eglGetDisplay(EGL_DEFAULT_DISPLAY);
...
eglSurface = eglCreateWindowSurface(eglDisplay, eglConfig, NULL, NULL);
</source>
You should still create fullscreen SDL window to prevent interference with Xorg and to have working input. Se also [[SGX_drivers#Driver_operation_modes|SGX driver operation modes]].

← Older revision		Revision as of 19:25, 25 October 2013
Line 31:		Line 31:
	</source>		</source>
	You should still create fullscreen SDL window to prevent interference with Xorg and to have working input. See also [[SGX_drivers#Driver_operation_modes\|SGX driver operation modes]].		You should still create fullscreen SDL window to prevent interference with Xorg and to have working input. See also [[SGX_drivers#Driver_operation_modes\|SGX driver operation modes]].
		+
		+	[[SDL_Controls]] documents input.

@@ Line 30: / Line 30: @@
 eglSurface = eglCreateWindowSurface(eglDisplay, eglConfig, NULL, NULL);
 </source>
-You should still create fullscreen SDL window to prevent interference with Xorg and to have working input. Se also [[SGX_drivers#Driver_operation_modes|SGX driver operation modes]].
+You should still create fullscreen SDL window to prevent interference with Xorg and to have working input. See also [[SGX_drivers#Driver_operation_modes|SGX driver operation modes]].

@@ Line 6: / Line 6: @@
 ==Issues with standard SDL mode on pandora==
 ===Cursor drift in fullscreen mode===
-When cursor is hidden (after SDL_ShowCursor(0) is called), touchscreen coordinates start to drift away over time, i.e. if you touch center of the screen, SDL may start reporting you touched the right or left edge. This is because SDL switches to relative mouse mode and starts warping the cursor when it's hidden. This is supposedly intended for 3D action games where cursor should never hit edge of screen and player should be able to look at some direction by moving the mouse to single direction as much as he wants (on pandora that can be accomplished with nubs or external mouse). Because some games rely on that feature to be functional, it should be disabled manually by:
+When cursor is hidden (after SDL_ShowCursor(0) is called), touchscreen coordinates start to drift away over time, i.e. if you touch center of the screen, SDL may start reporting you touched the right or left edge. This is because SDL switches to relative mouse mode and starts warping the cursor when it's hidden. This is supposedly intended for 3D action games where cursor should never hit edge of screen and player should be able to look at some direction by moving the mouse to single direction as much as he wants (on pandora that can be accomplished with nubs or external mouse). Because some games rely on that feature to be functional, when not needed it should be disabled manually by:
 * Setting environment variable SDL_MOUSE_RELATIVE=0, which can be easily done in launch script like this:
   <source lang="bash">