Linux installation
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
- Uncompress the tarball
$ tar xfvj speed-dreams-xxx.tar.bz2
- 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,...
- 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
- Uncompress the sources tar ball and optional robots
$ tar xfvj speed-dreams-xxx-src*.tgz $ tar xfvj speed-dreams-xxx-src-robots-yyyyy.tgz
- 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.
- Uncompress the mandatory data
$ cd PREFIX/share/games/speed-dreams $ tar xzvf speed-dreams-xxx-data.tgz
- Uncompress the optional data
$ tar xzvf speed-dreams-xxx-data-*.tgz
- 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.
