The files here, except for those in the directory "ODE", are
available under the GPL license, version 3 (see the file
"src/COPYING" for details). The program uses the "SDL" library,
available at www.libsdl.org, which is distributed under the GNU
LGPL license,version 2 (www.gnu.org) and the "Open Dynamics
Engine" (ODE), available at www.ode.org. More details about ODE
and its licenses can be found in the directory "ODE".

The recommendations below are for GNU/Linux and FreeBSD.

An executable file already compiled for Linux, Pentium II processor,
640x480 resolution, software rendering and keyboard control, with
gcc 4.1.1, is available. If you want to try it, skip the
installation and go straight to 2.


     1. INSTALLATION
     2. RUNNING
     3. JOYSTICK / STEERING WHEEL
     4. MAKING NEW TRACKS


1. INSTALLATION

SDL library is required. Make sure you have it installed. You should
install it from the sources available at www.libsdl.org or, at
least, get a "sdl-devel" package for your distribution.

Then open a terminal/console window and change the current
directory to "skunks-2.0.0", using the command "cd".

ODE must be installed first; version 0.11.1 (which I used) is in
the directory "ODE". To install it, type:

./inst-ode

ODE will be installed in "ODE/local". Then type:

./comp

If it doesn't work, try:

chmod 755 *

.. or check the contents of the files "comp" and "inst-ode". You
can modify the compiler flags in "comp", according to your system
(for instance, if you have a Pentium 3, Athlon XP or other processor
which supports SSE, you might want to add "-mfpmath=sse" and, of
course, "-march=.....").

For more options,the file "src/config.h" may be edited, which
facilitates the selection of the display resolution, viewing angle
and other parameters. You should check line 34 in "src/config.h".
The game will (probably) run with 16, 24 or 32-bit color just as
well, but only one of these values will lead to the maximum framerate,
depending on your screen settings. If you have a fast computer, you
may also want to look at line 49 in "src/config.h" and line 117 in
"src/skunks.c". To adjust the viewing distance, modify variables
"zfog" and "zmax" in "skunks.c".


2. RUNNING

First, open a terminal/console window and change the current
directory to "skunks-2.0.0", using the command "cd".

After compilation, you can start the game by typing:

./skunks CARFILE TRACKFILE

Examples:

./skunks cars/car1 tracks/track1

./skunks cars/car4 tracks/track2

7 tracks are available in the directory 'tracks'.

The car parameters can easily be modified. Below are a few details
about the 4 cars:

car1: rear wheel drive
car2: front wheel drive
car3: 4 wheel drive
car4: rear wheel drive, but lower and faster than car1
car5: same as car 4, but lower and with less grip
car6: the fastest (handle with care)

All cars are electric and therefore don't need gearboxes.

The buttons which control the game are:

Q or UP - accelerate
A or DOWN - brake
O or LEFT - left
P or RIGHT - right
R - reverse
C - change camera
N and M - rotate camera
ESCAPE - exit


3. JOYSTICK / STEERING WHEEL

If you want to use a joystick or steering wheel, compile the program
with:

./comp-js

If the compilation succeeds, an executable file called "sk-js" will
be obtained, which can be used like the other one mentioned above:

./sk-js CARFILE TRACKFILE

The joystick configuration is in the file "config/joystick". The
settings there should be appropriate for the case in which you have
a joystick and want to use buttons 1 and 2 for acceleration and
brake. If you have a steering wheel and want to use the pedals, the
following modifications are suggested:

sensx 1
sensy 1
deadx 600
deady 3000
nonlinear 0

I only tested joystick support in Fedora Core 6, where the
following command could be used for calibration:

jscal -c /dev/js0


4. MAKING NEW TRACKS

Look in the file "README" from directory "src/aux" for details about
making new tracks. It's easy.
