Author: Stephen Tarzia, Columbia University.


Documentation
-------------
Full documentation can be found in the user manual: docs/manual.pdf.
This file contains instructions for building the components


Package contents
----------------
mezzanine 	: the visual object tracker.
eleague_output  : the eleague state broadcaster.
TestAI 		: a sample robot control program
command_server	: the motor command server
ClientPrinter	: test program for eleague_UDP
BrickOS		: uleague Lego RCX firmware


Not included
------------
IR transmitter
Lego RCX based robots
Brightly colored fiducials and ball
Third Party libraries


System Requirements
-------------------
Mezzanine is known to work on Linux x86 systems running 2.4.X kernels.


Third party libraries
---------------------
Mezzanine requires the Gimp Toolkit (GTK+ 1.2) available from:
  http://www.gtk.org
Mezzanine also requires the Gnu Scientific Library (GSL 0.9 and above)
available from:
  http://sources.redhat.com/gsl/
Both libraries come as RPMS in RedHat distros, although GSL is 
not usually installed by default.


Building the Package
------------------
Currently, we are not using autoconf, so you will just have
to build it the old fashioned way.  Assuming the required third-party
libraries are installed, you should be able to just:
  
  $ make

from the top-level directory (i.e. the one you found this README in).


Optionally, you may copy some of the binaries into a system folder:

  $ make install



Build Options
-------------
Various build options, including the default installation path for mezzanine,
can be changed by editing Makefile.opt.


Runtime Example
---------------
This section describes how to run a complete test of the system using the TestAI code.

1.  start mezzanine
	$ ./Mezzanine/mezzanine/mezzanine

2.  start eleague output program
	$ ./eleague_ouput/eleague_UDP -p 6363

3.  start the command server
	$ ./command_server/command_server -p 6364

4.  start the AI program
	$ ./TestAI/TestAI --verbose