		  I_COLLIDE Installation Instructions
		  -----------------------------------

Version 1.0 of I_COLLIDE contains the collision detection library, a
linear programming library, a quaternion library, and a sample n-body
application.  All the source code is written in ANSI-compatible C and
requires an ANSI-C compiler to generate the libraries and executables.

Typing "make" in this top-level directory should start cause all the
object files, libraries, and executables to be cleaned out and new ones
to be compiled.

If you use a compiler besides gcc, replace the "CC = gcc" line in the
Makefile in every subdirectory.  If you want the nbody application to
perform graphics using OpenGL, you need to modify the first few lines of
the nbody Makefile to indicate the proper libraries, etc.  If you want
to run it using another graphics API, you'll need to write some code
similar to that in nbody/sgi.[ch] and modify nbody/graphics.h to use
this interface when given the proper #define by the Makefile.

To write an application using I_COLLIDE, you must #include <collision.h>
and link with libcollide.a, libLP.a, and libm.a (the standard math
library).  The quaternion library is used by the nbody application to
calculate transformation matrices for rotations about and arbitrary
vector.  Feel free to use it in your own applications if it seems
useful.

Be sure to see the USERS_MANUAL in the libcollide directory for some
help in using the collision library.


Notes: The quaternion library is originally by Ken Shoemake and modified
       by Rich Holloway at UNC-Chapel Hill.  This library is used only by
       the nbody application and not by the actual collision detection
       library.

       The linear programming library is by Michael Hohmeyer at Berkeley
       and is currently used in the collision detection library.

------------------------------------------------------------------------------

                      I_COLLIDE MAILING LIST

------------------------------------------------------------------------------

We would interested in knowing more about your application as well as any
bugs you may encounter in the collision detection library. You can
report them by sending e-mail to geom@cs.unc.edu.

 We plan to maintain a mailing list of I_COLLIDE users (to keep them updated
with the latest version of the code and bugs). To join the mailing list,
please send e-mail to geom@cs.unc.edu .

      
Jon Cohen 
Ming C. Lin 
Dinesh Manocha 
M. K. Ponamgi 
