README.PicoGUI
changeset 433 706de3956894
equal deleted inserted replaced
432:80a35d43a58f 433:706de3956894
       
     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 ---