Get it Running

TracNav(TracNav/TOC)?

Debian GNU/Linux

Debian Sarge

Orxonox does not run on the official version of Debian Sarge because libqt4 is missing. Maybe using a backport of QT4 from ​http://backports.org/ could solve this problem. (not tested yet)

Debian Etch (Testing)

Installing Orxonox on Debian Etch (aka Testing). Installing on Debian SID (aka Unstable) should work too (not tested).

Installing the Libraries

wraith root # apt-get install libsdl1.2-dev libsdl-image1.2-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-net1.2-dev libqt4-dev libglut3-dev libglew-dev libopenal-dev libvorbis-dev libavformat-dev libcurl3-dev liblualib50-dev 
...

Installing developer tools

wraith root # apt-get install subversion automake g++

Getting the Source & Data

Check out the source and data via svn anonymous, this will download the hole project to the directory orxonox-dir

wraith user $ svn co http://svn.orxonox.net/orxonox orxonox-dir
wraith user $ svn co http://svn.orxonox.net/data orxonox-dir/data 

You won't be able to commit (check in) anything with the anonymous repository. You have to ask us for user/pass combination. If you have already an account check it out like this:

wraith user $ svn co https://svn.orxonox.net/orxonox orxonox-dir
wraith user $ svn co https://svn.orxonox.net/data orxonox-dir/data 

You will be asked for user name and password, that you have from us.

Compiling

Just change into the trunk directory, execute configure and make….

wraith user $ cd ./orxonox/trunk/
wraith user $ ./autogen.sh
wraith user $ ./configure
...
wraith user $ make

Playing

wraith user $ cd ./orxonox/trunk/src
wraith user $ ./orxonox

Select the data file orxonox/data/trunk/data.oxd in the menu and play!

Profiling

If you want to profile (performance measureing) orxonox you will probably want to view the statistics in a special program like kprof.

wraith root # apt-get install kprof

Orxonox runs much much slower with profiling enabled, so don't be embarassed!

wraith user # cd ./orxonox/trunk/
wraith user # ./configure --enable-profile
...
wraith user # make
...
wraith user # cd src
wraith user # ./orxonox

Ok. Orxonox runs now (very slow) and writes its profiling stats to a file called gmon.out. Remember that _only_ those functinalities, that you are using while running the program will be profiled (since the profile log is written while the program is been executed).
After you exit the application, you will have to parse the output file and then you are able to open it in kprof application:

wraith user # gprof -b ./orxonox > text.out
wraith user # kprof -f text.out

For more documentation see the DevelopmentResources.