= Get it Running = [[TracNav(TracNav/TOC)]] == Gentoo == The easy and fast Way: 1. go out and get the ebuild: source:/trunk/scripts/gentoo#HEAD (download newest ebuild) 1. get to be root {{{ wraith root # su - }}} 1. copy it to /usr/portage/games-action/orxonox (create directory) 1. {{{ 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/index.php link] * SDL_image, media-libs/sdl-image, web: [http://www.libsdl.org/index.php link] * SDL_(true type fonts), media-libs/sdl-ttf, web: [http://www.libsdl.org/index.php link] 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-mixer ... }}} Gentoo is now ready to compile and run orxonox :) [[br]] === 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:[[br]] '''/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). [[br]] 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.