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 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 reso-
       lution of the current GRASS region is maintained, indepen-
       dent  of  window size.  Resizing the window after the pro-
       gram 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 buttons 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)
