This is a tutorial on how to install the various dependencies needed to work on this project.
Before starting, you will need to install the following tools :
- build-essential (or the windows equivalent with at least a compiler and make)
- git (You are probably reading this on github anyway...)
- CMake
- Doxygen
This tutorial assumes that you know how to use these tools.
As mentioned in the README, you will need the following libraries to build the project :
- Boost 1.52 or better
- OGRE 3D 1.8.1
- Bullet 2.82
- OgreBullet, can be found here : https://bitbucket.org/alexeyknyshev/ogrebullet
- LibOVR (from the Oculus Rift's SDK) 0.2.5c
We'll go through them one by one.
### Boost
- Download the last version from the boost website.
- Unpack it.
- With the console, move to the directory where you unpacked boost and compile/install it using
b2
. Don't forget to indicate the proper toolset. If you are using mingwg, you will need to typeb2 toolset=gcc
. The complete list of toolsets can be found here.
Note that on Windows, LibOVR is currently (2014-03-27) only suppports vc++. A thread exists on the Oculus forum if you want to build it with mingw. Otherwise, use the msvc toolset.
Install with sudo apt-get install libboost-all-dev
.
An actual tutorial can be found here.
- Download OGRE 1.8.1 from the OGRE website.
- Run the installer.
- Set the OGRE_HOME environement variable with
setx OGRE_HOME "<path-to-OgreSDK-here>"
- Download OGRE 1.8.1 from the OGRE website.
- Use CMake to generate the makefile.
- Run
make && sudo make install
.
### Bullet
- Download Bullet 2.82 from the Bullet download page.
- Unpack it.
- Use CMake to generate the makefile.
- Run
make
. - Set the BULLET_ROOT environement variable with
setx BULLET_ROOT "<path-to-BulletBuild-here>"
- Download Bullet 2.82 from the Bullet download page.
- Unpack it.
- Use CMake to generate the makefile.
- Run
make && sudo make install
.
A tutorial can be found here.
- Clone the OgreBullet repository with
git clone https://bitbucket.org/alexeyknyshev/ogrebullet
. - Use CMake to generate the makefile.
- Run
make && sudo make install
.
- Sign in/up in the OculusVR website.
- Download version 0.2.5c from the download page.
- Sign in/up in the OculusVR website.
- Download version 0.2.5c from the download page.
- Set the LIBOVR_DIR environement variable with
setx LIBOVR_DIR "<path-to-LibOVR-here>"
- Clone the project from gihub.
- Use CMake to generate the makefile.
- Run
make
.