d.labels - GRASS manual
Author: GRASS Development Team
Description: d.labels: Displays text labels (created with v.label) to the active frame on the graphics monitor.
Keywords: display, paint labels

## NAME

d.labels - Displays text labels (created with v.label) to the active frame on the graphics monitor.

## KEYWORDS

display, paint labels

## SYNOPSIS

d.labels
d.labels --help
d.labels [-i] labels=string [minreg=float] [maxreg=float] [--help] [--verbose] [--quiet] [--ui]

### Flags:

-i
  Ignore rotation setting and draw horizontally
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

labels=string [required]
  Name of label file
minreg=float
  Minimum region size (diagonal) when labels are displayed
maxreg=float
  Maximum region size (diagonal) when labels are displayed

## DESCRIPTION

d.labels displays a paint label file in the active display frame on the graphics monitor. Each label has components which determine the text, the location of the text on the image, its size, and the background for the text. This file can be generated with the v.label program or simply created by the user as an ASCII file (using a text editor) and placed in the appropriate directory under the user's current mapset and project (i.e. `$MAPSET/paint/labels/`).

## NOTES

Some of the information stored in the label file is unused by d.labels. This extra information is used by such programs as ps.map.

This module was formerly known as d.paint.labels. The old version of d.labels from GRASS 5, which provided interactive placement and modification of paint labels, still needs to have its functionality merged into this module.

## SEE ALSO

d.font
d.text
d.title
ps.map
v.label

## AUTHOR

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

## SOURCE CODE

Available at: d.labels source code (history)

Latest change: Friday Apr 17 01:04:26 2026 in commit: 5a31d549cc0150239894bd2b9e67250af87d38b5

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

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual