TOPS(nged)

💅 TOPS (nged) — bestie's guide to listing ur top-level objects

okay so real talk: this is the tops command from the nged manual, straight out of the BRL-CAD family, and it's genuinely one of the most useful little commands in the whole toolset. it shows you everything chillin' at the top of ur model hierarchy. let's go ✨

---

🌸 NAME

tops — displays a list of all the top-level objects in the current database. that's it, that's the vibe 🫶

---

🦋 SYNOPSIS

tops [-a] [-h] [-n] [-p]

---

💖 DESCRIPTION

So tops displays the top-level objects in the current database — and in case ur wondering what "top-level" even means: they're the objects that are not referenced by any other combination. Like, nobody's holding them. They're the main characters 👑.

In most BRL-CAD databases, this usually includes one or more assembly objects near the root of the model hierarchy. makes sense, right?

By default, tops lists only non-hidden top-level database objects. The output is sorted alphabetically and formatted in columns — clean, tidy, iconic. And the decorations, bestie, the decorations 💅:

• Combination names get a trailing /
• Region names get a trailing R

so region combinations typically appear with /R. iykyk.

The following options are supported:

• -a — List all top-level objects, including hidden objects and phony directory entries. it overrides everything, no cap.
• -h — List only hidden top-level objects.
• -n — Suppress the default / and R output decorations. plain names only, minimalism slay.
• -p — List only phony top-level directory entries.

ngl the filter combo is lowkey the best part: the -h and -p filters may be combined to include both hidden and phony top-level entries. but if -a is specified, it overrides those filters and reports all top-level entries. periodt 🔥

---

🎀 EXAMPLES

These examples show the use of the tops command to list top-level objects in the current database.

✨ Example 1. List all the top-level objects in the current database.

mged>tops

Lists non-hidden top-level database objects. Combination and region entries are decorated in the output. cute, decorated, on brand 🌸

✨ Example 2. List all top-level objects, including hidden and phony entries.

mged>tops -a

Lists all top-level objects, including hidden objects and phony directory entries. the whole roster, no secrets 💀

✨ Example 3. List only hidden top-level objects.

mged>tops -h

Lists only top-level objects that have been marked hidden. the shy ones 🙈

✨ Example 4. List only phony top-level directory entries.

mged>tops -p

Lists only top-level phony directory entries.

✨ Example 5. List top-level object names without combination or region suffixes.

mged>tops -n

Lists top-level objects without the default / and R decorations. raw names, no filter 💅

---

🫶 AUTHOR

The BRL-CAD Team. legends, honestly. ate and left no crumbs 👑

---

😭 BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. please do, they wanna know, fr fr 🐛💌

---

ngl, quick reminder bestie: -a overrides -h and -p if you pass them together. don't be shocked when u get everything back. that's not a bug, that's the documented behavior 💖

---

✨ and that's the page! ✨ this was TOPS(nged) from BRL-CAD, and it's serving main character energy in the BRL-CAD MGED Commands section. go forth and list ur tops, bestie 🦋🎀💜