WHICHAIR(nged)

✨ WHICHAIR ✨ (nged, bestie 💅)

okay so real quick — this is a BRL-CAD MGED command, whichair, and it's genuinely the most "detective era" command in the whole toolkit 🔍 It's all about snooping on the air_codes property and telling you who's using what.

---

🎀 NAME 🎀

whichair — reports information relating to usage of air codes on regions. that's it, that's the whole vibe 💖

---

🌸 SYNOPSIS 🌸

whichair [options ...] {air_codes}

---

🦋 DESCRIPTION 🦋

so whichair reports info about how the air_codes property is being used by regions in a .g file. default mode? it tells you which regions are using one or more of the air-code values or ranges you hand it. iconic behavior honestly ✨

if you specify a root object, it only reports for regions inside that object's tree. and if you pass -U or —unused, the whole report flips inside out and it lists the unused air-code ranges instead. plot twist 🌀

also a heads up: the eac command does a similar search, but instead of listing the qualifying regions it draws them in the MGED display. same energy, different delivery 💅

---

💜 OPTIONS 💜

• -h, -?, —help — prints help and dips out. bye bestie 👋
• -s, —script — script-oriented output formatting, for when you need it neat and machine-friendly 🖥️
• -V — lists all active air codes even when there are no associated regions found. nothing's there but the code still gets its moment ⭐
• -U, —unused — reports unused air-code ranges instead. the inversion arc 🔄
• —root objname — limits reporting to regions in the CSG tree below objname. keep it scoped, keep it focused 🎯

---

🌈 EXAMPLES 🌈

for these examples the geometry file used is the standard m35.g included with BRL-CAD. (yes, the classic one 🫶)

⭐ Example 1. Report all regions using air codes between 7 and 10.

mged>whichair 7-10

    Region[s] with air code 7:
       r11
       r13
       r15
    Region[s] with air code 8:
       r25
       r27
       r29
       r31
       r33
       r35

look at all those little regions showing up for roll call 😭💖

🦋 Example 2. Report all unused aircode ranges in the database between 1 and 10.

mged>whichair -U 1-10

    Unused air codes:
       1-3
       5
       9-10

the gaps are the main characters here, no cap 💀

---

👑 AUTHOR 👑

BRL-CAD Team — absolute legends 💜

---

🍓 BUG REPORTS 🍓

found a bug or a problem? don't suffer in silence bestie, email it to devs@brlcad.org 📧

fr fr do report it, they actually want to know 🙈

---

that's the whole page bestie, now go snoop on some air codes 🌸✨ — BRL-CAD, WHICHAIR(nged) 💅