Gentoo Linux

Edited: 18. Sep. 2008 by Oli?
Edited: 15. Sep. 2008 by Felix?
Checked: 01. Dec. 2007 by nico? with 2007.0 profile on amd64
Checked: 02. Nov. 2007 by nico? with 2007.0 profile on x86

This Tutorial assumes that you are using x86. If you are using amd64 just substitute the keyword.

Prerequisites

Orxonox uses Ogre with CEGUI for rendering, OIS for input handling, eNet for network support Boost for threading and cMake as build-system. You will have to install these packages. Every needed package is in portage.

Add USE-Flags:

# echo "dev-games/cegui devil expat" >> /etc/portage/package.use
# echo "dev-games/ogre cegui devil lua threads" >> /etc/portage/package.use

Some packages are unstable, for portage to use them do:

# echo "dev-games/ogre-1.4.5 ~x86" >> /etc/portage/package.keywords
# echo "dev-games/ois-1.0 ~x86" >> /etc/portage/package.keywords

Then, emerge the packages. CEGUI and Boost are dependencies of Ogre, so they will not be installed explicitly. TCL is also mandatory.

# emerge cmake ogre ois tcl
# CFLAGS="-fPIC" emerge enet

eNet needs to be compiled with -fPIC to be included as shared library (nico?: Dec '07).

Getting the Source Code

If you have not done so already, you need to install Subversion on your system. To do this, make sure that you have ssl included in your make.conf file:, which is normally located at /etc/make.conf:

 ...
 USE="..., ssl, ..."
 ...

Now emerge subversion:

# emerge subversion

Now get a copy of the code by checking out the trunk via anonymous subversion login. This will download the latest stable version to the directory trunk. If you have trouble using SVN, go here?.

$ svn co http://svn.orxonox.net/orxonox/trunk trunk

You won't be able to contribute your own code (check in) with the anonymous subversion repository. You have to ask us for a username/password combination. If you already have an account, check the code out like this:

$ svn co https://svn.orxonox.net/orxonox/trunk trunk

You will then be asked for the username and password, that you got from us.

Furthermore, you will need to check our data repository. This repository contains all the graphics, fonts and sounds and other third-party datafor Orxonox. To check it out use the command:

$ svn co https://svn.orxonox.net/data/Media media

Now make sure, you have set the correct path to your media directory in the file bin/orxonox.ini.

Compiling

Just cd to the trunk directory, then execute configure and make:

$ cd orxonox-trunk
$ cmake .
...
$ make -j4 // -j4 means 4 jobs concurrently (for those of you with multicore cpus)
...
$ ./run

Additionally if you don't want to built into your source directories perform the following steps instead:

$ cd orxonox-trunk
$ mkdir build
$ cd build
$ cmake ..
...
$ make -j4
...
$ cd ..
$ ./run

Development with KDevelop

If you would like to use KDevelop for coding, see this? page for further information.