Mercurial > sdl-ios-xcode
view README.PicoGUI @ 761:c5b2b6d2d1fe
Date: Wed, 31 Dec 2003 21:55:30 +0100
From: Max Horn
Subject: SDL: video/quartz cleanup
while doing some experimental changes in the quartz code, I was annoyed
by having to recompile that one big .o file over and over again. So I
decided to finally realize one TODO: properly splitting the code over
multiple files :-).
With two exceptions, I didn't make code changes, only rearranged files
and added new headers. Since there are several new files, making a
patch didn't work out so well, so I decided to just send you all the
new & modified files.
The one source change I made is related to showing/hiding the mouse. I
renamed cursor_visible to cursor_should_be_visible and cursor_hidden to
cursor_visible; I think that makes reading the code easier.
Then I added two new functions: QZ_ShowMouse and QZ_HideMouse. They
help manage cursor_visible (the former 'cursor_hidden'). Finally I
replaced the Carbon ShowCursor/HiderCuror calls by [NSCursor hide] and
[NSCursor unhide]. The API docs are not conclusive, but it might be
that with those the "cursor_visible" (former 'cursor_hidden') hack may
not be necessary anymore; however so far I didn't test this hypothesis,
so I left that in.
The other change was to remove in_foreground and use [NSApp isActive]
instead: Manually keeping track of whether we are in the foreground is
error prone. This should work better in some corner cases.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Sun, 04 Jan 2004 14:55:35 +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 ---