MCOLOR(7)

🎨 MCOLOR(7) — the color & reverse-video macro package (Macro Packages girlies rise 💅)

okay so bestie, listen. mcolor is a macro package for picking colors and doing reverse video printing on PostScript printers. That's the whole vibe. It plays nice with most existing macro packages (lowkey rare, highkey iconic) and it gives you exactly one macro to obsess over. Slay. ✨

---

🌸 SYNOPSIS 🌸

troff -mcolor [ options ] file ...

---

💖 DESCRIPTION 💖

mcolor is your macro package for color selection and reverse video printing on PostScript printers. It's compatible with most existing macro packages, and it ships with this one macro:

• .CL color text — prints text in color. If you give it no arguments at all, it restores the default color (which is black, in RGB color space — the classic, the moment, the blueprint 🖤). If you leave out text, the color you picked just stays in effect until you select another one. And if you give it two arguments, the text gets printed in color and then the default color is restored right after. Clean. Tidy. Periodt.

You can pick both the text color and the background color, btw — a color argument shaped like `color1 on color2` prints your text in color1 on top of a background in color2. It's giving layered lewk. 🎀

Once a color is in effect, it gets re-installed at the top of every single output page. No cap — every page, every time. 📄✨

---

🦋 ARBITRARY POSTSCRIPT COLOR PARAMS 🦋

You can set arbitrary PostScript color parameters by using color arguments like these:

• red green blue rgb — e.g. `.CL ".2 .3 .4 rgb"`
• hue saturation brightness hsb — e.g. `.CL ".5 .6 .7 hsb"`
• cyan magenta yellow black cmyk — e.g. `.CL ".1 .2 .3 .4 cmyk"`
• gray setgray — e.g. `.CL ".5 setgray"`
• [$setcolorspace] comp1 comp2 ... compn setcolor — where $setcolorspace may be a PostScript procedure defined in the setup section using a \X´PSSetup: $setcolorspace { ... } bind def´' escape sequence. This parameter is required if the color space changes inside your document. Otherwise, it may be sufficient to just install the color space once in the setup section. iykyk 🧚

Every parameter has to be a number in the range between 0.0 and 1.0, bestie. Watch those bounds. 🙈

In the most general case, the value of the color argument is passed uninterpreted to the PostScript output. No thoughts, just vibes, straight through. 💫

Named colors (RGB only, don't forget) must be listed in the colordict dictionary in the file /usr/share/heirloom-doctools/font/devpost/postscript/color.ps.

---

🍓 FILES 🍓

• /usr/share/heirloom-doctools/tmac/color
• /usr/share/heirloom-doctools/font/devpost/postscript/color.ps

---

🌈 SEE ALSO 🌈

• troff(1)
• dpost(1)

go give them a read, they're literally the supporting cast and they ate 🫶

---

👑 NOTES 👑

Using the .CL macro isn't always the move, because it may — like every macro, fr fr — result in added spaces. 😭 If that's a problem, you can use \X´SetColor: color´ directly to dodge it entirely. Its color argument has exactly the same syntax as the first argument to .CL, e.g. \X´SetColor: .2 .3 .4 rgb´. Same energy, zero extra spaces. Iconic. ⭐

---

mwah 💋 that's the whole page — brought to you by the Heirloom Documentation Tools, dated 2/2/07, and forever filed under MCOLOR(7). now go make something pretty, bestie 🎀🦋💜