Mirage install instructions
From Tekkotsu Wiki
Mirage is a simulation environment that provides Tekkotsu (running on a workstation instead of a robot) with a virtual world.
Installing Mirage Under Ubuntu 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 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. Easy way:
apt-get -y install libois-dev
Alternative method (manual install): go to the OIS web page and download the latest release. In this example the file is called ois_1.2.0.tar.gz.
tar xzf ois_1.2.0.tar.gz cd ois ./bootstrap ./configure make -j4 sudo make install
4. Install FreeType. Easy way:
apt-get -y install libfreetype6-dev
Alternative method (manual install): go to the FreeType project download page and click on a stable release. Note: do not mistakenly select the .sig file or a freetype-doc file instead of the source tarball. The file you download should have a name like freetype-2.3.12.tar.bz2. Place it in /tmp. Then:
cd /tmp tar xjf freetype-2.3.12.tar.bz2 cd freetype-2.3.12 ./configure make -j4 sudo make install
The "make install" may print an error message about failure to remove a non-existent file. This can be ignored.
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 cmake .. -DOGRE_BUILD_SAMPLES=OFF make -j4 make install
6. Install release 2531 (might not be 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 cmake -DBUILD_SHARED_LIBS=ON -DBUILD_EXTRAS=OFF -DBUILD_DEMOS=OFF -DINSTALL_LIBS=ON 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