NAME¶
xganim
DESCRIPTION¶
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.
EXAMPLE¶
export XGANIM_SIZE=800
xganim view1="rain[1-9]","rain1[0-2]"
view2="temp*"
NOTES¶
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.
BUGS¶
On some displays that need to use private colormaps, the interface buttons may
become difficult to see.
SEE ALSO¶
d.slide.show,
gis.m: ANIMATE TOOL
AUTHOR¶
Bill Brown, U.S. Army Construction Engineering Research Laboratories
Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $
Full index
© 2003-2014 GRASS Development Team