README.PicoGUI

   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 ---