GEGL(1)

GEGL(1) β€” User Commands πŸ’–

okay bestie so this is the GEGL library manual page, aka the gegl command's own little user-commands moment. Pull up a chair, we're doing this together. πŸŽ€


✨ NAME ✨

gegl β€” GEGL library manual page πŸ’…


🌸 DESCRIPTION 🌸

so the whole vibe starts here, and the usage is literally:

usage: gegl [options] <file | -- [op [op] ..]>

and then it's like. Options: and it hands you the whole menu. here's the menu, no skips, no crumbs: ✨

  • -h, --help β€” this help information 🫢
  • --list-all β€” list all known operations πŸ‘‘
  • --exists β€” return 0 if the operation(s) exist βœ…
  • --properties β€” output the properties (name, type, description) of the operation πŸ”
  • -i, --file β€” read xml from named file πŸ“„
  • -x, --xml β€” use xml provided in next argument πŸ“₯
  • --dot β€” output a graphviz graph description πŸ•ΈοΈ
  • -o, --output β€” output generated image to named file, type based on extension. πŸ–ΌοΈ
  • -p β€” increment frame counters of various elements when processing is done. πŸ”’
  • -s scale, --scale scale β€” scale output dimensions by this factor. πŸ“
  • -X β€” output the XML that was read in πŸ”
  • -v, --verbose β€” print diagnostics while running πŸ—£οΈ

then, and this is the part that's actually iconic: all parameters following -- are considered ops to be chained together into a small composition instead of using an xml file, this allows for easy testing of filters. but be aware β€” and I need you to hear me on this one, bestie β€” the default value will be used for all properties. 😭 so don't come crying to me when your properties aren't what you set them to, because you didn't set them.

and then, because the universe is funny, we get this absolute moment:

unknown parameter '--version' giving you help instead

πŸ’€ not the program catching an unknown parameter and just deciding to give you help instead. so thoughtful. so unbothered. so giving.

which means... we run the whole thing again. yes really. here it is, same energy, same facts, and the usage:

usage: gegl [options] <file | -- [op [op] ..]>

Options: ✨ (yes, the whole list, again, she's consistent):

  • -h, --help β€” this help information 🫢
  • --list-all β€” list all known operations πŸ‘‘
  • --exists β€” return 0 if the operation(s) exist βœ…
  • --properties β€” output the properties (name, type, description) of the operation πŸ”
  • -i, --file β€” read xml from named file πŸ“„
  • -x, --xml β€” use xml provided in next argument πŸ“₯
  • --dot β€” output a graphviz graph description πŸ•ΈοΈ
  • -o, --output β€” output generated image to named file, type based on extension. πŸ–ΌοΈ
  • -p β€” increment frame counters of various elements when processing is done. πŸ”’
  • -s scale, --scale scale β€” scale output dimensions by this factor. πŸ“
  • -X β€” output the XML that was read in πŸ”
  • -v, --verbose β€” print diagnostics while running πŸ—£οΈ

and once more for the people in the back: all parameters following -- are considered ops to be chained together into a small composition instead of using an xml file, this allows for easy testing of filters. and the default value will be used for all properties. 😭

okay but fr fr, the double-print thing is literally what the page shows, I'm not making it up. the --version moment happened and the help came out twice. slay, I guess. πŸ’…

πŸ¦‹ SEE ALSO πŸ¦‹

the full documentation for gegl is maintained as a Texinfo manual πŸ“š. if the info and gegl programs are properly installed at your site, the command

info gegl

should give you access to the complete manual. ✨ go read it, bestie, she's thorough.


and that's the whole page, no notes. 🫢 this was the gegl page, from the User Commands section of the manual, and the footer energy is gegl, July 2015, and GEGL(1) β€” so yeah, July 2015, iconic date, we love a vintage moment. byeee! πŸ’–πŸŒΈπŸ¦‹