.TH d.background 1grass "" "GRASS 8.2.1" "GRASS GIS User's Manual"
.SH NAME
\fI\fBd.background\fR\fR  \- Fills the graphics display frame with user defined color.
.SH KEYWORDS
display, graphics, background, fill, erase
.SH SYNOPSIS
\fBd.background\fR
.br
\fBd.background \-\-help\fR
.br
\fBd.background\fR \fBcolor\fR=\fIname\fR  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.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 "\fBcolor\fR=\fIname\fR \fB[required]\fR" 4m
.br
Background color
.br
Either a standard color name or R:G:B triplet
.SH DESCRIPTION
\fId.background\fR will fill the image (or generally display monitor)
with a single color specified by the \fBcolor\fR option.
.SH NOTES
\fId.background\fR is a frontend to \fId.erase\fR and shares its limitations.
Namely, it does not work with the wx monitors such as \fCd.mon wx0\fR.
.SH EXAMPLES
In this example, the \fIstreets_wake\fR map from the North Carolina sample
location is displayed with custom background color (specified using HTML hex color code)
using \fIcairo\fR display monitor (creates file called \fImap.png\fR):
.br
.nf
\fC
g.region vector=streets_wake
d.mon cairo
d.background color=#ADEFD1
d.vect map=streets_wake color=#00203F legend_label=\(dqStreets\(dq
d.legend.vect \-b at=70,30 title=\(dqWake County\(dq
\fR
.fi
.PP
Figure: Wake County street network with custom background color (North Carolina sample dataset)
.SH SEE ALSO
\fI
d.erase
\fR
.SH AUTHOR
Vaclav Petras, NCSU GeoForAll Lab
.SH SOURCE CODE
.PP
Available at:
d.background source code
(history)
.PP
Accessed: Sunday Jan 22 07:37:41 2023
.PP
Main index |
Display index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2023
GRASS Development Team,
GRASS GIS 8.2.1 Reference Manual