New animation program

[Bill Brown]

I just put a new animation program for GRASS raster files on moon under
grass/incoming.  It's just a quick port to X/Motif of a less user-friendly
but more versatile program we've been using in-house on our SGIs.
So you need X11 & Motif to compile.  If you find it useful or have 
suggestions for improvements, please let me know.

Oh yeah, the file is xganim.tar.Z

Here's the man page for it:




xganim <contrib>     GRASS Reference Manual      <contrib> xganim



NAME
     _x_g_a_n_i_m - Raster File Animation Program

SYNOPSIS
     xganim
     xganim help
     xganim view1=_n_a_m_e[,_n_a_m_e,...] [view2=_n_a_m_e[,_n_a_m_e,...]]
        [view3=_n_a_m_e[,_n_a_m_e,...]] [view4=_n_a_m_e[,_n_a_m_e,...]]

DESCRIPTION
     _x_g_a_n_i_m is a tool for animating a series of GRASS raster
     files.  At startup, a graphics window is opened containing
     VCR-like button controls for: rewind, reverse play, step
     back, stop, step forward, forward play, loop, swing, slower,
     faster, show filenames, current frame no., and Exit.  The
     image is displayed above or to the left of the controls.
     Each raster file is read into memory, then the animation is
     played once beginning to end.  The user may then replay the
     series or play continuous animation by using the buttons.

     The user may define up to four "views", or sub-windows, to
     animate simultaneously.  e.g., View 1 could be rainfall,
     View 2 flooded areas, View 3 damage to bridges or levees,
     View 4 other economic damage, all animated as a time series.
     There is an arbitrary limit of 100 files per view (100
     animation frames), but the practical limit may be less
     depending on the window size and amount of available RAM.

     The environment variable XGANIM_SIZE is checked for a value
     to use as the dimension, in pixels, of the longest dimension
     of the animation window.  If XGANIM_SIZE is not set, the
     animation size defaults to the rows & columns in the current
     GRASS region, scaling if necessary to a default minimum size
     of 600 and maximum of 900.  The resolution of the current
     GRASS region is maintained, independent of window size.
     Resizing the window after the program is running will have
     no effect on the animation size.

     UNIX - style wild cards may be used with the command line
     version in place of a raster file name, but it _m_u_s_t _b_e
     _q_u_o_t_e_d.

     Example:
     xganim view1="rain[1-9]","rain1[0-2]" view2="temp*"

     If the number of files differs for each view, the view with
     the fewest files will determine the number of frames in the
     animation.

COMMAND LINE OPTIONS
     Parameters

     _v_i_e_w_1
          Raster file(s) for View1

     _v_i_e_w_2
          Raster file(s) for View2

     _v_i_e_w_3
          Raster file(s) for View3

     _v_i_e_w_4
          Raster file(s) for View4


BUGS
     On some displays that need to use private colormaps, the
     interface buttons may become difficult to see.


AUTHOR
     Bill Brown, U.S. Army Construction Engineering Research
     Laboratories (brown at zorro.cecer.army.mil)

NOTICE
     This program is part of the _c_o_n_t_r_i_b section of the GRASS
     distribution.  As such, it is externally contributed code
     that has not been examined or tested by the Office of GRASS
     Integration.




























2                        U.S. Army CERL                 GRASS 4.1