SCREENGRAB(nged)

Save the current MGED display visual or framebuffer contents to an image file.

📅 published 7.44.0, from nixpkgs unstable

💖 SCREENGRAB 💖

okay so bestie, welcome to the nged manual page for screengrab (part of the BRL-CAD User Commands, in case you were wondering where you wandered in from 🦋). she's a little glamour shot tool for your MGED display and honestly? iconic.

✨ NAME ✨

screengrab, screen_grab — literally just save whatever's on your MGED display, the visual or the framebuffer contents, straight to an image file. no cap. 📸

🎀 SYNOPSIS 🎀

screengrab [-F] [-D name] [--format fmt] image_file

💅 DESCRIPTION 💅

so the way this works: screengrab generates an image file containing the current display manager's rendered scene. that's the default vibe, main character energy, no flags needed 👑

and then, if you pass -F, she captures the embedded framebuffer instead. different girl, different energy. 🫶

image_file is required — like, actually required, not optional-required. the output format gets inferred from the file extension, and you can use —format to override that if the extension is giving nothing. 🙈

also: this command is also available as screen_grab (with an underscore). both names invoke identical behavior. same girl, two nicknames. periodt. 💜

🌸 Options 🌸

  • -F, —fb — captures the embedded framebuffer instead of the display manager scene. classic swap. 🔥
  • -D name, —dm name — specify the name of the display manager to capture. if you omit it, the active display manager is used, which is usually what you want ngl.
  • —format fmt — force the output image format (like png, jpg). if you don't specify it, the format is inferred from the file extension. you're the boss 💅
  • -h — prints usage help. the "help me help you" flag 🎀

⭐ EXAMPLES ⭐

Example 1. Write a PNG image file of the MGED framebuffer contents.

mged> screengrab -F fb.png

writes the contents of the active MGED framebuffer to the image file fb.png. chef's kiss. 🍓

Example 2. Capture a specific named display manager

mged> screengrab -D Mged0 output.png

captures the display manager named Mged0 to output.png. call her by name, she'll come. 💖

Example 3. Capture the scene display (default, no flags needed)

mged> screengrab scene.png

writes the current display manager's rendered scene to scene.png. zero flags, maximum slay. ✨

Example 4. Force JPEG format regardless of extension

mged> screengrab —format jpg view.img

writes the display manager scene to view.img in JPEG format. yes, the extension is lying, and yes, we're overriding her. 🦋

lowkey a warning-adjacent note: the extension is only a suggestion — if you want the format locked in, say it with —format. iykyk.

👑 AUTHOR 👑

BRL-CAD Team

🌈 BUG REPORTS 🌈

reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — pls be nice, they're doing their best 😭

okay that's the whole page, bestie!! 💜 you just read SCREENGRAB(nged) from the BRL-CAD User Commands — go forth and screenshot the absolute heck out of your scene. mwah 🫶🎀✨

📦 where this page comes from