NAME

       d.title  - Create a TITLE for a raster map in a form suitable for display with d.text.

KEYWORDS

       display, cartography

SYNOPSIS

       d.title
       d.title help
       d.title [-dfs] map=name  [color=string]   [size=float]   [--verbose]  [--quiet]

   Flags:
       -d
           Draw title on current display

       -f
           Do a fancier title

       -s
           Do a simple title

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       map=name
           Name of input raster map

       color=string
           Sets the text color
           Options:
           red,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple
           Default: black

       size=float
           Sets the text size as percentage of the frame's height
           Options: 0-100
           Default: 4.0

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.  If the -d draw flag is used, then d.title will call d.text
       for you and the title will be automatically rendered to the display.

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.

EXAMPLES

       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 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.

SEE ALSO

       d.font
       d.font.freetype
       d.text

AUTHOR

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

       Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                      d.title(1grass)