Skip to content

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