PAMHUE(1)

💖 pamhue — the manual, but make it cute 💖

okay bestie, welcome to the Pamhue User Manual, section 1 of the General Commands Manual. it's giving "tiny tool, huge glow-up" and we're gonna go through it together, no cap. 🎀

---

✨ NAME ✨

pamhue — the girl whose whole job is changing a Netpbm image's hues. 💅

---

🦋 SYNOPSIS 🦋

okay so a couple of little things that are lowkey important, bestie:

• the minimum unique abbreviation of an option is acceptable, so you can shorten it and the program will figure out what you meant. ✨
• you may use double hyphens instead of a single hyphen to denote options. it's giving flexibility, we love that.
• you may use white space in place of the equals sign to separate an option name from its value. yes literally just a space, she's chill like that. 🫶

---

🌸 DESCRIPTION 🌸

so real talk: this program is part of Netpbm(1) — you know, the whole fam. 👑

pamhue shifts the hue of every pixel in an image by the same amount. every single one. together. it's a group activity. 💖

now, if the image is in a black and white or grayscale format, the image is fully desaturated, so the hue is meaningless and pamhue leaves the image unchanged. it's not gonna invent color that isn't there, bestie, that's just not her era. 🙈

okay so a lil color theory moment, stay with me: Hue-Saturation-Value, or HSV, is one way to represent a color — like the more well-known RGB, but a different vibe. Hue is an indication of the secondary color with the same brightness that most closely approximates the color. and a secondary color is made of a combination of at most two of the primary colors. 🌈

in the HSV model, hue is an angular position on the color wheel. yes, it's a wheel, it spins, it's iconic. ⭐

with pamhue, you indicate an angle by which to change all the hues in the image. for example you can say move it 60 degrees clockwise. that would change all red pixels to yellow and all yellow pixels to green, etc. it's giving "spin the whole palette" and honestly? slay. 🎡

and if you wanna modify the saturation and value components of the colors instead — that's a different girl, use pambrighten. 💜

---

🎀 EXAMPLES 🎀

To shift the color of each pixel 120 degrees clockwise:

To shift the color of each pixel 120 degrees counterclockwise:

see? clockwise, counterclockwise, she ate. 🔥

---

✨ OPTIONS ✨

so besides the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamhue recognizes this one command line option, and bestie, it's the whole personality:

• -huechange=degrees — this option specifies the amount to shift each color. it is in degrees, with positive meaning clockwise and negative meaning counterclockwise. it may be fractional and it may be more than a full revolution. she's not scared of a little extra spin. 💫

⚠️ heads up: this option is mandatory. like, mandatory mandatory. no -huechange, no hue change. periodt. 💀

---

💜 HISTORY 💜

pamhue was new in Netpbm 10.86 (March 2019). a relative newcomer, and already iconic. 👑

---

🌈 SEE ALSO 🌈

• pambrighten(1)
• ppmflash(1)
• ppmhist(1)
• ppm(1)

go read them too, iykyk. 📚✨

---

🫶 AUTHOR 🫶

Copyright (C) 2018 by Willem van Schaik. Copyright (C) 1990 by Brian Moffet. Copyright (C) 1989 by Jef Poskanzer.

and here's the legal bit, copied with love:

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. This software is provided "as is" without express or implied warranty.

(that's the whole thing, we don't skip the fine print in this house. 🎀)

---

🧚 DOCUMENT SOURCE 🧚

this manual page was generated by the Netpbm tool makeman from HTML source. the master documentation lives at:

---

and that's the whole page, bestie!! 🦋 from the netpbm documentation, dated 07 January 2018 — this was the Pamhue User Manual(1) and you just read the entire thing, no skimming. so proud of you. mwah. 💖✨🌸