JSURF-ALGGEO(1)

✨ JSURF-ALGGEO(1) ✨

okay bestie so we're in manual section 1 and this whole thing comes to you courtesy of IMAGINARY.org 💖

🌸 NAME 🌸

jsurf-alggeo — a Java based renderer for real SURFaces, aka the ALGebraic GEOmetry dedicated tool. yes it's a mouthful, no we're not shortening it, it's iconic 🎀

---

🦋 DESCRIPTION 🦋

so the usage goes like this, copy it exactly bestie:

jsurf-alggeo [options...] {jsurf_input|-} [png_output|-]

jsurf-alggeo is a renderer for real algebraic surfaces. she takes her own little language script files (usually with the extension '.jsurf', iykyk) and translates them into Portable Network Graphics (PNG) files. and what is PNG? it's a raster graphics file format that supports lossless data compression. the more you know 💅

if you don't specify the output filename, the output goes into a file with the same basename and a '.png' extension, dropped right in the current working directory. lowkey convenient.

and here's the cute part: either the input filename or the output filename can be '-' to request reading from stdin or writing to stdout, respectively. so you can pipe her around like the main character she is 🫶

whenever the Graphic Unit Interface (GUI) is available, the gui option takes precedence over the output options — otherwise it's just ignored. so basically: whenever the gui option is present (and available), your render gets displayed in a window instead of being written to a PNG file. periodt.

• --gui — display rendering (overrides output options) 👑
• --help — display this help text and exit. short, sweet, helpful, we love her 🌈
• -o, --output <arg> — output PNG into this file (overrode by the 2nd argument if present). yes it says "overrode", we don't make the rules 🙈
• -q, --quality <arg> — quality of the rendering, and the levels are: 0 (low), 1 (medium, default), 2 (high), 3 (extreme). extreme!! she said extreme!! 🔥
• -s, --size <arg> — image width and height (default: 512). one number, both dimensions, square vibes only ⭐
• --version — print program version and exit 🎀

fr fr bestie, don't sleep on the fact that the gui option is the one that wins — if your window shows up, your -o is getting ignored and that's by design, not a bug 💀

---

and that's the whole page, no cap. this little number is jsurf-alggeo 0.4.1+ds-6, dated April 2025 — thanks for coming to my ted talk, ily, go render something gorgeous 🧚💜