BINVOX2BT(1)

💖 BINVOX2BT(1) 💖

okay bestie, gather round, because today we're talking about binvox2bt — and yes she lives in the General Commands Manual section, she's a whole user command, and she is so much cooler than her name suggests. no cap.

✨ NAME ✨

binvox2bt — convert 3D mesh voxelizer meshes to a single bonsai tree file 🌸

like. that's it. that's the job. she takes your voxel mesh situation and turns it into one (1) bonsai tree file. iconic behavior.

🦋 SYNOPSIS 🦋

binvox2bt [ options <binvox filenames> ...]

options go in, binvox filenames go in, magic comes out. the brackets are doing a lot of heavy lifting here and honestly same.

🌈 DESCRIPTION 🌈

okay so here's the tea ☕ — binvox2bt reads files generated by Patrick Min's 3D mesh voxelizer (it's called "binvox", and you can find it at: http://www.cs.princeton.edu/~min/binvox/) and converts the voxel meshes into a single bonsai tree file. one file. one tree. that's the dream, fr fr. 🌳

and bestie, credit where credit is due: this file is based on code from http://www.cs.princeton.edu/~min/binvox/read_binvox.cc 💜

now, the options. there are several. let's get into it:

💅 OPTIONS 💅

• -o <file> — the output filename, bestie. and if you don't say anything? the default is the first input filename + -.bt. so like, she'll name it for you. she's thoughtful like that. ✨
• --mark-free — marks the cells that are not occupied as 'free'. the default here is unknown, jsyk. so if you want them labeled, say the word. 🎀
• --rotate — rotates left by 90 deg. to fix the coordinate. your coordinates were giving crooked, and now they're giving aligned. slay. 🔄
• --system — for when it's exported from Webots. that's the vibe check, iykyk.
• --bb <minx> <miny> <minz> <maxx> <maxy> <maxz> — forces a bounding box for the OcTree. yes, that's six whole numbers. minx, miny, minz, maxx, maxy, maxz. count them. she needs all six, no skipping. 📦
• --offset <x> <y> <z> — adds an offset to the final coordinates. just a little nudge. a scoot. a repositioning moment. 🫶

and here's the part that actually matters, so listen up:

if more than one binvox file is given, the models are composed to a single bonsai tree. multiple files in, one tree out. that's the whole point and it's lowkey beautiful. 😭💖

also, super important: all options apply to the subsequent input files. like, they're not global-forever settings, they kick in from where you put them and affect what comes after. so if you're mixing files and mixing flags, order is doing the heavy lifting. don't get caught slipping. 💀

👑 that's the whole page, bestie 👑

she came from the User Commands section, her name is BINVOX2BT(1), and she's here to turn your voxel meshes into one gorgeous little bonsai tree file. no date on this one, just vibes and a manual page. go forth and convert, you absolute main character. 🌟💜