GIMPSVG(1)

💖 GIMPSVG 💖

ok so real talk bestie, this is the manual page for gimpsvg from the User commands section, and it's literally about turning GIMP gradient files into SVG. yes. that's the whole vibe. let's go 🦋

---

✨ NAME ✨

gimpsvg — convert a GIMP gradient (ggr) to the SVG format.

like. that's it. that's the girl's whole job 💅

---

🌸 SYNOPSIS 🌸

gimpsvg [-g geometry] [-h] [-o path] [-p] [-s samples] [-v] [-V] [path]

---

🎀 DESCRIPTION 🎀

okay so here's the tea 🍓 — the gimpsvg utility converts gradient files from the GIMP (that's the GNU Image Manipulation Program, iykyk) over to the SVG format, which stands for scalar vector graphics.

and the way it handles input/output is lowkey iconic:

• no file as the final argument? it reads from stdin. slay, it's flexible like that 🫶
• no --output option? it writes to stdout. main character energy fr fr.

---

👑 OPTIONS 👑

• --backtrace-file path — tell it where to write a formatted backtrace. ngl the file only gets created if a backtrace actually happens, which is usually when an error occurs 😭 so most of the time it's just. not there.
• --backtrace-format format — pick the format for the backtrace that goes to whatever file you set with --backtrace-file. you gotta choose one of plain, xml, or json. those are the only options bestie, don't try to be creative 💀
• --comments-read path — read the comments from the path you specify and add them to the output gradient ✨

the format is literally just a plain text multi-line document, no comment delimiters at all — the program adds those itself. so don't stress about formatting, it handles it 💅

• --comments-generate — create a comment with summary data in the output file. that's the date of creation, plus the name and version of the cptutils package. cute little receipts 🧚
• -g, --geometry widthxheight — set the size of the SVG preview, in pixels. yes it's literally width x height, keep the x in there.
• -h, --help — brief help. a little snack of information 🌈
• -o, --output path — write the output to path instead of stdout. giving it a home 🏠
• -p, --preview — include a preview in the SVG output. also go look at the --geometry option, they're besties and they work together 💖
• -s, --samples number — set the maximum number of samples. okay so here's the lore: GIMP gradients allow for complex curves across a bunch of colour-space co-ordinate systems, and to squish those into SVG's simple RGB linear splines we have to sample those complex curves pretty densely. --samples specifies (roughly) the maximum number of samples. BUT — if the GIMP gradient is an RGB linear spline gradient, this option does nothing at all, because in that case we can convert the segments without loss. so like, no effect, zero, nada 🙈
• -v, --verbose — verbose operation. it will tell you things. lots of things. it's a yapper 🗣️
• -V, --version — version information ⭐

---

🌟 AUTHOR 🌟

J.J. Green — the legend, the icon, the moment 👑

---

💜 SEE ALSO 💜

• svgx(1)

---

and that's the whole page bestie, no cap, we kept every single detail 💖

cptutils version 1.82, dated 9 July 2024 — mwah, sending you off with a kiss and a perfectly converted gradient 🎀✨🦋