Mirage install instructions

From Tekkotsu Wiki

Revision as of 15:44, 29 April 2015 by Touretzky (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Mirage is a simulation environment that provides Tekkotsu (running on a workstation instead of a robot) with a virtual world.

Installing Mirage Under Ubuntu 14.04 or 12.04

1. Install hardware graphics drivers. If you are running Ubuntu on a Mac using an emulator, skip this step and proceed to step 2. If you are running on a machine using the Intel GMA 3600 graphics chip set, you may not be able to run Mirage due to lack of a fully functioning device driver.

Ubuntu installs by default with the Mesa indirect software renderer, but OGRE3D requires the hardware driver specific to the graphics board being used. To check whether you have the hardware graphics driver installed on your workstation or laptop, type:

sudo apt-get install mesa-utils
glxinfo | head

If the vendor string is "ATI' or "nVidia" then you're using the hardware driver and can skip the rest of this step. If the "server glx vendor string" is "SGI", then you're using the Mesa renderer and may need to find and install the hardware driver for your board. However, some Intel and nVidia graphics boards do work acceptably with Mesa.

To find the manufacturer and model number of your graphics board, do:

lspci | grep VGA

Try turning on the hardware graphics driver by going to System > Administration > Hardware Drivers.

If you don't have a suitable hardware graphics driver, you may be able to install one using jockey-gtk:

sudo apt-get install jockey-gtk

2. Install library packages Ogre depends on:

sudo -s
apt-get update
apt-get -y install libfreeimage-dev libxrandr-dev libgl1-mesa-dev libglu1-mesa-dev

Install packages for building various additional libraries

apt-get -y install subversion libtool automake autoconf libxaw7-dev cmake

3. Install OIS, the Object Oriented Input System.

apt-get -y install libois-dev

4. Install FreeType.

apt-get -y install libfreetype6-dev

The following must be done on Ubuntu 14.04 systems for compatibility with OGRE 1.7.4:

cd /usr/include/freetype2
ln -s . freetype

5. Install the OGRE3D rendering system version 1.7.4:

cd /opt
wget http://downloads.sourceforge.net/project/ogre/ogre/1.7/ogre_src_v1-7-4.tar.bz2
tar xjf ogre_src_v1-7-4.tar.bz2
cd ogre_src_v1-7-4
mkdir build
cd build
make -j4
make install

Note: if you get an "internal compiler error" with gcc 4.8, just type "make" again.

You can obtain other Ogre releases by going to the OGRE Sourceforge download page (latest release) or the OGRE3D source download page and clicking on the version you want.

6. Install release 2531 (not the latest release) of the Bullet physics engine. Download it from the subversion repository and compile it by following the steps below.

cd /opt
svn checkout -r 2531 http://bullet.googlecode.com/svn/trunk/ bullet-280
cd bullet-280
make -j4
sudo make install

7. Build Mirage. First check the file /usr/local/Tekkotsu/tools/mirage/Resources/plugins.cfg and verify that PluginFolder is set to the Ogre library; by default this is /usr/local/lib/OGRE. Then:

cd /usr/local/Tekkotsu/tools/mirage
sudo make -j4

See the article on Running Mirage for how to test your Mirage installation.

Installing Mirage Under Mac OS X

Just follow the Mac instructions on the main Mirage page

Mirage WorldBuilder Tool

The Mirage WorldBuilder tool is included in the Tekkotsu/rools/mirage directory, but it depends on some Ruby packages that are not installed by default. To install these packages, do:

sudo apt-get install ruby rubygems
sudo gem install plist treetop