
                      GNU Maverik beta package v1.4



Introduction
============

The Maverik beta package contains additional code that is "work in
progress" - it might be useful to you, but it is not in a "complete"
state. By this we mean the code is undocumented; needs cleaning up;
may not be fully functional; may change in future; and may not compile
on your platform (although it has been tested on Irix and Linux). In
short, use it at your own risk.
 
It is beta code that, once polished, we intend to put into the main
distribution. But (a) you might find it useful now, and (b) we'd be
interested in any feedback.



License
=======

This software is distributed under the same terms as Maverik, namely
the GNU General Public License.



Contents
========

The current beta package consists of a collision detection library and
a force field navigation technique.



Unix Installation
=================

The beta package requires a post 6.0 version of Maverik to be present
(any later version should suffice). To install the beta package untar
maverik-beta-1.4.tar.gz in the top level Maverik directory. The source
code will be installed in src/extras/beta and the include files in
incl. To compile the beta package simply type "make" in the top level
Maverik directory.

Cygwin users: you need to re-execute the Maverik "setup" script in the
top level directory if you have downloaded the beta package after you
have compiled the main Maverik distribution.



Windows Installation
====================

The beta package requires a post 6.0 version of Maverik to be present
(any later version should suffice). To install the beta package unzip
maverik-beta-1.4.zip in the top level Maverik directory. The source
code will be installed in src/extras/beta, include files in incl and
Visual C++ project files in vc++ . To compile the beta package double
click on the "beta.dsw" project workspace file in the vc++
sub-directory and perform a batch build of its contents.



Examples
========

There is currently no example program which directly demonstrates the
use of the collision detection library. Rather, this library is used,
in part, to implement the force field navigation technique. There are
two examples which demonstrates the force field navigation. eg4 in
src/extras/beta is a force field version of the MPG examples of the
same name. viewer, in the same directory, allows you to navigate
around an AC3D model (try gym.ac and assault.ac). Note, this example
opens 2 windows so dont run it hardware-accelerated on a machine
equipped with a single Voodoo1 or 2 card. You can readily adapt this
example to a single window if you wish to do so (the second window
provides an out-of-body view and shows the force fields in
action). Press 'k' for a list of control keys.
