TO_NFOLD(1)

💅 TO_NFOLD(1) — like, the manual, but make it make sense 🎀

okay bestie, settle in, because this one is genuinely iconic. it's to_nfold from the Antiprism crew — a User Command, and the way it just ✨reshapes your polyhedra✨? obsessed.

---

🌸 NAME 🌸

to_nfold — change the rotational symmetry of a polyhedron. that's it, that's the whole vibe. it takes a shape with one kind of symmetry and says "no babe, we're doing a different number of folds today" 💫

---

✨ SYNOPSIS ✨

to_nfold [options] fraction [input_file]

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — to_nfold generalises an axial model by changing its rotational symmetry. it reads a model, in OFF format, that has an m-fold rotational axis sitting pretty on the z-axis, and then it creates a brand new model — generally non-planar, ngl, that's the whole point — with the same relative connections, but with an n-fold axis instead. glow-up complete 💅

fraction is given as n, or n/d (where n and d are integers). real simple, no cap.

the math? vertices of a face that were originally separated by x/m of a turn around the z-axis will be separated by xd/n of a turn in the final model. 🔥 literally just doing the rotation math for you so you don't have to.

the new model will be symmetrically coloured using colours from the base model — so your aesthetic carries over, we love continuity 🎀

if input_file is not given, the program reads from standard input. classic. 😌

and fun fact for the girlies who care about lore: to_nfold is based on an idea by Bruce R. Gilson. we stan a visionary 🫶

---

💖 Options 💖

• -h,--help — this help message, i.e. the little "here's what I do" moment. (and if you want the general help, run off_util -H help — that's the big-picture one 🧚)
• --version — version information. just the numbers, ma'am 💀
• -x <idxs> — vertex index numbers, separated by commas. the rings including these vertices will be rotated 180 degrees before processing and rotated back afterwards. so, like, a little spin-around-and-spin-back situation 🙈
• -p <args> — transform ring of vertices of base model, and suppress normal to_nfold processing. args are two or three numbers separated by commas: the vertex index number (which specifies the ring), the scale-xy factor (that's the ring radius), and an optional translation-z (the ring height). can be used multiple times. index numbers are preserved. 👑
• -o <file> — write output to file (default: write to standard output). your choice, bestie ✨

---

🌈 SEE ALSO 🌈

the full documentation for to_nfold is maintained as a Texinfo manual. so if the info and to_nfold programs are properly installed at your site (fingers crossed 🤞), the command

info to_nfold

should give you access to the complete manual. go get your reading on 📚💜

---

⭐ little reminder babe: the manpage literally says "the full documentation is maintained as a Texinfo manual" — so info to_nfold is the real main character here. --help is just the appetiser 🍓

---

and that's the whole page, you're welcome 💖 this was to_nfold from Antiprism 0.32 — yes, version 0.32, and the source lives at http://w... (that's literally how it shows up in the footer, don't come for me 😭). no cap, that's the sign-off, periodt. 👑🦋