SELECT(nged)

Returns displayed items or BOT vertices within a specified screen-space region.

📅 published 7.44.0, from nixpkgs unstable

💅 SELECT(nged)

okay so bestie, welcome to select — it's a BRL-CAD User Command and it's literally the "what's under my cursor rn" tool. It hands back the displayed items or BOT vertices that live inside a screen-space region you define. slay ✨

🌸 SYNOPSIS 🌸

select [-b bot] [-p] [-z vminz] vx vy {vr | vw vh}

yeah it's a lot of brackets, don't panic, we're getting to all of them 🫶

💖 DESCRIPTION 💖

select returns the displayed items within a specified selection area. That area is either:

  • a circle — center vx vy, radius vr
  • a rectangle — origin vx vy, width/height vw vh

like, pick a shape, pick a spot, done. 🎀

The implementation supports the following options:

  • -b bot — return BOT vertex indices from the specified BOT instead of displayed object paths. so instead of "here's what you clicked on," you get the actual vertices of that BOT. icon behavior ngl 👑
  • -p — use partial-overlap selection instead of requiring full containment. translation: a thing that only kinda pokes into your selection box counts now, instead of having to be 100% inside it. generous queen 💅
  • -z vminz — ignore candidates with view-space Z values below vminz. basically a depth cutoff, anything too far back gets ✂️ from the results.
heads up bestie, those three flags are exactly what the implementation supports — nothing more, nothing less. no inventing extra flags, that's not the vibe. 🙈

🦋 EXAMPLES 🦋

this example is a circular selection, and it eats:

⭐ Example 1. Select displayed items around a screen-space point.

mged>select 0.1 0.2 0.05

Returns the displayed items inside the specified circular selection region. 0.1 0.2 is your center, 0.05 is the radius, and the result is everything chillin' in that little circle. no cap, that's it. 🔥

💜 AUTHOR 💜

BRL-CAD Team — the main characters who wrote this 🫡

🍓 BUG REPORTS 🍓

if you find a bug or a problem, fr fr don't suffer in silence — send electronic mail to:

devs@brlcad.org

they genuinely want to know. report it, bestie 🧚

and that's the whole page!! footer was just BRL-CAD and the page name SELECT(nged), no date on this one, so like… consider this your cute lil sign-off. mwah 💋 go select something iconic 💖✨🎀🦋

📦 where this page comes from