Read Me

FOR EVERYBODY :
----

The pyramid goes through the floor, THAT IS NOT A BUG.
Please don't email me. This is only a misuse of the 3D engine.
The engine the eat all CPU, this is also not a bug !!!!

Stuntux is not yet a game. Just a demo of what the 3D engine can does.

----

FOR EXPERTS

----

The rest of this file is for experts that are not enough expert to guess all what is needed by a code to be compiled.
Or for linux guru that want help me :-)

I hope this file will help in case of difficulties to compile the project.


I WILL NOT SUPPORT WINDOWS OR OTHER PLATFORMS BUT ...

Any comment is welcome. I do not reject other OS and will be very happy to make it compile under
any OS.

Must I repeat ? I will not try to compile this code elsewhere. If some code improvements are
sent to me for other OS, I'll include them only if the code is still valid under Mandrake 8.0.

So, Any suggestion are welcome on how to compile this under other OS.

----

COMPILATION NIGHMARES

---
	
Stuntux is yet compilable but not linkable.

Ok, it is, but the configure script does not generate a complete Makefile yet.
Does anybody has a patch for me ?

If you got the sources with CVS, you'll have a hard job to compile Stuntux I think :-P

You'll need of course a working g++ installation with Mesa and Glut libraries.

Automake, autoconf,autoheader and aclocal must also be installed.

For the mandrake 8, check these packages

automake-1.4-15mdk
autoconf-2.13-7mdk
Mesa-common-devel-3.4.1-4mdk
Mesa-common-3.4.1-4mdk
glibc-2.2.2-4mdk


XFree86-devel-4.0.3-7mdk (Not sure it is mandatory for libGL.so.1)
XFree86-libs-4.0.3-7mdk (idem, (for libGL.so.1)

Under my system, I had to use the following line to link the demo:

c++  -g -O2  -o stuntux   zone.o vect.o triangle.o rectangle.o polyedre.o point.o object.o mecanique.o line.o globj.o fog.o cube.o couleur.o bloc.o CList.o CFps.o  -lGLU -lGL -lglut -L/usr/X11R6/lib

--------
In case you have some difficulties, check for these libraries

        libGLU.so.1 => /usr/X11R6/lib/libGLU.so.1 (0x4002a000)
        libGL.so.1 => /usr/X11R6/lib/libGL.so.1 (0x4004c000)
        libglut.so.3 => /usr/X11R6/lib/libglut.so.3 (0x4006b000)
        libstdc++-libc6.2-2.so.3 => /usr/lib/libstdc++-libc6.2-2.so.3 (0x4009f000)
        libm.so.6 => /lib/libm.so.6 (0x400e7000)
        libc.so.6 => /lib/libc.so.6 (0x40108000)
        libdl.so.2 => /lib/libdl.so.2 (0x40235000)
        libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x40239000)
        libSM.so.6 => /usr/X11R6/lib/libSM.so.6 (0x40325000)
        libICE.so.6 => /usr/X11R6/lib/libICE.so.6 (0x4032e000)
        libXmu.so.6 => /usr/X11R6/lib/libXmu.so.6 (0x40345000)
        libXext.so.6 => /usr/X11R6/lib/libXext.so.6 (0x4035c000)
        libXi.so.6 => /usr/X11R6/lib/libXi.so.6 (0x4036b000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
        libXt.so.6 => /usr/X11R6/lib/libXt.so.6 (0x40373000)

---------

YES BUT HOWTO ?

---------

Just type 

   > ./go

Under stuntux. This will generate the Makefile

    > make

This will compile the demo

   > ./src/stuntux

or (but why to do this)
under root

   # make install
   # exit

  > stuntux 

... to see the demo
... and to see a small sample a bouncing pyramid that demonstrates the
3D engine in action.

-------------

WHAT IF SOMETHING WENT WRONG

-------------

0) All this is only if you are under Linux.

1) Check that all libarires are installed.

2) Remove the config.cache file and try again

3) Check that the GL is correctly setted under your box
   Hey, it is a very good Idea to launch TuxRacer to check that :-)
   
4) Send me a E-Mail wil
	Your system configuration
	The file config.log


If you are not under Linux :
	
1) Try to fix it yourself (ha ha :-))) 
	Why ???
	I hate moneysoft
	
2) give me why my code/configuration steps that were wrong :-P

-------------

CONTACT ME (US LATER)

-------------

0) Contact me only in case you have any contribution,
else, only if you are under Linux (for problems).

Do not contact me yet for features requests. We want to finish
the game before extend it :-P

1) Send me any (very) interresting stuff you made or experimented.

2) Tell me if you'd like to be into the CONTRIBUTORS file if you gave me
   a contribution (Email public, Name public (else, give me a pseudo!))

3) Tell me if you'd like to figure into the FAQ file if you solved a problem.
   (Email public, Name public)
   
-------------
fbiot@free.fr