UTOPIA installation instructions
This document takes you through the steps for installing UTOPIA from scratch on Linux and OS X systems.

Prerequisites
The following software must be installed before building UTOPIA:

Python version 2.3 or later
Qt version 4.2.2 or later
svn version control
scons software construction system
glew OpenGL extension wrangler
Step 1 - Set up your environment
Set the following environment variables:

> export DK=https://dark.cs.man.ac.uk/svn
> export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig

QTDIR needs also to be set, if not already, to the location of your QT libraries. E.g.:

> export QTDIR=/usr/local/Trolltech/Qt-4.2.2/

You'll also need to add /usr/local/lib to your LD_LIBRARY_PATH:

> export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

and to your DYLD_LIBRARY_PATH on OS X.

Step 2 - Build and install GTL libraries
Check out the GTL repository to a suitable location:

> svn co $DK/projects/gtl/snapshot gtl

This will have checked the GTL repository out into a folder called "gtl". Do the following to configure, build and install GTL:

> cd gtl
> scons configure
> scons
> sudo scons install

Step 3 - Build and install XNE libraries
Check out the XNE repository to a suitable location:

> svn co $DK/projects/xne/snapshot xne

This will have checked the XNE repository out into a folder called "xne". Do the following to configure, build and install XNE:

> cd xne
> scons configure
> scons src plugins
> sudo scons install

Step 4 - Build and install UTOPIA libraries
Check out the UTOPIA repository to a suitable location:

> svn co $DK/projects/utopia/snapshot utopia

This will have checked the UTOPIA repository out into a folder called "utopia". Do the following to configure, build and install UTOPIA:

> cd utopia
> scons configure
> scons src apps/libusm/src apps/libambrosia/ambrosia && scons
> sudo scons install

Step 5 - Build Ambrosia
Go to the location where you checked out the UTOPIA repository, and from there to the Ambrosia directory:

> cd utopia/apps/ambrosia

Configure and build Ambrosia:

> qmake
> make

On OS X you can optionally choose to build with Xcode:

> qmake -spec macx-pbuilder

This will create an Xcode project configured to build Ambrosia.

Step 6 - Build CINEMA
Go to the location where you checked out the UTOPIA repository, and from there to the CINEMA directory:

> cd utopia/apps/cinema

Configure and build CINEMA:

> qmake
> make

On OS X you can optionally choose to build with Xcode:

> qmake -spec macx-pbuilder

This will create an Xcode project configured to build CINEMA