| 1 | ======================== |
| 2 | Using SDL with PicoGUI |
| 3 | ======================== |
| 4 | |
| 5 | - Originally contributed by Micah Dowty <micahjd@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 --- |