man(7)

πŸ’– cgalsimp2 β€” the man page, but make it cute πŸ’–

okay so bestie, this is the man(7) page for cgalsimp2, and no cap it's giving triangular surface mesh simplification energy. sit down, grab a strawberry πŸ“, and let's get into it.


✨ NAME ✨

cgalsimp2 β€” triangular surface mesh simplification. that's the whole vibe. πŸ’…


🌸 SYNOPSIS 🌸

cgalsimp2 input.off keepratio

literally just two things and you're done, iykyk. 🫢


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so cgalsimp2 is a surface mesh simplification utility, and it's built on the CGAL library (that's http://cgal.org if you wanna go look, which you should, it's iconic).

this tool uses the Lindstrom–Turk algorithm and decimates a surface mesh into a coarser, downsampled surface. like, it takes your mesh and it ate down to something smaller. periodt.

the output mesh gets stored in a file named "out.off". that's the name, don't fight it. πŸ’–

if you want the whole lore on the underlying algorithm, please see https://doc.cgal.org/latest/Surface_mesh_simplification/. go read it, it's a whole thing. πŸ“–βœ¨


πŸ’… OPTIONS πŸ’…

this program accepts the following input parameters (yes, both of them, both required, no you can't skip one):

  • input.off | (required) β€” the input surface mesh, in the OFF format. it's required bestie, you can't just not bring it.
  • keepratio | (required) β€” a 0–1 floating point number denoting the percentage of edges that will be preserved. and yes, 1-keepratio is the percentage of edges that will be decimated, so the math is mathing. now here's the tea: if keepratio is negative, it triggers the "LindstromTurk placement" policy; otherwise, it uses a mid-point placement policy, by clapsing an edge to its mid-point. so like, negative = one vibe, everything else = the mid-point vibe. πŸ‘‘

πŸ”₯ SEE ALSO πŸ”₯

cgalmesh(7), cgalsurf(7), cgalpoly(7), cork(7), meshfix(7), jmeshlib(7)

the whole friend group, go say hi. 🫢✨


πŸŽ€ AUTHOR πŸŽ€

Qianqian Fang (fangqq@gmail.com), Fernando Cacciola and Andreas Fabri


and that's the page!! πŸ’– version 1.0, dated 30 June 2020, straight from the cgalsimp2 man page. slay, go simplify something, mwah πŸ’‹πŸŒˆ