---
name: "d.background"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/d.background"
---

# d.background(1grass)

Fills the graphics display frame with user defined color.

## 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: Monday Feb 24 17:51:43 2025

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

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