<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: d.title</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.title</b></em> - Create a TITLE for a raster map in a form suitable for display with d.text. <h2>KEYWORDS</h2> display <h2>SYNOPSIS</h2> <b>d.title</b><br> <b>d.title help</b><br> <b>d.title</b> [-<b>dfs</b>] <b>map</b>=<em>name</em> [<b>color</b>=<em>string</em>] [<b>size</b>=<em>float</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-d</b></DT> <DD>Draw title on current display</DD> <DT><b>-f</b></DT> <DD>Do a fancier title</DD> <DT><b>-s</b></DT> <DD>Do a simple title</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>map</b>=<em>name</em></DT> <DD>Name of input raster map</DD> <DT><b>color</b>=<em>string</em></DT> <DD>Sets the text color</DD> <DD>Options: <em>red,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple</em></DD> <DD>Default: <em>black</em></DD> <DT><b>size</b>=<em>float</em></DT> <DD>Sets the text size as percentage of the frame's height</DD> <DD>Options: <em>0-100</em></DD> <DD>Default: <em>4.0</em></DD> </DL> <H2>DESCRIPTION</H2> <EM>d.title</EM> generates to standard output a string which can be used by <EM><A HREF="d.text.html">d.text</A></EM> to draw a TITLE for the raster map layer <EM>name</EM> in the active display frame on the graphics monitor. Output created by <EM>d.title</EM> can be redirected into a file, or piped directly into <EM><A HREF="d.text.html">d.text</A></EM> to display the map TITLE created by <EM>d.title</EM>. The map TITLE created will include the map layer's name, TITLE, MAPSET, LOCATION_NAME, geographic region boundary coordinates, and cell resolution. If the <b>-d</b> draw flag is used, then <EM>d.title</EM> will call <EM>d.text</EM> for you and the title will be automatically rendered to the display. <H2>NOTES</H2> The text created with <EM><A HREF="d.text.html">d.text</A></EM> will not necessarily fit within the active display frame on the graphics monitor; the user should choose a text size appropriate to this frame. <H2>EXAMPLES</H2> For example, a user wishing to create a suitable TITLE for the Spearfish, SD <EM>soils</EM> map layer and to display this TITLE in the active display frame on the graphics monitor might type the following: <DL> <DD> <B>d.title map=</B><EM>soils</EM> <B>color=</B><EM>red</EM> <B>size=</B><EM>5</EM> <B>> TITLE.file</B> <DD> <B><A HREF="d.text.html">d.text</A> < TITLE.file</B> </DL> Alternately, the user might pipe <EM>d.title</EM> output directly into <EM><A HREF="d.text.html">d.text</A>:</EM> <DL> <DD> <B>d.title map=</B><EM>soils</EM> <B>color=</B><EM>red</EM> <B>size=</B><EM>5</EM> | <A HREF="d.text.html">d.text</A> </DL> <P> A file created by <EM>d.title</EM> can be displayed with <EM><A HREF="d.text.html">d.text</A></EM>. Information contained in this file takes precedence over the <EM>color</EM> and <EM>size</EM> parameters for <EM><A HREF="d.text.html">d.text</A></EM>. <H2>SEE ALSO</H2> <EM><A HREF="d.font.html">d.font</A></EM><br> <EM><A HREF="d.font.freetype.html">d.font.freetype</A></EM><br> <EM><A HREF="d.text.html">d.text</A></EM><br> <H2>AUTHOR</H2> James Westervelt, U.S. Army Construction Engineering Research Laboratory <p> <i>Last changed: $Date: 2007-06-18 10:31:48 +0200 (Mon, 18 Jun 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>
