COL_UTIL(1)

💖 NAME 💖

col_util — colour utilities including plots and blends, bestie. Manual name near the top so you don’t forget: COL_UTIL(1) ✨

✨ SYNOPSIS ✨

col_util [options]

🌸 DESCRIPTION 🌸

The whole vibe: various plots of maps, colors and blendings. It’s giving colorful little science fair, but make it Unix. 😌

🎀 Options 🎀

• -h, --help — pops this help message (and for general help, run off_util -H help) 🫶
• --version — version information, no cap.
• -o <file> — write output to file (default: write to standard output) 💾
• -f <type> — for output type 4, the map is output instead of the OFF file
  • map type: rgb=1, antiprism=2, decimal=3 (default: 1) 🌈

🎨 Scene Options 🎨

• -M <mode> — color system mode: HSV=1, HSL=2, RGB=3 (default: 2) 🎛️
• -d <int> — output type: plot=1, wheel=2, grid=3, map=4 (default: 1)
• -y — RYB mode. Blend colors as in the Red-Yellow-Blue color wheel 💛
• -c — CMY mode. Complementary colors. RGB->(RYB/GMO)->CMY->blend 🔁
• -b <val> — brightness adjustment. valid values -1.0 to +1.0 (default: 0)
  • negative for darker, positive for lighter, 0 for no change
  • (-y also affects location of color on plot. -c and -b affect all colors in all output types)

🧮 Output for grid (-d 3) Options 🧮

• -w <int> — width of grid. positive integer. (default: automatic)
  • keyword: b - display as color bars
• -I — exclude map indexes on grid

📊 Output for plot (-d 1) Options 📊

• -r <int> — HSV/HSL container (default: 4)
  • cylinder=1, conic=2, hexagonal=3, cube=4
• -S — HSV/HSL distribute colors heptagonally, 7 ways, as in the rainbow 🌈
• -k <int> — container visibility (default: 2)
  • 0 - suppress, 1 - no facets (-r 3), 2 - full
• -z <int> — 1 - show model upright, 2 - upright, don't rotate cube (RGB -M 3)
• -q <int> — height of cone or pyramid (-M 2, -r 2,3) (default: no change)
  • 1 - double, 2 - make perimeter angle 90 degrees dihedral
• -R — show reference primary and secondary colors on containers 👑

💅 Color Blending Options (-d 1, -M 1,2, -p) 💅

• -p — plot color centroid (or multiple centroids -s, -v)
• -V — verbose output. show color blend RGBA components
• -s <sat> — HSV/HSL saturation curve. Greater than 0 (default: 1)
  • 1.0 - no curve. lower than 1.0 makes blends more pastel 4 numbers can be entered separated by commas
• -t <val> — HSV/HSL threshold to use average saturation (default: 1)
  • between 0.0 (all averaging) and 1.0 (no averaging)
• -v <val> — HSV/HSL value curve. Positive integer (default: 0)
  • simulates subtractive coloring for blending 3 or more colors
  • RGB: Red+Green+Blue = White Cyan+Magenta+Yellow = Black
  • RYB: Red+Yellow+Blue = Black Green+Magenta+Orange = White
  • 1.0 - no curve. lower than 1.0 number makes blends lighter
  • 0.0 - use average value instead
  • 4 numbers can be entered separated by commas
• -u <val> — HSV/HSL value advance. Rotates meaning of blend to white and black
  • valid values 0.0 to 120.0 degrees (default: 0)
• -a <int> — alpha for blend. average=1, minimum=2, maximum=3 (default: 3)

🖍️ Coloring Options (run off_util -H color for help on color formats) 🖍️

• -m <map> — get colors from a color map, or multiple maps separated by commas
• -O <file> — get colors from an OFF file
  • note: -m and -O may be used together
• -U <opt> — sort colors. s - simple, u - unique (by hue, saturation, value)
• -Z <int> — maximum entries to read from open ended maps (default: 256)

🦋 SEE ALSO 🦋

The full documentation for col_util is maintained as a Texinfo manual. If the info and col_util programs are properly installed at your site, the command

info col_util

should give you access to the complete manual. 📚

---

Footer sign-off, bestie: this page is col_util from Antiprism 0.32, and the footer also has the truncated URL bit http://w.... The date part is giving “not shown in this copy,” so I’m not out here inventing one. Periodt. 💅