HOW(nged)

returns how an object is being displayed

📅 published 7.44.0, from nixpkgs unstable

💅 HOW(nged) — nged manual, bestie edition ✨

okay so this is how, one of the BRL-CAD User Commands, and honestly? it's giving "detective but make it a one-liner" 🕵️‍♀️💖

✨ NAME ✨

how — returns how an object is being displayed 👀

🎀 SYNOPSIS 🎀

how [-b] object

🦋 DESCRIPTION 🦋

So here's the vibe: the how command goes and queries the display list to figure out how the object you named is currently being drawn in the display. main character energy, fr fr 💅

It hands you back a numerical code that represents the object's current display mode — think wireframe, shaded, hidden-line, etc. 🌈 And if the object you asked about isn't currently displayed at all? Big sad, it returns -1 😭💀

Now, if you pass the -b ("both") flag, it gets extra and returns two space-separated values: the numerical display mode and the object's floating-point transparency value. two for the price of one, we love to see it 🫶

🌸 EXAMPLES 🌸

Example 1. Determine an object's display mode and transparency ⭐

mged> how -b my_region.r

Returns output similar to 2 0.5, indicating that my_region.r is drawn with display mode 2 and a transparency of 0.5 ✨ If the object was not displayed, it would return -1. no cap, that's the whole thing 🎀

👑 AUTHOR 👑

BRL-CAD Team 💜

🍓 BUG REPORTS 🍓

Reports of bugs or problems should be submitted via electronic mail to devs@brl-cad.org 📬 (bestie please actually report them, don't just suffer in silence 🙈)

reminder that -1 means "not displayed" — don't come for me, that's just what the manpage says 💀

and that's a wrap, bestie! 🧚 this little number comes to you straight from BRL-CAD, filed under HOW(nged) — go forth and query your display list with confidence 🔥💖

📦 where this page comes from