PNG2FB(nged)

✨ PNG2FB (nged) ✨

okay bestie, welcome to the png2fb page from the BRL-CAD User Commands manual — this is literally the glow-up tool for your framebuffer 💅

---

🌸 NAME 🌸

png2fb — load a PNG image into the current display framebuffer 🖼️✨

---

🦋 SYNOPSIS 🦋

png2fb [-H -i -c -v -z -1] [-m lines] [-g screen_gamma]
       [-x file_xoff] [-y file_yoff] [-X scr_xoff] [-Y scr_yoff]
       [-S squarescrsize] [file.png]

---

💖 DESCRIPTION 💖

so the png2fb command reads a PNG (Portable Network Graphics) image file and slays it right into the framebuffer of your current display manager. it overlays the rendered image on top of the MGED display, which is giving main character energy fr fr 🎀

if you don't hand it a file.png, png2fb reads from standard input. no file, no problem, it'll just vibe with stdin 🫶

heads up bestie: this command requires the current display manager to have an associated framebuffer. if there's no framebuffer available, you get an error. no framebuffer, no slay. 😭

---

✨ Options ✨

• -H — use the framebuffer's hardware size for the display dimensions instead of the PNG image's size. hardware knows best, periodt.
• -i — invert the image (flips vertically when reading from a file). upside-down era 🙈
• -c — clear the framebuffer to black before displaying the image. fresh canvas, clean slate 💀
• -v — verbose mode: prints extra info while loading, so you can watch it cook 👀
• -z — zoom the image to fill the framebuffer. big picture energy 🔥
• -1 — use a single line at a time for I/O — slower, but uses less memory. lowkey frugal, highkey iconic 🧚
• -m lines — read lines lines at a time from the PNG file (default: vary). the default just does its own thing, iykyk.
• -g screen_gamma — apply the specified gamma correction value to the display. color-corrected queen 👑
• -x file_xoff — horizontal offset (in pixels) into the PNG file to start reading. skip to the good part.
• -y file_yoff — vertical offset (in pixels) into the PNG file to start reading.
• -X scr_xoff — horizontal offset on the framebuffer screen to begin writing.
• -Y scr_yoff — vertical offset on the framebuffer screen to begin writing.
• -S squarescrsize — set both the screen width and height to squarescrsize pixels. a perfect square, a perfect vibe 🍓

---

🌈 EXAMPLES 🌈

Example 1. Display a PNG image in the framebuffer

mged> png2fb render.png

loads render.png into the current display framebuffer. that's it, that's the whole moment ✨

Example 2. Clear framebuffer and display at an offset

mged> png2fb -c -X 100 -Y 50 overlay.png

clears the framebuffer first, then displays overlay.png starting at screen position (100, 50). chef's kiss placement 💅

---

🌟 SEE ALSO 🌟

• fbclear(nged)
• screengrab(nged)

---

💜 AUTHOR 💜

BRL-CAD Team 🫶

---

🎀 BUG REPORTS 🎀

reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — tell them everything, bestie, they wanna know 📧

---

not me wrapping up with the credits: this masterpiece comes to you from BRL-CAD, page PNG2FB(nged). mwah, stan, bye 💖✨🎀