xganim(1)		      Grass User's Manual		     xganim(1)



NNAAMMEE
       _x_g_a_n_i_m - Raster File Animation Program

SSYYNNOOPPSSIISS
       xxggaanniimm

       xxggaanniimm hheellpp

       xxggaanniimm		vviieeww11_=_n_a_m_e_[_,_n_a_m_e_,_._._._]	       [vviieeww22_=_n_a_m_e_[_,_n_a_m_e_,_._._._]]
       [vviieeww33_=_n_a_m_e_[_,_n_a_m_e_,_._._._]] [vviieeww44_=_n_a_m_e_[_,_n_a_m_e_,_._._._]]

DDEESSCCRRIIPPTTIIOONN
       _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 con-
       trols 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  continu-
       ous 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.	Resiz-
       ing 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 must be quoted.


       Example:


       _x_g_a_n_i_m _v_i_e_w_1_=_"_r_a_i_n_[_1_-_9_]_"_,_"_r_a_i_n_1_[_0_-_2_]_" _v_i_e_w_2_=_"_t_e_m_p_*_"


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

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       vviieeww11  Raster file(s) for View1

       vviieeww22  Raster file(s) for View2

       vviieeww33  Raster file(s) for View3

       vviieeww44  Raster file(s) for View4


BBUUGGSS
       On some displays that need to use private colormaps, the interface but-
       tons may become difficult to see.

AAUUTTHHOORR
       Bill Brown, U.S. Army Construction Engineering Research Laboratories

NNOOTTIICCEE
       This program is part of the contrib 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.

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0							     xganim(1)
