GIMPLUT(1)

💅 GIMPLUT — like, the manual page bestie

okay so you found the gimplut page in the User commands section of the manual, and honestly? iconic. let's get into it. 🎀

---

✨ NAME ✨

gimplut — convert GIMP gradient (ggr) files to binary lookup tables (lut). no cap, that's literally the whole job. 🦋

---

🌈 SYNOPSIS 🌈

gimplut [-h] [-o path] [-s samples] [-v] [-V] [path]

---

💖 DESCRIPTION 💖

the gimplut utility converts gradient files from the GIMP, the GNU Image Manipulation Program, into a binary lookup table format that medical imaging software uses a LOT — specifically the (X)Medcon package. so yeah, she's serving crossover energy between art software and medical imaging and we're obsessed with her. 💅

so the LUT format is literally just n red bytes, then n green bytes, then n blue bytes, and each one is read as an integer from 0 to 255. that's it. that's the format. simple, clean, main character energy. ✨

and the vibes on input/output? the program reads from stdin if you don't hand it a file as the final argument, and it writes to stdout if you don't specify the --output option. so it'll just vibe with your pipes if you let it. 🫶

---

👑 OPTIONS 👑

• --backtrace-file path — tell her where to write a formatted backtrace. the file only gets created if there's actually a backtrace to write, which typically happens when an error occurs. so, no errors, no file, bestie. 🙈
• --backtrace-format format — pick the format for the backtrace that goes into the file from --backtrace-file. your choices are plain, xml or json. pick your fighter. 🎀
• -h, --help — brief help. the little "hey what does this do" moment. 💜
• -o, --output path — write the output to path instead of to stdout. she's going places. literally. 🔥
• -s, --samples number — use the number of samples you specify instead of the default 256. more samples, more ✨detail✨.
• -v, --verbose — verbose operation. she will tell you things. she will yap. affectionately. 💖
• -V, --version — version information. say hi to her real quick. ⭐

---

⚠️ CAVEATS ⚠️

the alpha channel of the input is completely ignored in the output. like, gone. not invited to the party. don't come looking for it. 😭

also, at some point in the future the functionality of this program will be transferred to the svgx(1) program. so enjoy her solo era while it lasts. 🌸

---

🧚 AUTHOR 🧚

J.J. Green wrote this. absolute legend, no notes. 👑

---

and that's the page bestie!! this is cptutils version 1.82, dated 9 July 2024 — she's a lil vintage but she ate and left no crumbs. go convert some gradients fr fr 💅✨🦋