v.colors.out(1grass)

✨ NAME ✨

okay so listen bestie 💖 this one is v.colors.out — the GRASS manual page for it, specifically — and what it DOES is: it exports the color table associated with a vector map. that's it. that's the whole vibe. color table? exported. periodt. 🎀

---

🌸 KEYWORDS 🌸

vector, color table, export

iykyk — it's giving "color table but make it leave the building" 🦋

---

🌈 SYNOPSIS 🌈

v.colors.out
v.colors.out --help
v.colors.out [-p] map=name  [layer=string]   [rules=name]
[column=name]  format=name color_format=name  [--overwrite]  [--help]
[--verbose]  [--quiet]  [--ui]

---

🫶 Flags

• -p — outputs the values as percentages. cute, right?
• --overwrite — lets output files overwrite existing files. careful, bestie, it will absolutely not hesitate 💀
• --help — prints the usage summary. the "help me help you" option.
• --verbose — verbose module output. it talks more. we love a chatty king.
• --quiet — quiet module output. the opposite. shhh 🤫
• --ui — forces the GUI dialog to launch. main character energy, but with windows 🪟

✨ Parameters

• map=name — required. the name of the vector map. or, plot twist, a data source for direct OGR access.
• layer=string — layer number or name. here's the tea: vector features can have category values in different layers, and this number determines which layer to use. when you're using direct OGR access, this one is the layer name instead. default: 1.
• rules=name — path to the output rules file. if you don't give it one, it writes to standard output instead. no file, no problem 💅
• column=name — the name of the attribute (numeric) column that the color rules refer to. if you don't give it one, the color rules refer to categories instead.
• format=name — required. the output format.
  • Options: plain, json
  • Default: plain
  • plain: plain text output
  • json: JSON (JavaScript Object Notation)
• color_format=name — required. the color format, aka the color format for output values.
  • Options: rgb, hex, hsv, triplet
  • Default: hex
  • rgb: output color in RGB format
  • hex: output color in HEX format
  • hsv: output color in HSV format (experimental 👀 yes, experimental, tread lightly)
  • triplet: output color in colon-separated RGB format

---

💜 DESCRIPTION 💜

so what does v.colors.out actually do? it lets you export the color table for a vector map to a file — and bestie, that file is specifically formatted to be suitable as input to v.colors. it's a whole pipeline moment. you export here, you feed it there. iconic behavior, honestly. 🔥

---

🍓 EXAMPLES 🍓

v.colors.out map=soils_general rules=rules.txt
v.colors map=soils_wake rules=rules.txt

see how the second one hands rules.txt straight to v.colors? that's the glow-up arc. write it out, read it back in. ✨

---

👑 SEE ALSO 👑

v.colors, r.colors, r3.colors, r.colors.out, r3.colors.out

go read those too, bestie, they're all in the family 🫶

---

🎀 AUTHOR 🎀

Martin Landa, Czech Technical University in Prague, Czech Republic

---

⭐ SOURCE CODE ⭐

available at: v.colors.out source code (history)

latest change: Thursday Oct 23 20:57:28 2025, in commit 938e5b09359caaeb9cfd62cb2c7e847218001627

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

---

and that's the whole page, no cap 💖 this was GRASS 8.5.0, © 2003-2026 GRASS Development Team — the GRASS 8.5.0 Reference Manual energy throughout — and the very last thing on the page was just the version and date hanging out at the bottom: GRASS 8.5.0, v.colors.out(1grass). slay. 🌈✨💅