ADMESH(1)

Okay bestie, welcome to the ADMESH(1) page, the General Commands Manual entry for ADMesh, so it's official and it's giving main character 💅🎀

✨ NAME ✨

ADMesh 💖 is a program for processing triangulated solid meshes 🫶

🎀 SYNOPSIS 🎀

admesh [OPTION]... file

🌸 DESCRIPTION 🌸

Okay so, ADMesh is a program for processing triangulated solid meshes ✨ Right now it only reads the STL file format (the one used for rapid prototyping apps), but it can write STL, VRML, OFF, and DXF files too 💅

By default, ADMesh runs all of the mesh checking and repairing options on your input file 🔥 That means it checks exact, nearby, remove-unconnected, fill-holes, normal-directions, and normal-values. The file type (ASCII or binary) gets detected automatically 🧚 Your input file is not modified unless you ask for it with the --write option 🙈 So if you type this:

admesh sphere.stl

ADMesh opens and reads sphere.stl, checks it, fixes anything that needs fixing, and prints the results. The results are not saved 💀

The default tolerance is the length of the shortest edge of the mesh 📏 The default number of iterations is 2, and the default increment is 0.01% of the diameter of a sphere that encloses the entire mesh ✨

⚠️ If you give any of --exact, --nearby, --remove-unconnected, --fill-holes, --normal-directions, --reverse-all, --normal-values, or --no-check, then ADMesh skips every other check, except the ones you ask for or the ones it needs before your chosen check can run 😤

For example, this command:

admesh --remove-unconnected sphere.stl

would first do an exact check, since it's required, and then remove the unconnected facets. The results get printed and no other checks happen 🦋

💜 OPTIONS 💜

• --x-rotate=angle — Spin it counter-clockwise (CCW) around the x-axis by angle degrees 🌀
• --y-rotate=angle — Spin it CCW around the y-axis by angle degrees 🌀
• --z-rotate=angle — Spin it CCW around the z-axis by angle degrees 🌀
• --xy-mirror — Mirror it across the xy plane 🪞
• --yz-mirror — Mirror it across the yz plane 🪞
• --xz-mirror — Mirror it across the xz plane 🪞
• --scale=factor — Scale the file by factor, which means multiply by factor 📐
• --translate=x,y,z — Translate (move) the file to x, y, and z 🚀
• --merge=name — Merge the file called name with your input file 🫂
• -e, --exact — Only check for perfectly matched edges 💅
• -n, --nearby — Find and connect nearby facets, and fix the bad ones 🔧
• -t, --tolerance=tol — Set the initial tolerance for the nearby check to tol 🎯
• -i, --iterations=i — Set the number of iterations for the nearby check to i 🔁
• -m, --increment=inc — How much to bump the tolerance by after each iteration, inc 📈
• -u, --remove-unconnected — Remove facets that have 0 neighbors 🗑️
• -f, --fill-holes — Add facets to fill holes 🕳️
• -d, --normal-directions — Check and fix the direction of the normals (i.e. cw, ccw) 🧭
• --reverse-all — Reverse the directions of all facets and normals 🔄
• -v, --normal-values — Check and fix the normal values 💯
• -c, --no-check — Don't run any checks on the input file 🙅
• -b, --write-binary-stl=name — Output a binary STL file called name 💾
• -a, --write-ascii-stl=name — Output an ascii STL file called name 📝
• --write-off=name — Output a Geomview OFF format file called name 🦄
• --write-dxf=name — Output a DXF format file called name 🌈
• --write-vrml=name — Output a VRML format file called name 🌐
• --help — Display this help and exit 🆘
• --version — Output version information and exit 🔖

The functions run in the same order as the options are listed here, so check this list if you want to know what happens when, say, --translate and --merge are used together 👀 The order you type options on the command line doesn't matter ✨

🧚 EXAMPLES 🧚

To do all the checks except nearby, you'd use this:

admesh --exact --remove-unconnected --fill-holes --normal-directions --normal-values sphere.stl

Actually, the exact check is required before remove-unconnected, and remove-unconnected is required before --fill-holes, so you can shorten it to the same result:

admesh --fill-holes --normal-directions --normal-values sphere.stl

You can get the same results with the short options too:

admesh -fudev sphere.stl

or

admesh -fdv sphere.stl

These all do the same thing:

admesh sphere.stl

admesh -fundev sphere.stl

admesh -f -u -n -d -e -v sphere.stl

The -fundev options are already implied by default, so you don't need to type them 💖 To drop one of the checks, just remove its letter from the "word" fundev 🫶

🌈 SEE ALSO 🌈

For more info about the options and output, read admesh-doc.txt. It's usually in the /usr/share/doc/admesh-x.xx dir 📚

🔥 COPYRIGHT 🔥

Copyright (C) 1995, 1996 Anthony D. Martin <amartin@engr.csulb.edu> 👑

This program is free software 🦋 You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or (at your option) any later version 💜

This program is distributed in the hope that it'll be useful, but WITHOUT ANY WARRANTY. That means no implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE 🙈 Check the GNU General Public License for more details ✨

You should have received a copy of the GNU General Public License along with this program. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 🫶

---

Bye bestie 💖 This page is from the User Commands set, dated 21/10/2013, and it's ADMESH(1) forever 🌸✨