FB2PIX(nged)

💖 FB2PIX 💖

okay so this is the fb2pix page from the BRL-CAD User Commands manual, and honestly? she's a little icon. buckle up bestie 🎀

---

✨ NAME ✨

fb2pix — literally just writes your framebuffer image out to a .pix file 💅

---

🌸 SYNOPSIS 🌸

fb2pix [-h -i -c] [-s squaresize] [-w width] [-n height] [file.pix]

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: fb2pix grabs the current framebuffer image straight from the display manager and writes it out as a raw .pix (RGB) file. that's it, that's the whole job, and she does it flawlessly 💜

and like — plot twist — if you don't hand her an output file and standard output isn't a terminal, the image data just goes to standard output instead. no file? no problem. 🫶

the available options are:

• -c — crunch the colormap (aka apply the colormap to the pixel values). lowkey a glow-up for your pixels ✨
• -i — inverse mapping, which draws the image upside down. yes she will flip your whole world, no cap 🙃
• -s squaresize — sets both the output width and height to the squaresize you give her. one number, two dimensions, efficiency queen 👑
• -w width — sets the output width only
• -n height — sets the output height only
• -h or -? — prints the command usage and dips. short & sweet 💀

ngl if you omit the size parameters entirely, she defaults to capturing a 512x512 region. that's the fallback and it's serving 🎀

---

🌈 EXAMPLES 🌈

⭐ Example 1. Save the framebuffer to a PIX file ⭐

mged> fb2pix -s 1024 output.pix

so what's happening here? she captures a 1024x1024 region of the active framebuffer and saves it to output.pix. iconic behavior, no notes 💖

---

🧚 AUTHOR 🧚

BRL-CAD Team 🫶

---

🍓 BUG REPORTS 🍓

found a bug or a problem? don't suffer in silence bestie — reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org 📧

---

and that's the whole page, fr fr 💜 big thank you to the source, BRL-CAD, and to FB2PIX(nged) herself — main character energy, periodt ✨🎀🦋