README.PicoGUI
author Sam Lantinga <slouken@libsdl.org>
Sun, 28 May 2006 18:16:36 +0000
branchSDL-1.3
changeset 1664 cd3db072ba8a
parent 433 706de3956894
permissions -rw-r--r--
more indent cleanup
slouken@433
     1
 ========================
slouken@433
     2
  Using SDL with PicoGUI
slouken@433
     3
 ========================
slouken@433
     4
slouken@433
     5
- Originally contributed by Micah Dowty <micahjd@users.sourceforge.net>
slouken@433
     6
slouken@433
     7
PicoGUI is a scalable GUI system with a unique architecture, primarily focused
slouken@433
     8
on scalability to various embedded systems. You can find more information
slouken@433
     9
including a FAQ at http://picogui.org
slouken@433
    10
slouken@433
    11
To use the patch:
slouken@433
    12
slouken@433
    13
  1. When compiling, add the "--enable-video-picogui" switch to ./configure
slouken@433
    14
slouken@433
    15
  2. When running your program, ensure that the picogui driver for SDL
slouken@433
    16
     is in use by setting the SDL_VIDEODRIVER environment variable 
slouken@433
    17
     to "picogui".
slouken@433
    18
slouken@433
    19
  3. The program must also be linked to the C client library for PicoGUI
slouken@433
    20
     (libpgui.so). If the program is being compiled with a patched SDL 
slouken@433
    21
     installed this should be done automatically. If you want to use an
slouken@433
    22
     existing binary with PicoGUI, you can set the LD_PRELOAD environment
slouken@433
    23
     variable to the path of your libpgui.so file.
slouken@433
    24
slouken@433
    25
Capabilities:
slouken@433
    26
slouken@433
    27
  So far only basic functionality is provided on true color (linear16/24/32)
slouken@433
    28
  devices. Accessing a memory mapped bitmap, updating the display, and handling
slouken@433
    29
  mouse/keyboard input. This functionality has been tested with several
slouken@433
    30
  applications, including mplayer, Xine, sldroids, and Abuse.
slouken@433
    31
slouken@433
    32
TODO list:
slouken@433
    33
slouken@433
    34
  - YUV overlays will be helpful for watching video on set top boxes or other
slouken@433
    35
    embedded devices that have some graphics acceleration hardware
slouken@433
    36
slouken@433
    37
  - Account for rotated bitmap storage in pgserver
slouken@433
    38
slouken@433
    39
  - Support for hiding or changing the cursor
slouken@433
    40
slouken@433
    41
  - The display should be centered when the SDL application is smaller
slouken@433
    42
    than the PicoGUI panel
slouken@433
    43
slouken@433
    44
  - Fullscreen or any other special modes
slouken@433
    45
slouken@433
    46
  - Support for indexed and grayscale modes
slouken@433
    47
slouken@433
    48
  - Probably much more...
slouken@433
    49
slouken@433
    50
--- The End ---