<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: d.save</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>d.save</b></em> - Creates a list of commands for recreating screen graphics.
<h2>KEYWORDS</h2>
display
<h2>SYNOPSIS</h2>
<b>d.save</b><br>
<b>d.save help</b><br>
<b>d.save</b> [-<b>cao</b>] [<b>frame</b>=<em>string</em>[,<i>string</i>,...]] [<b>remove</b>=<em>integer</em>[,<i>integer</i>,...]] [<b>move</b>=<em>from,to</em>[,<i>from,to</i>,...]] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-c</b></DT>
<DD>Save current frame</DD>
<DT><b>-a</b></DT>
<DD>Save all the frames</DD>
<DT><b>-o</b></DT>
<DD>Only map objects without extra header and tailer</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>frame</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Name of frame(s) to save</DD>
<DT><b>remove</b>=<em>integer[,<i>integer</i>,...]</em></DT>
<DD>List of object numbers to remove which are displayed after "#". -1 for the last object.</DD>
<DT><b>move</b>=<em>from,to[,<i>from,to</i>,...]</em></DT>
<DD>List of object numbers to move ("from" to "to"). remove= option will be done first, if any.</DD>
</DL>
<H2>DESCRIPTION</H2>
When GRASS display (<EM>d.</EM>) commands are used to
generate graphical images on the graphics monitor, some
commands are noted in lists that the current graphics
driver (see manual entry for
<EM><A HREF="d.mon.html">d.mon</A></EM>) maintains. This
command, <EM>d.save</EM>, uses this information to
create a shell script that can be used to recreate graphics
in another frame at another time. The shell script is sent
to standard output (the user's terminal). If you wish to
save the shell script created by <EM>d.save</EM>, its
output should be redirected to a file; for example:
<DL>
<DD> <B>d.save > script.out </B>
</DL>
The user can run the program non-interactively by
specifying flag settings and parameter values on the
command line. If the user types <B>d.save</B> without
specifying these program arguments, the user will be
prompted for inputs through the standard user interface
described in the manual entry for
<EM><A HREF="parser.html">parser</A></EM>.
<H2>NOTES</H2>
Object numbers for remove= and move= options are displayed after #.
<P>
Display commands used interactively, and those that take
their graphic instructions from standard input, will not be
saved by <EM>d.save</EM>.
<H2>SEE ALSO</H2>
<EM><A HREF="d.frame.html">d.frame</A></EM><br>
<EM><A HREF="d.mon.html">d.mon</A></EM><br>
<EM><A HREF="g.region.html">g.region</A></EM><br>
<EM><A HREF="parser.html">parser</A></EM>
<H2>AUTHOR</H2>
David Satnik,
Central Washington University
<p><i>Last changed: $Date: 2006-06-09 09:41:59 +0200 (Fri, 09 Jun 2006) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="display.html">display index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
