1xganim(1)                     Grass User's Manual                    xganim(1)
2
3
4

NAME

6       xganim
7

DESCRIPTION

9       xganim  is  a  tool  for  animating  a series of GRASS raster files. At
10       startup, a graphics window is opened containing  VCR-like  button  con‐
11       trols for: rewind, reverse play, step back, stop, step forward, forward
12       play, loop, swing, slower, faster, show filenames, current  frame  num‐
13       ber,  and Exit. The image is displayed above or to the left of the con‐
14       trols. Each raster file is read into  memory,  then  the  animation  is
15       played  once  beginning  to end. The user may then replay the series or
16       play continuous animation by using the buttons.
17
18       The user may define up to four  "views",  or  sub-windows,  to  animate
19       simultaneously.  e.g.,  View 1 could be rainfall, View 2 flooded areas,
20       View 3 damage to bridges or levees, View 4 other economic  damage,  all
21       animated as a time series. There is an arbitrary limit of 100 files per
22       view (100 animation frames),  but  the  practical  limit  may  be  less
23       depending on the window size and amount of available RAM.
24
25       The  environment  variable XGANIM_SIZE is checked for a value to use as
26       the dimension, in pixels, of the longest  dimension  of  the  animation
27       window.  If  XGANIM_SIZE is not set, the animation size defaults to the
28       rows & columns in the current GRASS region, scaling if necessary  to  a
29       default  minimum  size of 600 and maximum of 900. The resolution of the
30       current GRASS region is maintained, independent of window size.  Resiz‐
31       ing  the window after the program is running will have no effect on the
32       animation size.
33
34       UNIX - style wild cards may be used with the command  line  version  in
35       place of a raster file name, but it must be quoted.
36
37       If  the number of files differs for each view, the view with the fewest
38       files will determine the number of frames in the animation.
39

EXAMPLE

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

BUGS

47       On some displays that need to use private colormaps, the interface but‐
48       tons may become difficult to see.
49

SEE ALSO

51       d.slide.show
52

AUTHOR

54       Bill Brown, U.S. Army Construction Engineering Research Laboratories
55
56       Last changed: $Date: 2005/10/28 09:28:00 $
57
58       Full index
59
60
61
62GRASS 6.2.2                                                          xganim(1)