d.title <main>	      GRASS Reference Manual	   <main> d.title



NAME
     d.title - Outputs a title for a raster map layer in a form
     suitable for display by d.text.
     (GRASS Display Program)

SYNOPSIS
     d.title
     d.title help
     d.title [-f] map=name [color=name] [size=value]

DESCRIPTION
     d.title generates to standard output a string which can be
     used by d.text to draw a title for the raster map layer name
     in the active display frame on the graphics monitor.  Output
     created by d.title can be redirected into a file, or piped
     directly into d.text to display the map title created by
     d.title.  The map title created will include the map layer's
     name, title, MAPSET, LOCATION_NAME, geographic region
     boundary coordinates, and cell resolution.

     The user can state program arguments on the command line, or
     type simply d.title on the command line.  In the latter
     case, the program will prompt the user for the parameter
     values and flag setting using the standard GRASS parser
     interface described in the manual entry for parser.

     Flag:

     -f		       Displays a fancier title.


     Parameters:

     map=name	       Name of an existing raster map layer in
		       the user's mapset search path.

     color=name	       Sets the current color to the name stated.
		       Options:	 red, orange, green, blue,
		       indigo, violet, black, white, gray,
		       yellow, brown, and magenta
		       Default:	 white

     size=value	       Sets the text size as a percentage of the
		       active display frame's height, to value.
		       Floating point values can be used.
		       Options:	 0 - 100
		       Default:	 15.0

EXAMPLE
     For example, a user wishing to create a suitable title for
     the Spearfish, SD soils map layer and to display this title
     in the active display frame on the graphics monitor might



GRASS 5.0beta6	      GRASS Development Team			1






d.title <main>	      GRASS Reference Manual	   <main> d.title



     type the following:

	  d.title map=soils color=red size=5 > title.file

	  d.text < title.file

     Alternately, the user might pipe d.title output directly
     into d.text:

	  d.title map=soils color=red size=5 | d.text

     A file created by d.title can be displayed with d.text.
     Information contained in this file takes precedence over the
     color and size parameters for d.text.

NOTES
     The text created with d.text will not necessarily fit within
     the active display frame on the graphics monitor; the user
     should choose a text size appropriate to this frame.

SEE ALSO
     d.font, d.text and parser

AUTHORS
     James Westervelt, U.S. Army Construction Engineering
     Research Laboratory





























2		      GRASS Development Team	   GRASS 5.0beta6