Provided by: grass-doc_6.4.3-3_all bug




       xganim  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 number, and Exit. The image is displayed above or to the left of the controls.  Each
       raster  map  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  400
       files  per  view  (400 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 map
       name, but it must be quoted.

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


       export XGANIM_SIZE=800
       xganim view1="rain[1-9]","rain1[0-2]" view2="temp*"


       For  wildcard  matching,  xganim understands whatever the shell understands (as it invokes
       "ls" via the shell to expand wildcards).  E.g., a user can use "rast[0-9][0-9]"  to  match
       "rast00"  through  "rast99"  inclusive.   If  the maps if interest have varying numbers of
       digits, multiple patterns can be combined, e.g.:
       export XGANIM_SIZE=1000
       xganim view1=rast[0-9],rast[1-9][0-9]
        to match rast0 through rast99 inclusive.


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



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

       Last changed: $Date: 2011-11-08 01:42:51 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team