| Version 8 (modified by bensch, 19 years ago) (diff) |
|---|
Get it Running
Gentoo
The easy and fast Way:
- go out and get the ebuild: source:/trunk/scripts/gentoo#HEAD (download newest ebuild)
- get to be root
wraith root # su -
- copy it to /usr/portage/games-action/orxonox (create directory)
-
wraith root # cd /usr/portage/games/action/orxonox wraith root # ebuild orxonox-*.ebuild digest wraith root # emerge orxonox
by now you should be able to play orxonox, and when you have a login and subversion, you will also be able to develop→read on.
Installing the Libraries
Install the following libraries:
- SDL main, media-libs/libsdl, web: http://www.libsdl.org/
- SDL_image, media-libs/sdl-image, web: http://www.libsdl.org/SDL_image
- SDL_(true type fonts), media-libs/sdl-ttf, web: http://www.libsdl.org/SDL_ttf
- SDL_net, media-libs/sdl-net, web http://www.libsdl.org/SDL_net
Here are the explicit commands to enter:
wraith root # emerge media-libs/libsdl ... wraith root # emerge media-libs/sdl-image ... wraith root # emerge media-libs/sdl-ttf ... wraith root # emerge media-libs/sdl-net ...
Gentoo is now ready to compile and run orxonox 
Getting the Source
First of all you will have to install subversion on your system: Make sure, that you have ssl included in your make.conf file:
/etc/make.conf
... USE="..., ssl, ..." ...
now emerge the subversion program
wraith user # emerge subversion
Check out the source 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
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
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 # ./configure ... wraith user # make ... wraith user # cd src wraith user # ./orxonox
Profiling
If you want to profile (performance measuring) Orxonox you will probably want to view the statistics in a special program like kprof. On Gentoo systems you can just emerge it:
wraith root # emerge 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 now runs very slow and writes its profiling stats to a file called gmon.out. Remember that _only_ those functionalities, 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.
