.TH d.title 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.title\fR\fR  - Create a TITLE for a raster map in a form suitable for display with d.text.
.SH KEYWORDS
display, cartography
.SH SYNOPSIS
\fBd.title\fR
.br
\fBd.title help\fR
.br
\fBd.title\fR [\-\fBdfs\fR] \fBmap\fR=\fIname\fR  [\fBcolor\fR=\fIstring\fR]   [\fBsize\fR=\fIfloat\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-d\fR" 4m
.br
Draw title on current display
.IP "\fB\-f\fR" 4m
.br
Do a fancier title
.IP "\fB\-s\fR" 4m
.br
Do a simple title
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input raster map
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Sets the text color
.br
Options: \fIred,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple\fR
.br
Default: \fIblack\fR
.IP "\fBsize\fR=\fIfloat\fR" 4m
.br
Sets the text size as percentage of the frame's height
.br
Options: \fI0-100\fR
.br
Default: \fI4.0\fR
.PP
.SH DESCRIPTION
\fId.title\fR generates to standard output a string which can be used by
\fId.text\fR to draw a TITLE for the raster map
layer \fIname\fR in the active display frame on the graphics monitor. 
Output created by \fId.title\fR can be redirected into a file, or piped
directly into \fId.text\fR to display the map
TITLE created by \fId.title\fR.  The map TITLE created will include the
map layer's name, TITLE, MAPSET, LOCATION_NAME, geographic region boundary
coordinates, and cell resolution.
If the \fB-d\fR draw flag is used, then \fId.title\fR will call
\fId.text\fR for you and the title will be automatically rendered
to the display.
.SH NOTES
The text created with 
\fId.text\fR 
will not necessarily fit within the 
active display frame on the graphics monitor; 
the user should choose a text size appropriate to this frame. 
.SH EXAMPLES
For example, a user wishing to create a suitable TITLE for the 
Spearfish, SD \fIsoils\fR map layer and to display this TITLE in the 
active display frame on the graphics monitor might type the following: 
.br
 \fBd.title map=\fR\fIsoils\fR \fBcolor=\fR\fIred\fR \fBsize=\fR\fI5\fR \fB> TITLE.file\fR
.br
 \fBd.text < TITLE.file\fR 
.PP
Alternately, the user might pipe \fId.title\fR output directly 
into \fId.text:\fR 
\fBd.title map=\fR\fIsoils\fR \fBcolor=\fR\fIred\fR \fBsize=\fR\fI5\fR | 
d.text
.PP
.PP
A file created by \fId.title\fR can be displayed 
with \fId.text\fR.
Information contained in this file takes precedence over the 
\fIcolor\fR and \fIsize\fR parameters for 
\fId.text\fR.
.SH SEE ALSO
\fId.font\fR
.br
\fId.font.freetype\fR
.br
\fId.text\fR
.br
.SH AUTHOR
James Westervelt, 
U.S. Army Construction Engineering 
Research Laboratory
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team