<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: d.frame</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.frame</b></em> - Manages display frames on the user's graphics monitor. <h2>KEYWORDS</h2> display <h2>SYNOPSIS</h2> <b>d.frame</b><br> <b>d.frame help</b><br> <b>d.frame</b> [-<b>csepalD</b>] [<b>frame</b>=<em>name</em>] [<b>at</b>=<em>bottom,top,left,right</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-c</b></DT> <DD>Create a new frame</DD> <DT><b>-s</b></DT> <DD>Select a frame</DD> <DT><b>-e</b></DT> <DD>Remove all frames and erase the screen</DD> <DT><b>-p</b></DT> <DD>Print name of current frame</DD> <DT><b>-a</b></DT> <DD>Print names of all frames</DD> <DT><b>-l</b></DT> <DD>List map names displayed in GRASS monitor</DD> <DT><b>-D</b></DT> <DD>Debugging output</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>name</em></DT> <DD>Frame to be created/selected</DD> <DT><b>at</b>=<em>bottom,top,left,right</em></DT> <DD>Where to place the frame, values in percent (implies -c)</DD> </DL> <H2>DESCRIPTION</H2> This program manages display frames on the user's graphics monitor. Graphics are displayed in rectangular frames on whatever graphics monitor the user is currently directing GRASS display output to. These frames are created and managed with this module. Note that GRASS frame contents <EM>are not</EM> retained when one frame covers another. You cannot shuffle frames from top to bottom and then back again. They simply define rectangular areas on the screen where subsequent drawing will occur. <H2>NOTES</H2> The coordinates for the <B>at=</B> option are stated in the form: <EM>bottom,top,left,right</EM>. The lower-left corner of the graphics monitor always is at location 0,0 while the monitor's upper-right corner is always at 100,100 (the values are in percent). <P> If <B>at=</B> options are not given during frame correction the user will be prompted to create the frame using the mouse. Likewise if a frame name is not given during frame selection, the user will be prompted to select an existing frame on the display monitor using the mouse. <P> If the user has created multiple display frames that overlap one another, whatever the user displays in the active frame will overwrite those portions of the underlying frame where these frames overlap. <P> A frame by the name of <EM>full_screen</EM> is always present and may be selected at any time. This may be useful if you would like to de-select all user defined frames just before taking a screenshot. <H2>SEE ALSO</H2> <EM> <A HREF="d.erase.html">d.erase</A><br> <A HREF="d.extend.html">d.extend</A><br> <A HREF="d.info.html">d.info</A><br> <A HREF="d.mon.html">d.mon</A><br> <A HREF="d.monsize.html">d.monsize</A><br> <A HREF="d.mvmon.html">d.mvmon</A><br> <A HREF="d.redraw.html">d.redraw</A><br> <A HREF="d.resize.html">d.resize</A><br> <A HREF="d.save.html">d.save</A><br> <A HREF="d.split.html">d.split</A><br> </EM> <H2>AUTHOR</H2> James Westervelt, U.S. Army Construction Engineering Research Laboratory <BR> Michael Shapiro, U.S. Army Construction Engineering Research Laboratory <p> <i>Last changed: $Date: 2007-05-06 23:03:09 +0200 (Sun, 06 May 2007) $</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>
