SWEEP_EDGES(1)

🦋 sweep_edges(1) — the sweep_edges girlies' field guide

Ok so bestie, listen — this is a User Commands page, and the whole vibe is: take an edge, sweep it, get a surface. Iconic behavior honestly. Let's get into it 💅

---

✨ NAME ✨

sweep_edges — sweep edges to make a surface. That's it, that's the whole gig. 💖

---

🎀 SYNOPSIS 🎀

sweep [options] input

---

🌸 DESCRIPTION 🌸

So here's the tea ☕ — this program reads an input model in OFF format and transforms it over and over again, producing a polygonal surface made out of the quadrilaterals that the edges sweep out. Literally each step, the input model gets transformed according to whatever transformations you specified, and those transformations can be defined using the sweep progress variables FRAC and ANG.

FRAC runs from 0.0 at step 0 all the way to 1.0 on the final step, bestie. So:

FRAC = current_step / total_steps ANG = 360.0 * FRAC

Lowkey obsessed with how clean that is. ✨

Colours are taken from the input model if the beginning of the sweep does not coincide with the end, or if option -O is set. Otherwise, sweep circuits are found and the colours get set from the colour map (that's option -m, more on her below 🌈).

Vertex colours are used for final vertices and swept vertex edges. Edge colours are used for swept edge faces. Very demure, very mindful, very assigned-by-element-type. 🫶

And if input is not given, the program reads from standard input. No input? No problem. 💀

---

💜 Options 💜

• -h,--help — this help message (and hey, run off_util -H help for general help while you're at it)
• --version — version information, iykyk
• -n <int> — number of steps (default: 12)
• -T <tran> — translate! Three numbers separated by commas, used as the x, y and z displacements.
• -R <rot> — rotate about an axis. Three, four or six numbers separated by commas 👀:
  • If three numbers, these are angles (degrees) to rotate about the x, y and z axes.
  • If four numbers, the first three are a direction vector for the axis, and the last number is the angle (degrees) to rotate.
  • If six numbers, these are two vectors (from,to) and rotate to carry the first to the second.
  • If twelve numbers, these are four vectors (from1,from2,to1,to2) and rotate to carry the first onto the third, then rotate around the third to carry the second onto the fourth.
• -M <norm> — reflect in a plane. Three numbers separated by commas giving a vector normal to the plane of reflection. 🪞
• -S <scal> — scale. One, three or four numbers separated by commas:
  • If one number, scale by this factor in all directions.
  • If three numbers, these are the factors to scale along the x, y and z axes.
  • If four numbers, the first three are a direction vector for the scaling, and the last number is the factor to scale.
• -I — inversion. Just. Inversion. Periodt. 🔥
• -A <crds> — a transformation that will align two sets of three points (18 numbers: coordinates of from1,from2,from3,to1,to2,to3)
• -a <angs> — a transformation that makes particular angles between the mapped axes. Angles in degrees, in the form yz_ang,zx_ang,xy_ang (corresponding to the angles opposite the x-, y- and z-axis)
• -X <mtrx> — transformation matrix of 9 or 12 values, given left-to-right top-to-bottom, used to premultiply each coordinate
• -i — replaces the current combined transformation by its inverse 🙃
• -t — triangulate
• -O — do not join coincident sweep ends
• -l <lim> — maximum distance between vertices that should be coincident. lim is an integer representing the negative exponent of the distance (default: 8, giving 1e-08)
• -m <maps> — a comma separated list of colour maps used to transform colour indexes (default: rand). A part consisting of letters from v, e, f selects the element types to apply the map list to (default 'vef'). The 'compound' map should give useful results. 🌈
• -o <file> — write output to file (default: write to standard output)

---

👑 SEE ALSO 👑

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

info sweep_edges

should give you access to the complete manual. Slay. 💅

---

ngl bestie, if something here is giving deprecated or undefined energy, take it seriously — but everything above is straight from the source, no cap. 🫶

Ok that's the whole page, mwah 💖 — brought to you by sweep: Antiprism 0.32 - http://www.... , filed under SWEEP_EDGES(1). Go sweep some edges, you absolute icon. 🦋✨