File = README


Release of ANIMATE (version 1.3), a program for IBM PC compatible 
microcomputers which can make movies for display on your computer 
screen  provided  you  have  a hard disk  and  a  register  level 
compatible  EGA or Hercules graphics board.  If you want to  work 
with  the source code provided, you will need version 2 or  newer 
of  Borland's  Turbo C.  Details are  explained  in  animate.doc, 
which  documents this entire package.  All source  files  contain 
comments.

Because this is the initial release of ANIMATE, you should regard 
it as a "pre-release"  or a "beta test version."  That is,  users 
will  likely  find  some  errors in  the  program  or  befuddling 
instructions  in the documentation, so check back in a  month  or 
two for updates.  Version 1.3 corrects an error in the  Tektronix 
4010 emulator that existed in the initial release (version  1.2).  
Thanks  for  your  help,  and please let  me  know  if  you  have 
problems.  Keep in mind that many graphics boards are not perfect 
clones  of  IBM's  EGA graphics system  or  Hercules'  monochrome 
graphics,   causing   ANIMATE   to  fail   with   these   boards.  
Unfortunately,  the only way to make ANIMATE work in such a  case 
is  to upgrade your graphics board. I can guarantee that  ANIMATE 
works properly with the examples provided, so a failure with  the 
examples indicates a shortcoming with the graphics board in  your 
computer.

If  and when this package is updated with new or corrected  code, 
this file will contain information on the affected routines.  The 
files  which  comprise  the release on 4 April  1990  are  listed 
below.  All files are ASCII except for the two executable  binary 
files:  animate.exe  and makemovy.exe.  In order to  receive  all 
files  correctly  using FTP on Internet, first use  MGET  *.*  to 
transfer  all  the ASCII files.  Then type BINARY,  and  hit  the 
"Enter" key.  Now use MGET *.EXE to transfer the two binary files 
to your computer. 

File         Contents
readme       This file.  Overview and file list.
animate.doc  Documentation for the ANIMATE package.
animate.exe  ANIMATE (executable version).
animate1.c   Source code for ANIMATE: first half.
animate2.c   Source code for ANIMATE: second half.
animate.prj  Project file for ANIMATE.
animate.par  Parameter file needed by animate.exe.
             In its present form, it is configured for
             EGA graphics.
animate.pah  Hercules version of animate.par.
             Must be renamed to animate.par if you
             have Hercules graphics.  First, rename the 
             EGA version of animate.par to animate.pae.
map.tek      Tektronix 4010 plotting instructions
             for a series of world maps which can be made
             into a short demonstration movie using
             ANIMATE.
map.scr      A "script" file which allows the EGA
             version of the demonstration movie
             to be played back using different color
             assignments than are specified in animate.par.
makemovy.exe Program to demonstrate making a movie
             directly using Turbo C, without needing
             Tektronix 4010 graphics.
makemovy.c   Source code for MAKEMOVY.
makemovy.prj Project file for MAKEMOVY.
grafsupp.c   Graphics functions which supplement Borland graphics.
             Their big advantage is that they make possible
             graphics programs which are device independent, i.e.
             you do not have to keep track of pixel coordinates.
             grafsupp.c is needed by makemovy.prj to construct
             MAKEMOVY.
grafsupp.h   Header file which accompanies grafsupp.c.
             This file should be placed in your \turboc\include
             directory and #included in any file that uses
             functions from grafsupp.c.
grafdemo.c   Source code for a program that demonstrates the
             routines in grafsupp.c.  It runs on any graphics
             mode supported by Turbo C.  No movie is made,
             because movies can be made using only the 640 by 350
             pixel mode of EGA/VGA graphics or using Hercules 
             monochrome graphics.
testpic.c    Source code for a program to create a simple
             Tektronix plot file which is useful for testing
             ANIMATE.

If  you  have questions or wish to acquire a free  copy  of  this 
software via the Internet computer network, contact:
Dr. Jon E. Ahlquist
Dept. of Meteorology  B-161
Florida State University
Tallahassee, FL 32306-3034
Telephone: (904) 644-1558
Internet address: ahlquist@metsat.met.fsu.edu
                 (ahlquist@128.186.5.2)
