xganim(1grass) [debian man page]

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

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, multi-
       ple 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

       (C) 2003-2011 GRASS Development Team

GRASS 6.4.2															    xganim(1grass)

general(1grass) 						Grass User's Manual						   general(1grass)

GRASS GIS 6.4.2 Reference Manual
       Geographic Resources Analysis Support System, commonly referred to as GRASS, is a <a href="http://en.wikipedia.org/wiki/Geographic_informa-
       tion_system">Geographic Information System (GIS) used for geospatial data management and analysis, image processing, graphics/maps  produc-
       tion, spatial modeling, and visualization. GRASS is currently used in academic and commercial settings around the world, as well as by many
       governmental agencies and environmental consulting companies.

       This reference manual details the use of modules distributed with Geographic Resources Analysis Support System (GRASS), an open source (GNU
       GPL'ed), image processing and geographic information system (GIS).  Go back to help overview
       general commands:
	    | g.access	   | Controls access to the current mapset for other users on the system.
	    | g.ask   | Prompts the user for the names of GRASS data base files.
	    |  g.copy	| Copies available data files in the user's current mapset search path and location to the appropriate element directories
       under the user's current mapset.
	    | g.dirseps    | Internal GRASS utility for converting directory separator characters.
	    | g.extension  | Tool to maintain GRASS extensions in local GRASS installation.
	    | g.filename   | Prints GRASS data base file names.
	    | g.findetc    | Searches for GRASS support files.
	    | g.findfile   | Searches for GRASS data base files and sets variables for the shell.
	    | g.gisenv	   | Outputs and modifies the user's current GRASS variable settings.
	    | g.gui   | Launches a GRASS graphical user interface (GUI) session.
	    | g.list  | Lists available GRASS data base files of the user-specified data type.
	    | g.manual	   | Display the HTML man pages of GRASS
	    | g.mapset	   | Changes current mapset.
	    | g.mapsets    | Modifies the user's current mapset search path.
	    | g.message    | Prints a message, warning, progress info, or fatal error in the GRASS way.
	    | g.mkfontcap  | Generates the font configuration file by scanning various directories for fonts
	    | g.mlist	   | Lists available GRASS data base files of the user-specified data type optionally using the search pattern.
	    | g.mremove    | Removes data base element files from the user's current mapset.
	    | g.parser	   | Provides automated parser, GUI, and help support for GRASS scipts.
	    | g.pnmcomp    | Overlays multiple PPM image files
	    | g.proj  | Converts co-ordinate system descriptions (i.e. projection information) between various formats (including GRASS format).
	    | g.region	   | Manages the boundary definitions for the geographic region.
	    | g.remove	   | Removes data base element files from the user's current mapset.
	    | g.rename	   | Renames data base element files in the user's current mapset.
	    | g.setproj    | Interactively reset the location's projection settings.
	    | g.tempfile   | Creates a temporary file and prints the file name.
	    | g.transform  | Computes a coordinate transformation based on the control points.
	    | g.version    | Displays version and copyright information.

       Full Index
       (C) 2003-2011 GRASS Development Team

GRASS 6.4.2															   general(1grass)