Linux installation

See source:tags/2.0.0/INSTALL.txt

---

1.4.0 (Obsolete)

Introduction

1.4.x only (for 2.x, see source:trunk/INSTALL.txt)

There are several ways to install Speed Dreams:

• from all-in-one tarball
• from modular packages
• from SVN (aimed at developers)
• from pre-built packages.

Pick just one of the above options. If you have trouble during the installation, have a look in the FAQ. In case you get stuck, learn how to report the problem from this Wiki before you file a bug or contact us.

Pre-requisites

• Working OpenGL Driver and header files / associated libraries
• PLIB 1.8.3 / 4 / 5 (http://plib.sourceforge.net/). Be careful to compile plib with -fPIC on AMD64 if you run a 64 bit version.
• OpenAL soft 1.5 (http://connect.creativelabs.com/openal)
• ALUT 1.1 (http://connect.creativelabs.com/openal)
• libpng
• zlib
• jpeg
• X RandR

Note: For all these libs, you need to install the run-time _and_ the devel versions of your distro's packages, or compile from sources and install them yourself.

Build options

To get information about build options run "./configure --help". Arguments of note might be debugging support (--enable-debug) and disabling the use of XRANDR (--disable-xrandr) and of course target installation directory (--prefix).

Installation from All-in-one tarball

1. Uncompress the tarball

   $ tar xfvj speed-dreams-xxx.tar.bz2
   

2. Build and install

   $ cd speed-dreams-xxx
   $ ./configure [--prefix=PREFIX (default /usr/local)]
   $ make
   $ sudo make install         # installs in PREFIX/bin and PREFIX/lib/speed-dreams
   $ sudo make datainstall     # installs in PREFIX/share/games/speed-dreams
   

   Notes
   • sudo is only useful if your install PREFIX is a read-only folder (like default /usr/local)
   • sudo configuration : you may ask your system administrator to enable you to run sudo make install and sudo make datainstall ; if he doesn't know how, you can tell him/her to add a line like this in /etc/sudoers (or something less permissive ;-) :

     <your login name>    ALL=(ALL) NOPASSWD: ALL
     

   • In some cases, you may need to rebuild the configure script before running it:

     $ make cleanconfig
     $ make configure
     

   • Use ./configure --help for options; --enable-debug could be of interest ...
   • some useful environment variables to set before ./configure, if you have special needs:
     • CPPFLAGS (Ex: "-I $HOME/include -I /usr/local/include")
     • CXXFLAGS (Ex: "-Wno-deprecated -march=athlon64 -ffast-math -pipe")
     • LDFLAGS (Ex: "-L $HOME/lib -L /usr/local/lib64")
   • be also careful with some other environment variables that may have an influence on your compiler: PATH, LD_LIBRARY_PATH, INCLUDE, LIB,...
3. Run Speed Dreams

if PREFIX/bin is not in your $PATH

$ cd PREFIX/bin
$ ./speed-dreams

otherwise

$ speed-dreams

Note: the -l option might show you interesting things if you have run-time troubles...

Installation from Modular Packages

1. Uncompress the sources tar ball and optional robots

   $ tar xfvj speed-dreams-xxx-src*.tgz
   $ tar xfvj speed-dreams-xxx-src-robots-yyyyy.tgz
   

2. Build the executables

   $ cd speed-dreams-xxx
   $ ./configure [--prefix=PREFIX (default /usr/local)]
   $ make
   $ make install         # installs in PREFIX/share/games/speed-dreams PREFIX/bin and PREFIX/lib
   

This should generate the binaries, with no more than a few warnings. Note See notes above.

1. Uncompress the mandatory data

   $ cd PREFIX/share/games/speed-dreams
   $ tar xzvf speed-dreams-xxx-data.tgz
   

2. Uncompress the optional data

   $ tar xzvf speed-dreams-xxx-data-*.tgz
   

3. Run Speed Dreams

if PREFIX/bin is not in your $PATH

$ cd PREFIX/bin
$ ./speed-dreams

otherwise

$ speed-dreams

Note: -l option might show you interesting things if you have run-time troubles...
Note: -k option, used as the 1st one (mandatory) will prevent Speed Dreams from overwriting your precious user settings in ~/.speed-dreams directory after each make install

Installation from SVN

Before you start be warned that the SVN trunk / branches might crash or not even compile sometimes. If you want to get it anyway, follow the instructions at http://sourceforge.net/svn/?group_id=239111

For the moment,

• releases are built on the trunk; you can checkout the current state by issuing:

  svn co https://speed-dreams.svn.sourceforge.net/svnroot/speed-dreams/trunk ./speed-dreams-trunk
  

• and we make branches under the "branches" root dir; as an example, you can get the "sdl-port" branch current state via:

  svn co https://speed-dreams.svn.sourceforge.net/svnroot/speed-dreams/branches/sdl-port ./speed-dreams-sdl-port
  

See above (All-in-one tarball) for build/install instructions after downloading.

Pre-built packages

• If you are using Ubuntu 9.10 (Karmic Koala), you can install Speed Dreams easily using a pre-built .deb package.
• We hope to add more packages in the future.