Instructions for Building LittleDog Software

I've successfully gotten the code to build on Ubuntu 8.04 and RedHat Enterprise Linux. Also works on MacOS X. Other platforms might be significantly hairier to get working.

Ownership

All code is copyright © Matt Zucker unless otherwise specified. You can download and use it for 16711 or 16899 projects; you need permission from Matt if you want to use it for any other purpose. Do not redistribute the code.

Download

Source code tarball is at http://gamedev.cs.cmu.edu/littledog/ldmz.tgz (31MB)
Extra (large) terrain models are at http://gamedev.cs.cmu.edu/littledog/ldmz-terrains.tgz (259MB). Don't worry about these until after you've gotten the source to build.

Prerequisites

You will need the following software packages installed to build:

libpng and zlib (included) - Ubuntu: libpng12-dev
expat - Ubuntu: libexpat1-dev
GNU Scientific Library (GSL) - Ubuntu: libgsl0-dev
Qt 3 (multi-threaded version) - Ubuntu: libqt3-mt-dev
QWT 5 - Ubuntu: libqwt5-dev

The code is built using CMake 2.4.7 or better (Ubuntu: cmake).

You will also need the Open Dynamics Engine library. Download version 0.10 from sourceforge and then "configure --with-trimesh=GIMPACT" before you install it with make and make install.

Eventually, you might need qslim to simplify terrain model files. It doesn't build with modern compilers (g++ 4 or greater). I can help when you get to this step.

Build

Untar the code. Then:

cd ldmz cmake . make

At this point you should have the code built or else there will be errors (email me if you run into any problems you can't fix).

If the code has built, you will need to add some lines to your .bashrc in order to run the programs:

export LD_MZ=path_to_code/ldmz/share export LITTLEDOG=path_to_code/ldmz/share

You can run the simulator by "cd taskdog; taskdog -s flat.txt". It should look something like this:

Email me for ideas on what to do next!