.TH d.title 1grass "" "GRASS 7.6.0" "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]   [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\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\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name of raster map
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Sets the text color
.br
Default: \fIblack\fR
.IP "\fBsize\fR=\fIfloat\fR" 4m
.br
Sets the text size as percentage of the frame\(cqs height
.br
Options: \fI0\-100\fR
.br
Default: \fI4.0\fR
.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\(cqs 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
Alternately, the user might pipe \fId.title\fR output directly
into \fId.text:\fR
.br
\fBd.title map=\fR\fIsoils\fR \fBcolor=\fR\fIred\fR \fBsize=\fR\fI5\fR |
d.text
.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.text\fR
.br
.SH AUTHOR
James Westervelt,
U.S. Army Construction Engineering
Research Laboratory
.PP
\fILast changed: $Date: 2011\-11\-08 22:24:20 +0100 (Tue, 08 Nov 2011) $\fR
.SH SOURCE CODE
.PP
Available at: d.title source code (history)
.PP
Main index |
Display index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2019
GRASS Development Team,
GRASS GIS 7.6.0 Reference Manual