Heilan Front End
----------------

Description:
------------
A GUI front end to the command line Heilan X3D browser, based on the JUCE
toolkit.  This program just exposes Heilan's options in graphical form.


Usage:
------
Configurations may be saved and reloaded as .hfe files.  You can also save a
default configuration, and it's recommended that you do this when you first
run it.  Specifically, you will have to set the path to the Heilan browser and
(if you want to use the extra nodes and navigation types) add libheilanextras
to the list of libraries.  The default configuration is stored as
HeilanFrontEndDefaults.hfe (in your home directory on Linux, in
\Documents and Settings\username\Application Data on Windows).

Most of the options available should be fairly self-explanatory.  Speaker
configuration refers to how the Ambisonic audio engine outputs sound - to how
many speakers and in what spatial arrangement they're placed.  It should be
fairly obvious from their names how many speakers each preset caters to. OSC
port is the port that Heilan will listen on for OSC messages.  The 'Record OSC
to' control will take a file to save any OSC messages Heilan receives to.  If it
is empty, Heilan will not record anything.  The offline button will run Heilan
in offline mode, where it will save its audio speaker feeds to .wav files, and
its video as sequentially-numbered jpegs (you can then combine these into a
video file with something like mencoder).

Compilation:
------------
The front end is written using JUCE v0.46 (an svn version).  It is included in
the source packages in its amalgamated form though, so you don't have to
download JUCE separately.

Credits:
--------
My PhD supervisors: Dr. Nick Fells and Dr. Nicholas Bailey.



Niall Moody,
Centre for Music Technology,
University of Glasgow.
