                               AnimaBob
                               ========

Copyright
---------

Copyright (c) 1992 Minnesota Supercomputer Center, Inc.
Copyright (c) 1992 Army High Performance Computing Research Center
    (AHPCRC), University of Minnesota
Copyright (c) 1995-1999 Laboratory for Computational Science and
    Engineering (LCSE), University of Minnesota

AnimaBob is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.

AnimaBob is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with enscript; see the file COPYING. If not, write to the Free
Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.


General Information
-------------------

This package contains programs and utilities that are useful for viewing
large 2D and 3D data sets. They are best used at the tail end of the
visualization process, after the data has been post-processed, scaled, and
rasterized.


Package Contents
----------------

AUTHORS		- Authors and major contributors to the AnimaBob package.
CONTRIBUTORS	- Contributors and sponsors of the AnimaBob package.
COPYING		- The GNU General Public License (GPL).
ChangeLog	- A chronological log of changes made to the package.
INSTALL		- Instructions for building and installing the package.
Imake.h		- File included with a number of the package Imakefiles.
Imakefile	- Top level Imakefile.
NEWS		- A list of version-by-version changes in the Animabob package.
README		- This file.
TODO		- A list of bugs and enhancements requested for AnimaBob.
animabob	- Sources for the 'animabob' and 'bobload' applications.
config.h	- Header file for platform-specific features.
doc		- AnimaBob documentation, reference pages, and help files.
icol		- Sources for the 'icol' application.
lib		- Sources for the library used by all package programs.
raz		- Sources for the 'raz' application.
util		- Utilities and scripts for building the AnimaBob package.


System Requirements
-------------------

This suite of programs was original targeted for and designed for the Irix
operating system running on Silicon Graphics workstations, servers and
supercomputers. At present, optimal performance will be obtained from those
platforms.

However, the advent of Brian Paul's Mesa3D OpenGL clone and the general wide-
spread adoption of OpenGL by a wide number of operating system vendors and
video hardware manufacturers has opened up AnimaBob to a new community of
users.

The following represents the minimum requiresments for building and running
the AnimaBob package:

  * An ANSI C compiler suite
  * X11R6.1 or later
  * Motif 1.0 or later OR LessTif 0.87 or later
  * OpenGL 1.0 or later OR Mesa3D 3.0 or later
  * GL widgets (i.e. libGLw)

The AnimaBob package has been tested and run successfully on the following
platforms:

  * Silicon Graphics Irix 6.2, 6.3, 6.4, and 6.5

    - MIPSPro compiler
    - Indy, Indigo2, Onyx, Challenge, O2, Octane, O200, O2000, Onyx2
    - OpenGL 1.1

  * Sun Microsystems Solaris 2.5.1, 2.6, and 2.7

    - GNU GCC 2.95.1
    - UltraSPARC 10
    - Mesa3D 3.0

  * GNU Linux 2.2 and 2.3

    - GNU EGCS 1.1.2 and GCC 2.95.1
    - PowerPC and x86
    - Mesa3D 3.0

If you are able to successfully build and compile the AnimaBob package on
platforms other than those listed above, please let us know.


Buidling and Installation
-------------------------

Please reference the file INSTALL for information on how to configure, 
build, and install the AnimaBob package.


Bugs, Changes, Comments, Suggestions
------------------------------------

Please report any bugs, changes, comments, or suggestions to Grant Erickson
<grant@lcse.umn.edu> and the maitainer of the file associated with the
bug, change, comment, or suggestion. Maintainer information can be found at
the top of most files in the package.

If you are reporting a bug, please be certain to include as much information
as possible about your system and the circumstances in which the bug
occurred.

If you make any changes or additions to the package, please submit the
changes back to the developers, so that they might integrate them with
the rest of the code and re-release them.
