= Orxonox 2: 3D Engine Evaluation =

Orxonox needs a new stable engine with good documentation and a healthy community. Things we need to do before the next Thinktank:

 * Get the engine work on Unix and Windows
 * Write a test app which load the moonbase .bsp level from Orxonox, it should:
   * have an FPS style control for walking through the level
   * collision detection with walls and ground
   * display frame-rate informations
 * Collect howto documents on getting started with the engine
 * List advantages and disadvantages of every engine
 * You may: Start your application with valgrind: {{{ valgrind ./executable }}} and look for memory issues within the engine (ignore OpenGL driver leaks there are lots)
 * You may: Create a screenshot similar to [https://forum.orxonox.net/viewtopic.php?t=173 this] for comparison.

-------
== Ogre3d ==
 * Link: http://www.ogre3d.org/
 * Who: x3n, nico
 * Version:
 * License: LGPL (compatible with the GPL)
 * Pro: Mature Project
 * Con:

=== Details ===


=== Installation ===


=== Load a BSP level ===
Link: http://www.ogre3d.org/wiki/index.php/How_to_create_BSP_files_using_GtkRadiant


--------
== Crystal Space 3D ==
 * Link: http://www.crystalspace3d.org/
 * Who: Nowic (Linux), Hofzge and Beni (Windows)
 * Version: 1.0.2
 * License: LGPL (compatible with the GPL)
 * Pro: Mature Project, good Blender integration
 * Con: BSP support?

=== Details ===
http://sourceforge.net/projects/crystal

http://de.wikipedia.org/wiki/Crystal_Space

Blender2Crystal Tool:
 * Info: http://b2cs.delcorp.org/index.php/General_Overview
 * Presentation (stream): http://video.google.com/videoplay?docid=7397461012210656011
 * Presentation (download): http://www.blender.org/fileadmin/bconf06/bc06-2010-04-blendercrystal.mp4.torrent 


=== Installation ===
==== Linux ====

'''Package Repositories:''' 

The Debian (unstable) and Ubuntu (feisty) package (it's the same) for crystalspace is outdated and mispackaged. Do not use it!
Let's hope they will fix it soon (Bug reported).

There is an unofficial debian repository for blender2crystal and CS for debian, ubuntu edgy and dapper. The packages for unstable work on testing too. The edgy packages should also work with feisty.

you must add the following line to your /etc/apt/sources.list:
{{{
deb http://b2cs.delcorp.org/debian/ unstable main
}}}
or on Ubuntu:
{{{
deb http://b2cs.delcorp.org/debian/ edgy main
}}}
Install the packages:
{{{
# aptitude update
# aptitude install crystalspace-dev cel-dev blender2crystal-sdk
}}}


'''Manual installation:'''

'''Ubuntu 7.04 Festy:''' Works with ODE disabled (version is too old)

'''Ubuntu 7.10 Gutsy:''' Everything should work (not tested yet)

'''Debian Etch (stable):''' Does not work. Many libs are outdated.

'''Debian Lenny (testing):''' Works great.

'''Debian Sid (unstable):''' Should work great too (not tested yet)

'''"walktest" System Test:'''
 * Thinkpad T42 with free 'radeon' driver: working, some font bugs, low performance
 * P4 1.8, Gforce 3, proprietary driver: works great, only shaders are disabled

Ubuntu:
{{{
# aptitude install zlib1g-dev libpng12-dev libjpeg62-dev freetype6-dev libode0-dev libcal3d11-dev lib3ds-dev libogg-dev libmng-dev libcegui-mk2-dev libwxbase2.8-dev libcaca-dev libcgal-dev libx11-dev libasound2-dev libice-dev libsdl1.2-dev libvorbis-dev libcppunit-dev python2.5-dev
}}}

Debian:
{{{
# aptitude install zlib1g-dev libpng12-dev libjpeg-dev libfreetype6-dev libode0-dev libcal3d-dev lib3ds-dev libogg-dev libmng-dev libcegui-mk2-dev libwxbase-dev libcaca-dev libcgal-dev libx11-dev libasound2-dev libice-dev libsdl1.2-dev libvorbis-dev libcppunit-dev python2.5-dev
}}}

{{{
$ cd crystalspace-src-1.0.2
$ ./configure
$ make
}}}

http://www.crystalspace3d.org/main/Walktest_Tutorial

{{{
$ ./walktest
}}}

Some other nice tests: waterdemo, ceguitest, phystut, g2dtest, ... and many more

==== Windows ====
TODO



=== Load a BSP level ===
There's an outdated [http://community.crystalspace3d.org/tiki-print_article.php?articleId=15 tutorial] that uses the map2cs converter to get a CS level from a bsp map. This map can be loaded directly with the "walktest" tool. But they dropped the support for map2cs (it was buggy I think). Now they force the users to use blender for all CS tasks.


[http://www-poleia.lip6.fr/~degris/converter/ Counter-Strike to Crystal Space 3D converter] is another tool to convert bsp maps (in python). I tried to install it, but I always get python errors. It seems outdated too. Anyone motivated to do some python debugging?

Converter dependecies (maybe incomplete):
{{{
# aptitude install imagemagick python-imaging python-elementtree
}}}

Till now, I couldn't find a direct way to import bsp levels or a working level converter. Maybe we should start flaming in their forum...



--------
== Irrlicht ==
 * Link: http://irrlicht.sourceforge.net/
 * Who: Patrick
 * Version:
 * License: zlib License (compatible with the GPL)
 * Pro:
 * Con: Young Project

=== Details ===

=== Installation ===

=== Load a BSP level ===
Link: http://irrlicht.sourceforge.net/tut002.html