d.title(1grass)

💖 d.title — the GRASS User's Manual era 💖

okay bestie, sit down, hydrate, and let's talk about d.title from the GRASS manual. this is the whole page, nothing skipped, all vibes intact. 🫶

---

✨ NAME ✨

d.title — make a TITLE for a raster map, in a format that's ready to get served up by d.text. it's giving label-maker but make it GIS. 💅

🌸 KEYWORDS 🌸

display, cartography — yes she's a cartography girlie, periodt.

🎀 SYNOPSIS 🎀

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

🦋 Flags 🦋

• -d — draw the title on the current display. she's doing it live, no rehearsal.
• -f — do a fancier title ✨ extra, elevated, main character energy.
• -s — do a simple title. lowkey, understated, still iconic.
• --help — print usage summary. when in doubt, ask her. 🙈
• --verbose — verbose module output. she tells you EVERYTHING.
• --quiet — quiet module output. she says nothing. mysterious. 💀
• --ui — force launching GUI dialog. point-and-click mode, no cap.

🍓 Parameters 🍓

• map=name [required] — name of raster map. this one is mandatory bestie, she's not optional. 👑
• 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 💅

so here's the tea: d.title generates a string to standard output that d.text can use to draw a TITLE for your raster map layer's name, inside the active display frame on the graphics monitor. literally it's the hype-woman for d.text. 🫶

the output that d.title makes can be redirected into a file, OR piped straight into d.text to display the map TITLE that d.title cooked up. the map TITLE she creates will include:

• the map layer's name
• TITLE
• MAPSET
• LOCATION_NAME
• geographic region boundary coordinates
• cell resolution

and if you use the -d draw flag? she calls d.text for you, and the title gets rendered to the display automatically. not me being helpful, it's just who she is. 😭

---

🌈 NOTES 🌈

⚠️ heads up bestie: the text created with d.text will not necessarily fit within the active display frame on the graphics monitor. you, the user, should choose a text size appropriate to this frame. size matters here, fr fr.

---

⭐ EXAMPLES ⭐

say a user wants to create a suitable TITLE for the Spearfish, SD soils map layer, and display that TITLE in the active display frame on the graphics monitor. she might type this:

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

or alternately, she 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. and here's the important bit — information contained in this file takes precedence over the color and size parameters for d.text. so the file wins. always. 💀👑

---

💜 SEE ALSO 💜

• d.font
• d.text

---

👑 AUTHOR 👑

James Westervelt, U.S. Army Construction Engineering Research Laboratory — thank you for your service, king. 🫡

---

🔥 SOURCE CODE 🔥

Available at: d.title source code (history)

Latest change: Thursday May 08 14:17:52 2025 in commit: 3caa352f78f86a51ca463a6f1ba7ffe3db9771df

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

---

and that's the whole page bestie, no crumbs left on the plate 🍓✨ — this was d.title from GRASS 8.5.0, © 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual, last touched by that commit on Thursday May 08 14:17:52 2025. mwah. 💖🎀🦋