1 ======================== 2 Using SDL with PicoGUI 3 ======================== 4 5 - Originally contributed by Micah Dowty <micahjd (a] users.sourceforge.net> 6 7 PicoGUI is a scalable GUI system with a unique architecture, primarily focused 8 on scalability to various embedded systems. You can find more information 9 including a FAQ at http://picogui.org 10 11 To 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 25 Capabilities: 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 32 TODO 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
