mia-3disos...-from-stack(1)

💖 mia-3disosurface-from-stack(1) 💖

okay bestie, sit DOWN, because we're about to pull a whole iso-surface out of your 3D image and it's gonna be gorgeous 🦋

This page lives in the General Commands Manual, section 1 — so it's a user command, the kind you just type, no shame, no sudo drama (well, depending on where you're writing that mesh, but that's a you problem 💅).

---

✨ NAME ✨

mia-3disosurface-from-stack — extract an ist-surface from a 3D image. (yes, that's "ist-surface", that's what it says, I'm not fixing it, I'm just reporting it fr fr 😌)

---

🌸 SYNOPSIS 🌸

mia-3disosurface-from-stack -i <in-image> -o <out-mesh> [options]

like, the two required things go up front, and then [options] is your little playground 🎀

---

👑 DESCRIPTION 👑

So mia-3disosurface-from-stack is the program you use to extract an iso-surface from the input gray scale image — and the tea is, that image is given as slices. Slices in, surface out. That's the whole vibe. ✨

---

💅 OPTIONS 💅

📁 File-IO

• -i --in-image=(input, required); string — the input image filename pattern. It's required, bestie, no skipping it 🙈
• -o --out-mesh=(output, required); string — the output mesh. Also required. You literally cannot do this without it 💀

🫶 Help & Info

• -V --verbose=warning — verbosity of output: it prints messages of the given level and higher priorities. The supported priorities, starting at the lowest level, are:
  • trace — Function call trace
  • debug — Debug output
  • info — Low level messages
  • message — Normal messages
  • warning — Warnings
  • fail — Report test failures
  • error — Report errors
  • fatal — Report only fatal errors
• --copyright — print copyright information 📜
• -h --help — print this help
• -? --usage — print a short help
• --version — print the version number and exit ✌️

🖼️ Image options

• -s --iso-value=128 — iso-value of the iso surface to be extracted. Defaults to 128. 🌈

🕸️ Mesh options

• -f --max-faces=-1 — maximum number of Faces, (default -1, which is the "no cap" setting 🧢)
• -e --max-edges=-1 — maximum number of Edges. Also defaults to -1.
• -c --max-cost=0.1 — maximum cost for edge collaps. Default 0.1.
• -r --ratio=4 — ratio of faces(edges) to target number, at which the optimization changes from edge-length to volume-optimized. Default 4.
• -w --reverse-winding — reverse the winding of the triangles in order to make normals point away from the high intensity area 🔄

⚙️ Processing

• --threads=-1 — Maxiumum number of threads to use for processing. This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation). So if you leave it at -1, it just guesses, and honestly, same 🔥

---

🍓 EXAMPLE 🍓

Extract the surface from an image set with numbers imageXXXX.png that corresponds to the value 30 and stop optimizing when the mesh consists of less than 100000 triangles.

mia-3disosurface-from-stack -i image0000.png -o mesh.vmesh -s 30 -f 100000

see how it all clicks together?? iconic 💜

---

🌟 AUTHOR(s) 🌟

Gert Wollny — the main character who wrote this 🫡

---

📜 COPYRIGHT 📜

This software is Copyright (c) 1999‐2015 Leipzig, Germany and Madrid, Spain. It comes with ABSOLUTELY NO WARRANTY (emphasis theirs, and honestly, valid 😭) and you may redistribute it under the terms of the GNU GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the option --copyright.

no cap on that no-warranty thing, bestie — it's in all caps for a reason. read your licenses, they're giving main character energy too.

---

and that's the whole page!! 💖 this was mia-3disos...-from-stack(1), page 1 of the USER COMMANDS manual, at version v2.4.7. go forth and mesh, you absolute legend 👑🌸