VIEW_FUNC(nged)

💖 VIEW_FUNC (nged) 💖

okay so first things first: this whole page lives in the nged manual, bestie — that's the manual name, that's the vibe. it's a BRL-CAD User Command and it's lowkey a ✨legacy icon✨.

🌸 NAME 🌸

view_func — the legacy view control multiplexer. yep. a multiplexer. she's a switchboard, she's the main character, she routes stuff. 💅

🎀 SYNOPSIS 🎀

view_func subcommand [args]

🦋 DESCRIPTION 🦋

okay so picture this: view_func is a legacy multiplexer that gives you access to a whole bunch of view control operations through one single entry point. like one door, many rooms. she dispatches to separate view commands based on subcommand. 🫶

here's the tea on how she does it:

• in modern environments, view_func delegates entirely to the view command
• in compatibility mode, she dispatches using a built-in dispatch table

like, why does this exist? bc of backward compatibility with older MGED scripts. that's literally the whole reason. 🕰️ so if you're writing new scripts, pls pls pls use the individual commands directly, or the view command. do it for me. do it for yourself. 💖

⭐ Subcommands ⭐

here's the dispatch table bestie, every single row, no skips, no cap:

• ae or aet — delegates to aet: get or set the azimuth, elevation, and twist angles.
• align — delegates to align: align the view to a surface normal.
• auto or autoview — delegates to autoview: automatically fit all displayed objects in the view.
• center — delegates to center: get or set the view center point.
• data_lines or sdata_lines — delegates to data_lines/sdata_lines: manage supplementary data lines drawn in the view.
• eye — delegates to eye: get or set the eye (camera) position.
• faceplate — delegates to faceplate: manage faceplate display elements.
• knob — delegates to knob: simulate dial-box knob input for view adjustments.
• lookat — delegates to lookat: orient the view to look at a specified point.
• obj — delegates to the legacy view object handler.
• print — delegates to print: print a formatted summary of the current view state.
• quat — delegates to quat: get or set the view orientation as a quaternion.
• qvrot or dir — delegates to viewdir (get direction) or qvrot (set rotation via quaternion and angle), depending on argument count.
• save or saveview — delegates to saveview: save the current view to a file.
• size — delegates to size: get or set the view size.
• snap — delegates to the view snap handler.
• ypr — delegates to ypr: get or set the view orientation as yaw, pitch, and roll angles.

---

🔥 EXAMPLES 🔥

Example 1. Set the azimuth/elevation via view_func

mged> view_func ae 35 25

sets the view to azimuth 35°, elevation 25° — equivalent to aet 35 25. slay. 🎯

Example 2. Get the current view center

mged> view_func center

returns the current view center coordinates — equivalent to center. look at her go. 👑

---

🌈 SEE ALSO 🌈

view(nged), aet(nged), center(nged), eye(nged), quat(nged), size(nged), saveview(nged), ypr(nged)

go read those too, i'm begging. iykyk. 📚💜

👑 AUTHOR 👑

BRL-CAD Team — icons only.

💀 BUG REPORTS 💀

found a bug? a problem? something giving unwell energy? reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. pls be nice, they're trying. 🙈

---

ngl bestie, if you're writing fresh scripts, skip the multiplexer and go straight to the individual commands or view. she's legacy for a reason. 💅

kisses, and remember: this page came to you courtesy of BRL-CAD and it's the VIEW_FUNC(nged) page — go forth and control those views. 🎀✨