TESTVHACD(1)

💖 Welcome to the TestVHACD Page 💖

Okay bestie, this is the page for TestVHACD, which lives in the User Commands section 🎀 Let's get into it ✨

---

✨ NAME ✨

TestVHACD is the test and utility command-line tool for the V-HACD library 💅

---

🎀 SYNOPSIS 🎀

TestVHACD <wavefront.obj> (options)

So you feed it a wavefront .obj file, then toss in whatever options you want 🫶

---

🦋 DESCRIPTION 🦋

Okay so the V-HACD library takes a 3D surface and chops it up into a bunch of “near” convex parts. Main character energy, fr 💅

---

🌸 OPTIONS 🌸

• -h <n> — the max number of output convex hulls you're allowed to get. Defaults to 32 💖
• -r <voxelresolution> — the total number of voxels it's allowed to use. Default is 100,000 🧚
• -e <volumeErrorPercent> — how much volume error you're cool with, as a percentage. Default is 1%, and the valid range is 0.001 to 10 🔥
• -d <maxRecursionDepth> — how deep it's allowed to recurse. Default is 10 👑
• -s <true/false> — whether or not to shrinkwrap the output to the source mesh. Default is true 🌈
• -f <fillMode> — the fill mode. Default is ‘flood’, but ‘surface’ and ‘raycast’ are valid too ⭐
• -v <maxHullVertCount> — the max number of vertices in each output convex hull. Default is 64 🍓
• -a <true/false> — whether or not to run asynchronously. Default is ‘true’ 💜
• -l <minEdgeLength> — the minimum size of a voxel edge. Default is 2 voxels ✨
• -p <true/false> — if false, it splits hulls right in the middle. If true, it tries to find the optimal split plane location. It's false by default 🦋
• -o <obj/stl/usda> — exports the convex hulls as a series of wavefront OBJ files, STL files, or one single USDA 🫶
• -g <true/false> — if set to false, no logging gets displayed 🙈

---

🌈 TUNING PARAMETERS 🌈

The defaults are chill and designed to give a fast, basic approximation of a shape 💅

If you want the most accurate results possible and don't care if it takes way longer, go hard. Use a small error threshold -e 0.01, a high voxel resolution of ten million -r 10000000, and a relatively high number of convex hulls, say 128 -h 128 🔥

You can also set the maximum decomposition depth way higher than the default of 10. Setting it to say 15 -d 15 lets the algorithm recurse much more deeply into the shape 🧚

Example:

TestVHACD beshon.obj -e 0.01 -d 15 -r 10000000 -r 128

Usually this is overkill for your use case, ngl. But if you've got, like, machined parts with sharp angles, these settings have a better chance of giving you a good result 💖

Heads up: setting the maximum decomposition depth to 15 will make the tool run a very long time (possibly multiple minutes), but it will likely give the most precise results. Be patient, bestie 💀

The default decomposition depth is currently ten, and it goes in powers of two. So the default considers a maximum of 1,024 hulls, but with a depth of 15 it'll consider 32,768 convex hull fragments 👑

---

That's the whole page, bestie! 🦋 This one's dated February 2023 and it's the TESTVHACD(1) page, so you're all set 🫶💖