README.PicoGUI
changeset 433 706de3956894
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README.PicoGUI	Thu Aug 01 23:24:13 2002 +0000
     1.3 @@ -0,0 +1,50 @@
     1.4 + ========================
     1.5 +  Using SDL with PicoGUI
     1.6 + ========================
     1.7 +
     1.8 +- Originally contributed by Micah Dowty <micahjd@users.sourceforge.net>
     1.9 +
    1.10 +PicoGUI is a scalable GUI system with a unique architecture, primarily focused
    1.11 +on scalability to various embedded systems. You can find more information
    1.12 +including a FAQ at http://picogui.org
    1.13 +
    1.14 +To use the patch:
    1.15 +
    1.16 +  1. When compiling, add the "--enable-video-picogui" switch to ./configure
    1.17 +
    1.18 +  2. When running your program, ensure that the picogui driver for SDL
    1.19 +     is in use by setting the SDL_VIDEODRIVER environment variable 
    1.20 +     to "picogui".
    1.21 +
    1.22 +  3. The program must also be linked to the C client library for PicoGUI
    1.23 +     (libpgui.so). If the program is being compiled with a patched SDL 
    1.24 +     installed this should be done automatically. If you want to use an
    1.25 +     existing binary with PicoGUI, you can set the LD_PRELOAD environment
    1.26 +     variable to the path of your libpgui.so file.
    1.27 +
    1.28 +Capabilities:
    1.29 +
    1.30 +  So far only basic functionality is provided on true color (linear16/24/32)
    1.31 +  devices. Accessing a memory mapped bitmap, updating the display, and handling
    1.32 +  mouse/keyboard input. This functionality has been tested with several
    1.33 +  applications, including mplayer, Xine, sldroids, and Abuse.
    1.34 +
    1.35 +TODO list:
    1.36 +
    1.37 +  - YUV overlays will be helpful for watching video on set top boxes or other
    1.38 +    embedded devices that have some graphics acceleration hardware
    1.39 +
    1.40 +  - Account for rotated bitmap storage in pgserver
    1.41 +
    1.42 +  - Support for hiding or changing the cursor
    1.43 +
    1.44 +  - The display should be centered when the SDL application is smaller
    1.45 +    than the PicoGUI panel
    1.46 +
    1.47 +  - Fullscreen or any other special modes
    1.48 +
    1.49 +  - Support for indexed and grayscale modes
    1.50 +
    1.51 +  - Probably much more...
    1.52 +
    1.53 +--- The End ---