En/Get OpenAnno

From OpenAnno

(Redirected from En/Compiling)
Jump to: navigation, search

The following article contains instructions to download and install OpenAnno.

Contents

The Basics

  • First of all, nobody should be discouraged by the length of this article. It just covers a lot of issues.
  • Please, previously read everything relevant for you exactly.
  • Generelly it is not necessary to compile OpenAnno. Merely the libraries for executing Python files are needed. For Linux they are mostly pre-installed and for Windows easy to post-install. (How it is done exactly is explained further below.)
  • Developers or people maybe going to get one can download the current SVN revisions of FIFE and OpenAnno and compile the engine themselves. (How this is done exactly is also explained further below.)

Download last stable version

The last official and stable Release of OpenAnno can always be found here.

  • For Windows there is an installer shipping with Python and OpenAL.
  • For Linux a tar.gz archive with binaries for FIFE and the stable OpenAnno release each for 32bit- and 64bit-architecture.

Common users can now stop reading this article right here.

Download and compile SVN revision

Build dependencies

Supported build environments

Supported compilers

Framework

SDL addon libs

  • SDL_ttf >= 2.0
  • SDL_image

Sound libs

  • libvorbis
  • libvorbisfile
  • libogg
  • OpenAL

GUI/RAD libs

Scripting-related libs

Compression libs

Optional libs

  • libopengl & libglu >= 1.3: for additional OpenGL support.

SVN clients

A SVN client is required to download the SVN revision. The following list provides some recommendations for software to use. A detailed list of clients can be found on Tigris.org .

SVN web interface

  • The OpenAnno code can be viewed online via webinterface.

Windows

Linux

Multi-platform

LINUX

Resolve build dependencies

Debian/Ubuntu 

apt-get install -y build-essential scons libalsa-ocaml-dev libsdl1.2-dev libboost-dev libsdl-ttf2.0-dev⏎
libsdl-image1.2-dev libvorbis-dev libalut-dev python-dev libboost-regex-dev libboost-filesystem-dev⏎
libboost-test-dev swig zlib1g-dev libopenal-dev subversion

Gentoo 

emerge --ask --verbose --noreplace libvorbis libogg media-libs/openal guichan boost libsdl sdl-image⏎
sdl-ttf scons subversion

Check out SVN revision

FIFE SVN:

OpenAnno SVN:

  • svn://openanno.org/openanno/trunk

The most simple and fastest way on Linux is - as often - using the command line in a terminal. Experienced user will know themselves what to do. Therefore a detailed example for the less experienced ones will follow here:

  • Start a terminal, switch to the /home folder and create the directory structure for FIFE and OpenAnno: 
:~$ mkdir openanno && cd openanno
:~/openanno$ mkdir fife openanno
  • Then download the SVN revisions of FIFE and OpenAnno into the corresponding folders: 
:~/openanno$ cd fife && svn co http://svn1.cvsdude.com/fife/engine/trunk
:~/openanno/fife$ cd ../openanno && svn co svn://openanno.org/openanno/trunk
  • To update to a newer revision just run a SVN update in the corresponding folders: 
:~/openanno/fife/trunk$ svn up
resp.
:~/openanno/openanno/trunk$ svn up

Compile FIFE

If all build dependencies are resolved successfully (see above) FIFE should compile problem-free. Because of some libraries causing troubles the FIFE SVN repository was extended with source files of some libraries which can be compiled and installed using the command scons ext=1 if wanted. (This involves guichan, openAL-soft and libpng.) In general this is the recommended procedure why this step is picked up in the following example as well.

  • To compile FIFE just switch into the /trunk directory and use the following command: 
:~/openanno/openanno$ cd ../fife/trunk
:~/openanno/fife/trunk$ scons ext=1 && scons
  • Optionally, FIFE can be compiled without debug to get more performance for gameplay: 
:~/openanno/fife/trunk$ scons ext=1 && scons debug=0
  • If FIFE is already compiled and an SVN update is made it has to be recompiled.
  • OpenAnno itself does not need to be compiles because it entirely acts as scripts and media (graphics, sound and so on).

The allround-script

This script downloads the current FIFE revision, compiles the engine, followed by downloading the current OpenAnno revision and moving it into a separate sub-folder. For all of you in hurry or to lazy to type.

Start OpenAnno

  • To start OpenAnno just the openanno.py has to be executed. Therefor different possiblilities exist: 
:~/openanno/openanno/trunk$ python openanno.py
or
:~/openanno/openanno/trunk$ ./openanno.py
odr from anywhere
:/$ python ~/openanno/openanno/trunk/openanno.py
  • If the start file openanno.py was set executable it can be started via double click in a file manager.
  • Optionally OpenAnno can be integrated in you system to get started by typing openanno in command line, script or launcher only. Thereto the following commands have to be executed in terminal with root permission: 
:~# echo '#!/bin/bash' > /usr/bin/openanno
:~# echo 'python ~/openanno/oa/openanno.py' >> /usr/bin/openanno
:~# chmod +x openanno

Windows

Resolve build dependencies

Check out SVN revision

FIFE SVN:

OpenAnno SVN:

  • svn://openanno.org/openanno/trunk

Compile FIFE

Start Openanno

Retrieved from "http://www.openanno.org/wiki/index.php/En/Get_OpenAnno"
Personal tools