QGSSVG(1)

📦 version 1.82, in fedora 43, fedora 44

💖 QGSSVG 💖

okay bestie, so this is qgssvg — it lives in the User commands section of the manual, and it's here to do one very specific, very slay thing: turn your QGIS colour-ramps into SVG gradients. no cap.

✨ NAME ✨

qgssvg — convert QGIS colour-ramps to SVG gradients. that's it, that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

qgssvg [-h] [-o path] [-v] [-V] path

🦋 DESCRIPTION 🦋

so like, qgssvg converts QGIS colour-ramps into the SVG format. periodt. but here's the tea that makes it different from the rest of the cptutils fam: most of the other file formats in the cptutils package are one-gradient-at-a-time energy, but QGIS ramps can hold multiple gradients, and every single input gradient gets converted into a gradient in the output file. all of them. the whole squad. 💅

then once you've got that SVG, you can call up svgx(1) to extract single gradients and/or convert them into other formats. iconic teamwork fr fr.

and atypically — yes, we're using the word atypically, it's giving fancy — the path to the input QGIS colour ramp is required. you gotta give it the file. but if you don't pass the --output option, it'll write to stdout instead. no biggie.

now the sad part 😭: at present, only colour-ramps of type gradient can be converted — so version 2 preset ramps will be skipped. same deal for those gradients which have the discrete attribute set true. and listen, this restriction will hopefully be lifted in a later version, so don't come for the devs, they're working on it. 🙈

💅 OPTIONS 💅

  • --backtrace-file path — pick a file to write a formatted backtrace to. lowkey important: the file only gets created if there's actually a backtrace to write, which typically happens when an error occurs.
  • --backtrace-format format — tell it what format to use for the backtrace written to the files specified by --backtrace-file. your choices are plain, xml or json. pick your fighter.
  • --comments-read path — read the comments from the specified path and add them to the output gradient. the format is literally just a plain text multi-line document with no comment delimiters — the program adds those for you. we love a low-effort moment. 🫶
  • --comments-retain — use the comments in the input file as the comments for the output file. recycling! sustainable queen. 🌈
  • --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. little timestamped receipt, cute. ⭐
  • -h, --help — brief help. it's giving helpful.
  • -o, --output path — write the output to path, rather than stdout. (yes, this is the one that saves you from the stdout situation mentioned up in DESCRIPTION.)
  • -v, --verbose — verbose operation. it'll talk more. we love a chatty icon. 💀
  • -V, --version — version information.

🔥 EXAMPLE 🔥

convert a QGIS colour-ramp, foo.qgs, to a set of GIMP gradients:

qgssvg -v -o tmp.svg foo.qgs
svggimp -v -a tmp.svg

see how it's a two-step? qgssvg does the SVG thing, then svggimp takes it to GIMP gradient town. the pipeline ate and left no crumbs. 👑

👑 AUTHOR 👑

J.J. Green

🌟 SEE ALSO 🌟

svgx(1)

and that's the whole page bestie — this was cptutils 1.82, dated 9 July 2024. mwah 💖 go convert some ramps, you got this fr fr. 🧚✨

📦 where this page comes from