BOT_SPLIT(nged)

Split a single BOT primitive, containing disjoint groups of facets, into multiple BOT primitives, one BOT per disjoint group.

📅 published 7.44.0, from nixpkgs unstable

💅 BOT_SPLIT (nged) — the glow-up 💅

okay bestie, welcome to bot_split, a lil' BRL-CAD nged command that is genuinely so useful when your model is being a mess. ✨

🎀 NAME 🎀

bot_split — splits one single BOT primitive that's secretly holding a bunch of disjoint groups of facets into multiple BOT primitives, with one BOT per disjoint group. no cap, that's the whole vibe. 💖

🦋 SYNOPSIS 🦋

bot_split {bot} [bot2 bot3]...

🌸 DESCRIPTION 🌸

So here's the tea. ☕ You've got one BOT primitive, right? But inside it there are multiple disjoint groups of facets just chilling together like they're one thing. bot_split takes that single BOT and splits it into multiple BOT primitives, one BOT per disjoint group. That's it. That's the whole slay. 💅

Picture this: your model has a single BOT with separate geometry for each of four tires 🛞🛞🛞🛞, and you need each tire split out into its own separate BOT. That is literally the moment bot_split was made for — you'd just use bot_split.

⚠️ but listen — this only works if each tire doesn't share edges or vertices with any of the other tires. i.e. they gotta be disjoint. if they're fused together, this is not the move, bestie. 😭

The resulting BOTs keep the same name as the original BOT, except a sequential number gets appended to the name of each new BOT. iconic behavior honestly. 👑

And when bot_split finishes, it will list the names of the new BOTs for you — so you're never left guessing which one is which. 🫶

Also, little pro-tip straight from the manpage (not me making things up, fr fr): it's recommended to run bot_vertex_fuse and then bot_face_fuse before running bot_split. order matters, don't skip it. ⭐

🧚 EXAMPLES 🧚

💜 Example 1. Split one disjoint BoT into separate named pieces.

mged>bot_split tires.bot

This breaks tires.bot into one BoT per disconnected facet island 🌈 — which is so handy when your imported mesh data has several logically separate parts crammed into a single primitive. it's giving "one primitive, many problems" and bot_split is the fix. 🔥

👑 AUTHOR 👑

BRL-CAD Team — absolute main characters. 💖

🙈 BUG REPORTS 🙈

Found a bug? a problem? something cursed? 😭 Report bugs or problems by sending electronic mail to devs@brlcad.org — they wanna know, bestie, fr fr. 📧

okay that's the whole page, and for the cute sign-off: this beauty comes from BRL-CAD, filed under the BOT_SPLIT(nged) page in the manual — the footer doesn't list a date on this one, so no fabricated timestamp from me, just pure BRL-CAD energy. mwah 💋✨🎀

📦 where this page comes from