d.labels(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 d.labels(1) — the GRASS GIS User's Manual glow-up 💖

okay bestie, gather round, we're talking about d.labels from the GRASS GIS manual, and honestly? she's a whole mood. 💅

KEYWORDS: display, paint labels — yeah, she's a display module and she paints labels, no cap.

✨ NAME ✨

d.labels — she displays text labels (the ones you made with v.label) onto the active frame on the graphics monitor. iconic behavior fr. 🎀

🌸 SYNOPSIS 🌸

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

🦋 Flags 🦋

  • -i — Ignore the rotation setting and draw everything horizontally. like, straight up. no tilt. periodt.
  • --help — Print usage summary. your lil cheat sheet 🫶
  • --verbose — Verbose module output. she will yap (affectionately) 💬
  • --quiet — Quiet module output. she will NOT yap 🙈
  • --ui — Force launching GUI dialog. pop-up era ✨

🍓 Parameters 🍓

  • labels=string [required] — Name of label file. this one's mandatory bestie, no skipping 💀
  • minreg=float — Minimum region size (diagonal) when labels are displayed
  • maxreg=float — Maximum region size (diagonal) when labels are displayed

💜 DESCRIPTION 💜

so d.labels displays a paint label file in the active display frame on the graphics monitor. that's the whole vibe. 🌈

every label has components that determine:

  • the text
  • the location of the text on the image
  • its size
  • the background for the text

and you can get this file either by generating it with the v.label program, OR by just... being a DIY queen and creating it yourself as an ASCII file in a text editor 👑 — then dropping it in the appropriate directory under your current mapset and project, which is:

$MAPSET/paint/labels/

slay. simple as that. 💅

⭐ NOTES ⭐

heads up: some of the info stored in the label file is unused by d.labels. she doesn't read everything in there, okay? that extra info gets used by other programs, like ps.map. so don't panic if you're like "why isn't this doing anything" — she's just not the one who cares about it. 😌

also, history lesson moment: this module was formerly known as d.paint.labels. glow-up rebrand, we love to see it. ✨

and here's the tea: the old version of d.labels from GRASS 5 — the one that gave you interactive placement and modification of paint labels — still needs to have its functionality merged into this module. so that feature is lowkey still waiting in the group chat to be added. 🫠

👀 SEE ALSO 👀

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

the whole friend group fr 💖

🎀 AUTHOR 🎀

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

(legend. absolute icon. respect. 🫡)

🔥 SOURCE CODE 🔥

Available at: d.labels source code (history)

Accessed: Saturday Jan 17 05:40:35 2026

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

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

okay that's the whole page bestie, we ate and left no crumbs 🍽️💅 GRASS 8.4.2, and yeah, this was d.labels(1) — mwah, love u, go paint some labels 💖✨🎀🦋

📦 where this page comes from