r.colors.out(1grass)

💖 r.colors.out — the manual page, bestie edition ✨

okay so welcome to r.colors.out, part of the 1grass manual set (GRASS User's Manual, if we're being formal 💅). It's the lil tool that takes a raster map's color table and yeets it out into the world. Let's get into it 🫶

---

🌈 NAME

r.colors.out — exports the color table associated with a raster map. that's it, that's the whole job. iconic behaviour, honestly 💖

---

🎀 KEYWORDS

raster, color table, export

---

✨ SYNOPSIS

r.colors.out
r.colors.out --help
r.colors.out [-p] map=name  [rules=name]  format=name color_format=name
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

---

🚩 Flags

• -p — output the values as percentages, not as raw whatever. yes bestie, percent it up 🌸
• --overwrite — lets output files just go ahead and overwrite files that already exist there. bold of you, but ok 🔥
• --help — prints the usage summary. the classic "wait what does this do again" button 🙈
• --verbose — verbose module output. it will talk. a lot. 💬
• --quiet — quiet module output. it will NOT talk. shhh 🤫
• --ui — forces a GUI dialog to launch, for when you want buttons instead of typing 🖱️✨

---

🧚 Parameters

• map=name — required, bestie. the name of the raster map. give us the map 🗺️
• rules=name — path to the output rules file. if you don't give it, it just writes to standard output instead, no biggie 💜
• 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 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 — tread carefully, bestie ⚠️)
  • triplet — output color in colon-separated RGB format

---

💫 DESCRIPTION

So r.colors.out lets you export the color table of a raster map to a file, and it's designed so that the file it spits out is suitable as input to r.colors. it's giving round-trip. it's giving circular. we love a tool that feeds its bestie 🫶

---

🌸 EXAMPLES

r.colors.out map=el_D782_6m rules=rules.txt
r.colors map=el_D783_6m rules=rules.txt
r.colors.out map=el_D782_6m rules=rules.json format=json

look at that pipeline energy. exporting, then feeding it right back in. slay 💅

---

👀 SEE ALSO

• r.colors

---

👑 AUTHOR

Glynn Clements

---

📜 SOURCE CODE

Available at: r.colors.out source code (history)

Latest change: Thursday Dec 18 07:11:47 2025 in commit: cf870a5e49fd2643a55de543467edf5c2e61d640

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

---

okay that's the whole page bestie, go forth and export those color tables 💖✨

sign-off time: this is GRASS 8.5.0, from the GRASS 8.5.0 Reference Manual, © 2003-2026 GRASS Development Team — yep, 2003 all the way to 2026, that's longevity, that's main character energy fr fr 🎀 no cap, the manual name was r.colors.out(1grass) the whole time. bye bestie 👋💜