MussaGL Build Info

General Requirements

• Qt4.1.x - ​Linux | ​Mac OS X | ​Windows (4.1.2, 4.1.3, and 4.1.4 each new version seems to have a few less minor bugs that affects Mussa.)
• ​Boost C++ Libraries (program_options, test, python modules)
• ​Python The current version also includes the python interpreter. (This isn't a strong dependency right now and could probably be broken if desired.)
• Mussagl Source (See download section)
• ​CMake >= v2.4

Windows XP Requirements

• ​MingGW (gcc compiler and tools for Windows... Qt4.1 installer will install it for you).

OS X Universal Build

As of darcs patch [300] mussa now builds as a universal binary on os x. This unforunately means you'll need OS X Universal Dependencies

CMake Build commands

Note: Requires cmake version >= 2.4

To check your current version, type:

cmake --version

CMake has several advantages over qmake or standard make files for multiplatform development. One advantage is that it lets one build out of source (which makes clean up if a build goes wrong much easer.)

More generally it takes the place of the GNU autotools, but is far more comprehensible--even with limited documentation.

After installing cmake, change to the mussa source directory and do the following.

mkdir build
cd build
cmake ..
make
qui/mussagl

(Yes its annoying that the executable is dropped in a subdirectory, I hope that as I learn more about cmake I can fix that).

To run the unittests from with in the build directory type

make test

or

ctest 

Some useful alternate modes for cmake are:

make VERBOSE=1

which will show the actual commands being used to compile the program, and

ctest -VV

which will show the output of the various test programs.

QMake Build Command

Building with qmake (this can only build mussagl, it doesn't build the python interface or the unittests)

qmake
make

Troubleshooting

If running make generates a large number of error messages, you mostly likely ran the qt3 version of qmake.

qmake -version

should report

QMake version: 2.00a
Using Qt version 4.1.0 in [wherever qt4 was installed]

If necessary you can download qt4 from ​http://www.trolltech.com/download/opensource.html