Sparks GNU/Linux port
---------------------

Sparks - a colourful, fun demo by mandrixx+willbe+flan from LTP2, 1998

Win32 and GNU/Linux port by bananaboy, March 2003

There are four versions for GNU/Linux in this archive:

sparks-linux-x86-ptc
sparks-linux-x86-ptc-static
sparks-linux-x86-sdl
sparks-linux-x86-sdl-static

Each executable was developed and tested under the following software versions:

      FMOD 3.61
      glibc 2.2.3
      Slackware GNU/Linux 2.4.5
      gcc 2.95.3 (but you don't have the source :-))

Dynamic libraries should be placed in the current directory, or one of the
system library directories (e.g. /lib, /usr/lib, /usr/local/lib).

Specific details follow.


sparks-linux-x86-ptc
sparks-linux-x86-ptc-static
---------------------------

These are the dynamically and statically linked versions of Sparks using PTC.
They were linked against:

      OpenPTC/X11 1.0
      Hermes 1.3.2

command-line parameters: [-dga] [-width <width>] [-height <height>]

   -dga             - try to use DGA, then fall back to MIT-Shm, then XImage
                      (default is to try MIT-Shm then XImage)
   -width <width>   - set window width
   -height <height> - set window height

`DGA' mode requires uid root (either run it as root or suid the binary).  DGA
mode crashes on my computer.  If it doesn't seem to work for you, either run
it in a window or get the SDL version.

Additionally, my installation of hermes wouldn't let me run with a larger
console.  If you get a message like:

error: Could not load console
Hermes conversion failure

Then apparently your version of hermes doesn't want to convert a 320x240x16bpp
surface to a larger console either.


sparks-linux-x86-sdl
sparks-linux-x86-sdl-static
---------------------------

These are the dynamically and statically linked versions of Sparks using SDL.
They were linked against:

      SDL 1.2

command-line parameters: [-windowed]

   -windowed        - windowed mode

SDL doesn't seem to be able to do blits between surfaces of different sizes.
This means that if you don't have a 320x240 video mode in your XF86Config file,
you'll probably have to watch the demo in a window.  Try putting the following
line in your XF86Config file, in the "Monitor" section:

Modeline "320x240" 15.75 320 336 384 400 240 244 246 262 doublescan

and then add "320x240" to a "Display" subsection (e.g. the 24 bpp subsection).
The demo requires a 320x240x16 bpp or better (`better' in terms of colour depth)
video mode to run full-screen.

There are various SDL environment variables that can be set to control SDL.
See the SDL documentation for details.


Misc.
-----

Please send bug reports (and solutions if known! :-)) to bananaboy.

Contact us at:

Mandrixx <mxx@mandrixx.net>
http://www.mandrixx.net

Will Be <willbe@planet-d.net>
http://willbe.planet-d.net

bananaboy <bb@humbug.net>
http://www.humbug.net


