INSTALL

   1
   2 - Install instructions for SuperTux -
   3 http://supertux.berlios.de/
   4
   5 Last update: April 26, 2004
   6
   7 REQUIREMENTS
   8 ------------
   9
  10   CONTROLS
  11   --------
  12     The game can be played with either a the keyboard or a joystick.
  13
  14   SDL
  15   ---
  16     "SuperTux" was programed using the "Simple DirectMedia Layer"
  17     libraries by Sam Lantinga.  This means that the game can
  18     theoretically run under any environment that the SDL libraries support.
  19
  20     (As of this program's release, this includes: Linux X11/DGA,
  21     Win32 WinDIB/DirectX, BeOS BWindow, and Solaris X11, as well
  22     as unofficually supported: Linux SVGAlib, IRIX 6.x X11,
  23     FreeBSD 3.x X11, and MacOS.)
  24
  25     The Simple DirectMedia Layer is required to compile this game.
  26
  27     You can download the SDL libraries from:
  28       http://www.libsdl.org/
  29
  30   SDL_image
  31   ---------
  32     SDL_image is also required.  (It is used to load the PNG format images
  33     that come with SuperTux!)
  34
  35   SDL_mixer
  36   ---------
  37     Sound and music are available, but are not required (see below).
  38     You will need the "SDL_mixer" library compiled and installed if
  39     you want sound.
  40
  41   OpenGL implementation (optional)
  42   ---------------------
  43     Mesa should be installed in order to compile, but it is painly
  44     slow when running, so we advise you to install your videocard
  45     drivers (of course, it has to be an accelerated videocard).
  46     For linux, nvidia vendor is the only one that makes decent drivers.
  47     But the ATI drivers should run with the same performance, since
  48     it only uses accelerated 2d, not 3d.
  49
  50     Anyway, you can use the SDL frontend and you most likely won't
  51     notice any difference.
  52
  53
  54 INSTALLING UNDER LINUX/UNIX
  55 ---------------------------
  56   -----------------------------------------------------------------
  57   Note: Read this entire section before you start issuing commands!
  58   -----------------------------------------------------------------
  59
  60   SuperTux uses a script that checks for dependency and disables
  61   features, in case they are not found.
  62   The script is the configure and you can specify a few stuff
  63   like the directory to which you want to install SuperTux,
  64   by giving the argument --prefix=/usr/local (ie). For more
  65   informations, type './configure --help'.
  66   (Note: SuperTux does not need to be installed in the system,
  67   you can run it from its own directory.)
  68
  69   If there isn't any configure script (ie. in case, you got it
  70   via cvs), just run the autogen.sh script.
  71
  72   To compile it, a 'make' is enough.
  73   Type 'make install' (as root) to copy it into the system.
  74   (default directory is /usr/local, see above how to change
  75   this.)
  76
  77   So, in short, just type:
  78   sh autogen.sh (in case there isn't any configure file already)
  79   sh configure
  80   make
  81
  82   And in case you want to copy SuperTux to the system:
  83   make install (as root)
  84
  85
  86 ICON FILE
  87 ---------
  88   A 32x32, XPM-format icon file is available if you wish to use
  89   an icon for a menu entry for this game.
  90
  91   The file is "supertux.xpm", and can be found at  the data/images/
  92   directory.