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

# d.title(1grass)

Create a TITLE for a raster map in a form suitable for display with d.text.

## NAME

**d.title**  - Create a TITLE for a raster map in a form suitable for display with d.text.

## KEYWORDS

display, cartography

## SYNOPSIS

**d.title**\
 **d.title --help**\
 **d.title** \[-**dfs**\] **map**=*name*  \[**color**=*string*\]   \[**size**=*float*\]   \[--**help**\]  \[--**verbose**\]  \[--**quiet**\]  \[--**ui**\]

### Flags:

- **-d**

  Draw title on current display

- **-f**

  Do a fancier title

- **-s**

  Do a simple title

- **--help**

  Print usage summary

- **--verbose**

  Verbose module output

- **--quiet**

  Quiet module output

- **--ui**

  Force launching GUI dialog

### Parameters:

- **map**=*name* **\[required\]**

  Name of raster map

- **color**=*string*

  Sets the text color\
   Default: *black*

- **size**=*float*

  Sets the text size as percentage of the frame’s height\
   Options: *0-100*\
   Default: *4.0*

## DESCRIPTION

*d.title* generates to standard output a string which can be used by *d.text* to draw a TITLE for the raster map layer *name* in the active display frame on the graphics monitor. Output created by *d.title* can be redirected into a file, or piped directly into *d.text* to display the map TITLE created by *d.title*.  The map TITLE created will include the map layer’s name, TITLE, MAPSET, LOCATION\_NAME, geographic region boundary coordinates, and cell resolution. If the **-d** draw flag is used, then *d.title* will call *d.text* for you and the title will be automatically rendered to the display.

## NOTES

The text created with *d.text* will not necessarily fit within the active display frame on the graphics monitor; the user should choose a text size appropriate to this frame.

## EXAMPLES

For example, a user wishing to create a suitable TITLE for the Spearfish, SD *soils* map layer and to display this TITLE in the active display frame on the graphics monitor might type the following:\

```
d.title map=soils color=red size=5 > TITLE.file
d.text < TITLE.file
```

Alternately, the user might pipe *d.title* output directly into *d.text:*\

```
d.title map=soils color=red size=5 | d.text
```

A file created by *d.title* can be displayed with *d.text*. Information contained in this file takes precedence over the *color* and *size* parameters for *d.text*.

## SEE ALSO

*d.font,* *d.text*

## AUTHOR

James Westervelt, U.S. Army Construction Engineering Research Laboratory

## SOURCE CODE

Available at: d.title source code (history)

Accessed: Monday Feb 24 17:50:27 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