POLY_FORM(1)

💅 POLY_FORM(1) — User Commands 💅

🎀 NAME 🎀

poly_form — make face-regular and unscramble models 💖

✨ SYNOPSIS ✨

poly_form [options] [input_file]

💖 DESCRIPTION 💖

Okay bestie, here's the whole vibe: poly_form reads a file in OFF format containing a graph of a polyhedron — with or without vertex coordinates — and tries to create a spherical or ellipsoidal tesselation where the maximum edge is a minimum length. Or it tries to make the thing into a regular-faced polyhedron. Option adjustment factors expressed as a percentage are approximate, so don't come for me about exactness. If input_file is not given, the program reads from standard input. Slay. 💅

🛠️ Options 🛠️

• -h, --help — this help message (run off_util -H help for general help) 🫶
• --version — version information ⭐
• -a <alg> — model forming algorithm. The algorithm values are:
  • r — make faces into unit-edged regular polygons (default)
  • u — unscramble: place a small polygon on one side of a sphere or ellipsoid and the rest of the vertices at a point on the other side, then equalise shortest and longest edges attached to a vertex
  • U — equalise shortest and longest edges attached to a vertex on sphere or ellipsoid (use to continue unscrambling)
  • e — equalise edges on sphere or ellipsoid (default)
  • p — planarise
• -n <itrs> — maximum number of iterations; -1 means unlimited (default: 10000) 🔥
• -s <perc> — percentage to shorten longest edges on iteration (default: 1) ✨
• -k <perc> — adjustment percentage with two modes:
  • with -a r — percentage to reduce polygon radius on iteration (default: value of -s)
  • with -a e — percentage to reduce minimum target length on iteration (default: 1e-6); it will oscillate at certain precision, so process output with a smaller value to improve the solution 😭
• -f <perc> — percentage to reduce distance of vertex from face plane (-a rp) on iteration (default: value of -s) 🦋
• -y — maintain symmetry of the base model (with -a e/r/p) 👑
• -E <prms> — use ellipsoid; three numbers separated by commas are the axis lengths (for a superellipsoid an optional fourth number gives the power) 🌈
• -l <lim> — minimum change of distance/width_of_model to terminate, as negative exponent (default: 14 giving 1e-14) 💀
• -z <nums> — number of iterations between status reports (implies termination check) (0 for final report only, -1 for no report), optionally followed by a comma and the number of iterations between termination checks (0 for report checks only) (default: 1000,100) 🍓
• -o <file> — write output to file (default: write to standard output) 💾

🌈 SEE ALSO 🌈

The full documentation for poly_form is maintained as a Texinfo manual. If the info and poly_form programs are properly installed at your site, the command

info poly_form

should give you access to the complete manual. 🧚

💖 Footer sign-off, bestie: poly_form is from Antiprism 0.32, source link is http://..., and the manual tag is POLY_FORM(1). The original footer doesn't list a date, so I'm not inventing one — periodt. 🫶✨