WHICHID(nged)

💖 whichid: the region_id gossip page 💖

okay bestie, welcome to WHICHID(nged) — yes, that's the manual page name — sitting in the BRL-CAD MGED Commands section. This is the command that spills the tea on how regions are using the region_id property.

---

✨ NAME ✨

whichid — reports information relating to usage of the region_id property on regions. it's giving “id detective” energy 🔍💅

---

🎀 SYNOPSIS 🎀

whichid [options ...] {ident[-ident]}...

---

🌸 DESCRIPTION 🌸

whichid reports info about how regions in a .g file are using the region_id property. Its default mode is to report which regions in a .g file are using one region_id value or a range of region_id values.

If a root object is specified, it reports that result only for the regions in the tree of the root object. if you want the result scoped to a specific corner of the CSG tree, that's the move.

If U is specified, the reporting is inverted: the command reports the ranges of unused ids instead of the regions using various ids. literally the opposite vibe — unused-id reveal instead of region roll call 🫶

---

💅 OPTIONS 💅

• -h, -?, —help — print help and exit. very considerate, no notes.
• -s, —script — use script-oriented output formatting. for when the output needs to behave for scripts and not just look cute in the terminal.
• -V — list all active ids even when no associated regions are found. yes, even the lonely ids get listed.
• -U, —unused — report unused id ranges. this is the inverse-mode option.
• —root objname — limit reporting to regions in the CSG tree below objname. scope it, bestie.

---

🎀 EXAMPLES 🎀

For these examples, the geometry file used is the standard ktank.g included with BRL-CAD. iconic file, no cap.

Example 1. Report all regions using region ids between 4000 and 7000.

mged>whichid 4000-7000

    Region[s] with ident 4001:
       r23
       r25
    Region[s] with ident 4050:
       r24
       r26
    Region[s] with ident 6001:
       r210
    Region[s] with ident 6002:
       r212

Example 2. Report all regions using region ids between 1000-2000 and 4000-5000.

mged>whichid 1000-2000 4000-5000

    Region[s] with ident 1010:
       r213
    Region[s] with ident 1011:
       r214
    Region[s] with ident 4001:
       r23
       r25
    Region[s] with ident 4050:
       r24
       r26

Example 3. Report all regions using region ids between 1000-2000 and 4000-5000, limiting results to regions in the tank geometry tree.

mged>whichid —root tank 1000-2000 4000-5000

    Region[s] with ident 4001:
       r23
       r25
    Region[s] with ident 4050:
       r24
       r26

Example 4. Report all unused region_id ranges in the database between 1 and 1000.

mged>whichid -U 1-1000

    Unused idents:
       1
       4
       6-99
       105-109
       112-114
       116-119
       122-159
       161-164
       166-204
       210-224
       226-504
       519-609
       620-719
       730-829
       840-939
       950-1000

---

👑 AUTHOR 👑

BRL-CAD Team — the icons behind the whole thing 💖

---

🐛 BUG REPORTS 🐛

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. if something is acting up, tell the BRL-CAD Team directly — no vague-posting, bestie 📬

---

okay that's the whole page. footer sign-off: source/version BRL-CAD, page tag WHICHID(nged), and no date is printed in this footer — so we are absolutely not inventing one. periodt. 🫶💅✨