An article of the campaign wiki, as the Internet Archive captured it at wiki.ryzom.org/en on 12 February 2007. Wiki index · All captures
The Free Ryzom Campaign and the Virtual Citizenship Association
These are the instructions to install the [Delta3D] on Ubuntu 6.10. They are based on the [Installing Delta3D on Ubuntu 6.06] official document, updated for Ubuntu 6.10.
This is work in progress, don't use this page for now.
Add the Universe and Multiverse repositories. See [this page] on the Ubuntu website for full instructions. A lot of the packages we will need to install will come from Universe repository. You will need Multiverse in order to install your binary video card drivers.
Install any operating-system updates. If any are available, an orange icon will usually appear in the upper-right corner of the screen. Click this icon to update your software. Alternatively, choose System->Administation->UpdateManager
Follow the excellent UbuntuWiki tutorial here. Make sure to install the developer package of the drivers (nvidia-glx-dev or xorg-driver-fglrx-dev).
Install the binary dependencies that are available in Ubuntu repositories. Open a terminal (Applications->Accessories->Terminal) and paste this onto the command line (all as one line!):
sudo apt-get install build-essential libcal3d11-dev libcppunit-dev libfltk1.1-dev libgdal1-dev libopenal-dev libalut-dev libboost-dev libboost-python-dev libxerces26-dev uuid-dev libncurses5-dev libxxf86vm-dev autoconf automake1.9 libxt-dev libxmu-dev libdevil-dev freeglut3-dev libtiff4-dev liblcms1-dev libmng-dev libungif4-dev libtool scons doxygen
These take care of most of Delta3D's dependencies. In fact, the biggest benefit of using Ubuntu is that they have so many binray dependencies available for our use. However we will need to build the remaining ones from source.
Ubuntu does have a package called libcegui-mk2-dev, but unfortunately it is missing the file libCEGUIOpenGLRenderer.so (the OpenGL renderer, which as you can imagine, is quite important). Feel free to follow the Ubuntu bug report on this issue. Until they fix it, we're stuck building from source. Grab the source from CEGUI's download page. Open a terminal and navigate to where you downloaded the archive:
tar xvfj cegui_mk2-source-0.4.1.tar.bz2 cd cegui_mk2 ./configure make sudo make install
Once again, PLIB has a binary in the Ubuntu repository but there is a problem with it: the JS library (which Delta3D uses) is missing from the package. Here's the Ubuntu bug report. Grab the source here. Open a terminal and navigate to where you downloaded the archive:
tar xvfz plib-1.8.4.tar.gz cd plib-1.8.4 ./configure make sudo make install
Savy users will note the binary libode0-dev in the Ubuntu repository, but alas, that is missing symbols for the OPCODE section of the ODE project (which handles mesh collisions). Hmm, no bug report on this one. Grab the source here. Open a terminal and navigate to where you downloaded the archive.
tar xvfz ode-0.5.tgz cd ode-0.5
To use ODE with Delta3D you must alter a config file. These can be configured by manually editing the file ode-0.5/config/user-settings. Precision needs to be set to SINGLE, and the OPCODE line needs to be uncommented so it will compile that into ODE. Then go ahead and compile.
./configure make cp -r include/ode /usr/local/include cp lib/libode.a /usr/local/lib
Next up we have HawkNL. It does not exist in the Ubuntu repositories (as of Dapper). Grab the HawkNL source and the GNE source. Since GNE depends on HawkNL, let's compile HawkNL first. Open a terminal and navigate to where you downloaded the archive:
unzip HawkNL168src.zip cd HawkNL1.68 make -f makefile.linux sudo make -f makefile.linux install
Now onto GNE. Open a terminal and navigate to where you downloaded the archive:
tar xvfj gnelib-0.70.tar.bz2 cd gnelib-0.70 ./fixlinux.sh make sudo make install
These are not available from Ubuntu repositories, but they come in binary form on as a download on the InterSense support page. Note: Intersense has changed their download policy and the previous link will not work. We're working on a solution. 10/10/06
You must copy the headers and libraries to install directory (here we are using /usr/local):
unzip isense.zip sudo cp isense/types.h /usr/local/include sudo cp isense/isense.h /usr/local/include sudo cp isense/Linux/x86/libisense.so /usr/local/lib
These indeed have Ubuntu-packaged versions, but they are stuck at version 0.9.9, which is incompatible with Delta3D. You can monitor the request for an upgrade here. Grab the source. Open a terminal and navigate to where you downloaded the archive:
unzip OSG_OP_OT-1.0.zip cd OSG_OP_OT-1.0 cd OpenThreads; make; sudo make install; cd .. cd Producer; make; sudo make install; cd .. cd OpenSceneGraph; make sudo make install
This package does not appear in the repositories. Grab the source here. Open a terminal and navigate to where you downloaded the archive.
tar xvfz replicantbody-2006-08-11.tgz cd replicantbody-2006-08-11 autoreconf --install --force ./configure --prefix=/usr/local make sudo make install
Unfortunately, the install target is still slightly broken, and you must copy the headers manually (and clean up Makefiles that come along with them).
sudo cp -r include/* /usr/local/include
sudo find /usr/local/include -name "Makefile*" -exec rm {} \;
Remember, the latest version that fully works with Delta3D is 4.0.1. Later versions (especially in the Qt 4.1 line) have some serious bugs. Building Qt is easy (but long): grab Qt 4.0.1's source. Open a terminal and navigate to where you downloaded the archive.
tar xvfz qt-x11-opensource-src-4.0.1.tar.gz cd qt-x11-opensource-src-4.0.1 ./configure -qt-gif make sudo make install
Oh, and don't forget to set an environment variable QTDIR to point to your install directory (the default is /usr/local/Trolltech/Qt-4.0.1).
List of packages to download:
That's it for the dependencies, now onto the main show: building Delta3D. Grab the source from a release version, nightly snapshot, or directly from Subversion. Untar it somewhere and get compiling.
tar xvfj dt_src_1.3.0.tar.bz2 cd delta3d scons sudo scons install
Type scons -h for information about command-line build options. If SCons says that any dependencies are not found, please go back and double-check you followed all the steps exactly as above. More information about why a dependency check failed can be found after the first run in the config.log file. If you want to use the Python bindings, then make sure to copy the PyDt libraries into a spot where Python can find them. You can use the environment variable PYTHON_LIB_PATH to add new search paths for Python modules.