Mercurial > sdl-ios-xcode

view README.PicoGUI @ 4221:c56391324e59 SDL-1.2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fixed bug #674 Matej 2009-01-08 09:25:34 PST Hello, I maintain a cross-platform project that uses SDL. One of the users who runs OSX has told me that he has problems with linking to SDL due to missing -framework option. I think that the problem is because of this: 'sdl-config --libs' outputs '-L/opt/local/lib -lSDLmain -lSDL -Wl,-framework,Cocoa' All the options are passed to the linker except the last one. I think that the good output should be just: '-L/opt/local/lib -lSDLmain -lSDL -framework Cocoa' since those options (--libs) are passed to the linker, so the '-Wl' option is redundant and possibly harmful in this very case I use autotools with libtool to do the build... Regards, Matej
author Sam Lantinga <slouken@libsdl.org>
date Mon, 21 Sep 2009 10:23:07 +0000
parents 706de3956894
children
line wrap: on
line source

 ========================
  Using SDL with PicoGUI
 ========================

- Originally contributed by Micah Dowty <micahjd@users.sourceforge.net>

PicoGUI is a scalable GUI system with a unique architecture, primarily focused
on scalability to various embedded systems. You can find more information
including a FAQ at http://picogui.org

To use the patch:

  1. When compiling, add the "--enable-video-picogui" switch to ./configure

  2. When running your program, ensure that the picogui driver for SDL
     is in use by setting the SDL_VIDEODRIVER environment variable 
     to "picogui".

  3. The program must also be linked to the C client library for PicoGUI
     (libpgui.so). If the program is being compiled with a patched SDL 
     installed this should be done automatically. If you want to use an
     existing binary with PicoGUI, you can set the LD_PRELOAD environment
     variable to the path of your libpgui.so file.

Capabilities:

  So far only basic functionality is provided on true color (linear16/24/32)
  devices. Accessing a memory mapped bitmap, updating the display, and handling
  mouse/keyboard input. This functionality has been tested with several
  applications, including mplayer, Xine, sldroids, and Abuse.

TODO list:

  - YUV overlays will be helpful for watching video on set top boxes or other
    embedded devices that have some graphics acceleration hardware

  - Account for rotated bitmap storage in pgserver

  - Support for hiding or changing the cursor

  - The display should be centered when the SDL application is smaller
    than the PicoGUI panel

  - Fullscreen or any other special modes

  - Support for indexed and grayscale modes

  - Probably much more...

--- The End ---