1 ======================== 2 Using SDL with PicoGUI 3 ======================== 4 5- Originally contributed by Micah Dowty <micahjd@users.sourceforge.net> 6 7PicoGUI is a scalable GUI system with a unique architecture, primarily focused 8on scalability to various embedded systems. You can find more information 9including a FAQ at http://picogui.org 10 11To use the patch: 12 13 1. When compiling, add the "--enable-video-picogui" switch to ./configure 14 15 2. When running your program, ensure that the picogui driver for SDL 16 is in use by setting the SDL_VIDEODRIVER environment variable 17 to "picogui". 18 19 3. The program must also be linked to the C client library for PicoGUI 20 (libpgui.so). If the program is being compiled with a patched SDL 21 installed this should be done automatically. If you want to use an 22 existing binary with PicoGUI, you can set the LD_PRELOAD environment 23 variable to the path of your libpgui.so file. 24 25Capabilities: 26 27 So far only basic functionality is provided on true color (linear16/24/32) 28 devices. Accessing a memory mapped bitmap, updating the display, and handling 29 mouse/keyboard input. This functionality has been tested with several 30 applications, including mplayer, Xine, sldroids, and Abuse. 31 32TODO list: 33 34 - YUV overlays will be helpful for watching video on set top boxes or other 35 embedded devices that have some graphics acceleration hardware 36 37 - Account for rotated bitmap storage in pgserver 38 39 - Support for hiding or changing the cursor 40 41 - The display should be centered when the SDL application is smaller 42 than the PicoGUI panel 43 44 - Fullscreen or any other special modes 45 46 - Support for indexed and grayscale modes 47 48 - Probably much more... 49 50--- The End --- 51