symbian-qemu-0.9.1-12/libsdl-trunk/README.PicoGUI
changeset 1 2fb8b9db1c86
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/symbian-qemu-0.9.1-12/libsdl-trunk/README.PicoGUI	Fri Jul 31 15:01:17 2009 +0100
@@ -0,0 +1,50 @@
+ ========================
+  Using SDL with PicoGUI
+ ========================
+
+- Originally contributed by Micah Dowty <micahjd@users.sourceforge.net>
+
+PicoGUI is a scalable GUI system with a unique architecture, primarily focused
+on scalability to various embedded systems. You can find more information
+including a FAQ at http://picogui.org
+
+To use the patch:
+
+  1. When compiling, add the "--enable-video-picogui" switch to ./configure
+
+  2. When running your program, ensure that the picogui driver for SDL
+     is in use by setting the SDL_VIDEODRIVER environment variable 
+     to "picogui".
+
+  3. The program must also be linked to the C client library for PicoGUI
+     (libpgui.so). If the program is being compiled with a patched SDL 
+     installed this should be done automatically. If you want to use an
+     existing binary with PicoGUI, you can set the LD_PRELOAD environment
+     variable to the path of your libpgui.so file.
+
+Capabilities:
+
+  So far only basic functionality is provided on true color (linear16/24/32)
+  devices. Accessing a memory mapped bitmap, updating the display, and handling
+  mouse/keyboard input. This functionality has been tested with several
+  applications, including mplayer, Xine, sldroids, and Abuse.
+
+TODO list:
+
+  - YUV overlays will be helpful for watching video on set top boxes or other
+    embedded devices that have some graphics acceleration hardware
+
+  - Account for rotated bitmap storage in pgserver
+
+  - Support for hiding or changing the cursor
+
+  - The display should be centered when the SDL application is smaller
+    than the PicoGUI panel
+
+  - Fullscreen or any other special modes
+
+  - Support for indexed and grayscale modes
+
+  - Probably much more...
+
+--- The End ---