
DCR 96-05-02
============

Please read the COPYRIGHT and LICENSE files included with this
distribution.

xa is an animation package written using the XView library. Its main
feature is a panel interface for convenient access to animation,
display, and colormap functions. On a typical high-end workstation a
display rate of 50 frames/sec or better can be achieved with 100
400x400 8-bit images.

Supported Platforms
-------------------

xa is known to compile and run on the following platforms:

-- DEC Alpha running Digital Unix V3.x
-- SGI Indigo running IRIX 4.x
-- Sun Sparc running SunOS 4.1.x or Solaris 2.x

Please let the author know if a successful port is made to an
architecture not listed here.

Supported Image Formats
-----------------------

xa supports the following image formats:

-- Sun rasterfile (8-bit RGB only)
-- portable gray map
-- portable pixel map
-- raw gray bytes
-- graphics interchange format (GIF), including animations
-- JPEG
-- MPEG

The Netpbm library, xv, and ImageMagick are all examples of packages
that can be used to convert a variety of image formats to one of the
supported formats listed above. In addition, xa can read .gz and .Z
compressed formats.

Installation Instructions
-------------------------

First edit the Makefile and make any necessary changes. Be sure to
specify where your XView libraries and header files are located. Note
that an ANSI-compatible compiler such as gcc must be used. Also check
config.h for some configuration options. Then just type "make" to
build the package. After successful compilation, simply move the
executable (xa) and the man page (xa.man) to the desired directories.
Optionally, change BIN_DEST and MAN_DEST in the Makefile as desired
and type "make install" followed by "make install.man". The source
(including the bitmaps subdirectory) may then be deleted.

Bug reports, comments, etc. should be mailed to:

   richards@cita.utoronto.ca

Enjoy!

__     __ ___  ---------------------------------------------------
___   __  ____ | Derek C. Richardson | Tel:  (416) 978-6879/8494 |
____ __   ___  | CITA, McLennan Labs | Fax:  (416) 978-3921      |
___   __  _ __ | U of T, Toronto, ON | Home: (416) 351-1972      |
__     __ _  _ | CANADA M5S 3H8      | richards@cita.utoronto.ca |
               --http://www.cita.utoronto.ca/~richards/home.html--

$Id: README,v 1.9 1996/05/04 19:55:49 richards Exp $
