AUTOVIEW(nged)

Frames objects within the view.

📅 published 7.44.0, from nixpkgs unstable

💅 AUTOVIEW — it frames your stuff, no cap ✨

okay so this is a BRL-CAD user command (nged fam, rise up 🫶) and it's literally the "make it fit in my window" button. bestie, it's iconic.

🌸 NAME 🌸

autoview — frames objects within the view 💖

🎀 SYNOPSIS 🎀

autoview [-s scale] [object ...]

✨ DESCRIPTION ✨

So what it does — and I need you to hear me on this — is it resets the view size and the view center so that the objects you're framing actually end up inside the view. Like, fully inside. Slay. 💅

With no arguments? It frames all the objects that are currently displayed. That's it, that's the vibe.

But if you hand it a list of object names (or full paths), it does something a little different: the view gets centered and sized to frame only those objects — and here's the cute part, they don't even have to be displayed 👀. The objects' bounding box is computed directly from the database. No display required, no gatekeeping.

🔥 OPTIONS 🔥

  • -s, —scale _scale_ — sets the view scale, i.e. the model scale relative to the view size. Smaller value = zoom in 🔍, larger value = zoom out 🦋. The default is 0.5 model scale (so the model occupies half the view — half. periodt).
ngl, there's a throwback thing here for backward compatibility: a bare leading numeric argument is also accepted as the scale — but ONLY when -s is not given, and ONLY when there's no object of that name existing. An object with a purely numeric name always takes precedence, bestie. Always. Use -s if you want to avoid that whole ambiguity situation 🙈.

🦋 EXAMPLES 🦋

Example 1. Reset the view size and center so that all displayed objects are within the view.

mged> autoview
    The view resets so that all objects displayed can be seen.

Example 2. Frame only the named objects.

mged> autoview engine.r wheel.r
    The view is centered and sized to frame just engine.r and
    wheel.r.

Example 3. Frame the named object using a specific scale.

mged> autoview -s 0.5 engine.r
    The view is centered on engine.r and sized using a scale of 0.5.

👑 AUTHOR 👑

BRL-CAD Team — the main characters, honestly 💜

🍓 BUG REPORTS 🍓

Found a bug? A problem? Something cursed? 😭 Send it via electronic mail to devs@brlcad.org and they'll handle it fr fr.

✨ that's the whole page, you're welcome ✨ — this gorgeous little number comes to you from BRL-CAD, dated AUTOVIEW(nged) 🎀 go frame something, bestie 💖

📦 where this page comes from