d.background(1)

NAME
d.background - Fills the graphics display frame with user defined color.

KEYWORDS
display, graphics, background, fill, erase

SYNOPSIS
d.background
d.background --help
d.background color=name [--help] [--verbose] [--quiet] [--ui]

  Flags:

--help
    Print usage summary

--verbose
    Verbose module output

--quiet
    Quiet module output

--ui
    Force launching GUI dialog

  Parameters:

color=name [required]
    Background color
    Either a standard color name or R:G:B triplet

DESCRIPTION
d.background will fill the image (or generally display monitor) with a single color specified by the color option.

NOTES
d.background is a frontend to d.erase and shares its limitations. Namely, it does not work with the wx monitors such as d.mon wx0.

EXAMPLES
In this example, the streets_wake map from the North Carolina sample dataset is displayed with custom background color (specified using HTML hex color code) using cairo display monitor (creates file called map.png):

g.region vector=streets_wake
d.mon cairo
d.background color=#ADEFD1
d.vect map=streets_wake color=#00203F legend_label="Streets"
d.legend.vect -b at=70,30 title="Wake County"

Figure: Wake County street network with custom background color (North Carolina sample dataset)

SEE ALSO
d.erase

AUTHOR
Vaclav Petras, NCSU GeoForAll Lab

SOURCE CODE

Available at: d.background source code (history)

Accessed: Wednesday Feb 04 01:04:46 2026

Main index | Display index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual