STATUS(nged)

💅 STATUS(nged) — the vibe check command

okay bestie, welcome to status from BRL-CAD User Commands — this is literally the command that tells you where you are, what you're looking at, and how your units are converting. it's giving "siri, but for your 3D model" 🎀

---

✨ NAME ✨

status — with no subcommand, it hands you the following info: the current state, the view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager. 🫶

---

🌸 SYNOPSIS 🌸

status [subcommands]

---

🦋 DESCRIPTION 🦋

so like, no cap: without a subcommand, status returns the current state, the view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager. all of that. in one go. iconic. 👑

and status accepts the following subcommands, each one a little main character in its own right:

• state — gets the current state of MGED. like, VIEWING, SOL PICK, SOL EDIT, OBJ PICK, OBJ PATH, OBJ EDIT, or VERTPICK. yep, those are the moods. 🎭
• Viewscale — gets the view scale.
• base2local — gets the conversion factor from base units (mm) to local units.
• local2base — gets the conversion factor from local units to base units (mm). (yes it's the reverse of the one above, they're siblings, don't make it weird 💜)
• toViewcenter — gets the matrix that describes the location of the view center.
• Viewrot — gets the matrix that describes the view orientation.
• model2view — gets the model to view conversion matrix.
• view2model — gets the view to model conversion matrix.
• model2objview — gets the model to view conversion matrix. this one also includes changes made during editing. highkey extra, lowkey necessary. 🔥
• objview2model — gets the view to model conversion matrix. and yeah, this one also includes changes made during editing.
• help — prints the usage message. the "bestie, here's how this works" of subcommands. 🙈

---

🎀 EXAMPLES 🎀

three examples, showing status with and without subcommands. slay.

⭐ Example 1

get default info — current state, view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager.

mged>status

this gets the default information (i.e., state, view size, local2base, toViewcenter, Viewrot, model2view and view2model). the whole bundle. 💖

⭐ Example 2

get the view rotation matrix.

mged>status Viewrot

gets the view rotation matrix. simple. clean. done. ✨

⭐ Example 3

get the edit state.

mged>status state

gets the edit state. periodt. 💅

---

🌈 AUTHOR 🌈

BRL-CAD Team — the ones who made all this possible, we stan. 👑

---

🍓 BUG REPORTS 🍓

found a bug? a problem? something acting sus? 😭 reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. they literally want to hear it, fr fr. 🧚

---

ngl, that's the whole page — no hidden lore, no skips, every flag accounted for. you're so welcome bestie 🫶

and that's a wrap, babe: BRL-CAD shipped this one under STATUS(nged), no date drama attached, and the source/version line is just BRL-CAD being BRL-CAD. go forth and status responsibly 🌸💜