d.labels
Displays text labels (created with v.label) to the active frame on the graphics monitor.
d.labels [-i] labels=string [minreg=float] [maxreg=float] [--verbose] [--quiet] [--qq] [--ui]
Example:
d.labels labels=string
grass.script.run_command("d.labels", labels, minreg=None, maxreg=None, flags=None, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("d.labels", labels="string")
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
-i
Ignore rotation setting and draw horizontally
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
labels : str, required
Name of label file
Used as: input, paint labels
minreg : float, optional
Minimum region size (diagonal) when labels are displayed
maxreg : float, optional
Maximum region size (diagonal) when labels are displayed
flags : str, optional
Allowed values: i
i
Ignore rotation setting and draw horizontally
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
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: Saturday Mar 08 22:11:35 2025 in commit 76f2606