GFX.LUA(8)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💖 NAME 💖

gfx.lua — bootloader graphics module. This is the GFX.LUA(8) page from the System Manager's Manual, bestie, and it's literally all about the bootloader graphics era 💅.

✨ DESCRIPTION ✨

okay so the built-in graphics-related Lua bindings for the FreeBSD boot loaders using the Lua interpreter? They're available via the gfx table. That's the whole vibe. 🫶

🌸 Exported Functions 🌸

The following functions are exported in the loader table. Yes, loader table — the page said what it said, iykyk.

  • fb_bezier(x0, y0, x1, y1, x2, y2, width) — Draw a bezier curve through the points (x0, y0), (x1, y1), and (x2, y2) of width width. The units are in pixels and have an origin of (0, 0). Art hour, no cap ✨
  • fb_drawrect(x0, y0, x1, y1, fill) — Fill in a rectangle with the pixel fill, with the corners (x0, y0) and (x1, y1). The units are in pixels and have an origin of (0, 0). Rectangle slay 🎀
  • fb_line(x0, y0, x1, y1, width) — Draw a line from (x0, y0) to (x1, y1) with a width of width. The units are in pixels and have an origin of (0, 0). Connect the dots, bestie 🌸
  • fb_putimage(name, x0, y0, x1, y1, f) — Load the PNG file name and place it in the rectangle with the corners (x0, y0) and (x1, y1) and fill with pixel f. The units are in pixels and have an origin of (0, 0). PNG main character energy 🖼️
  • fb_set_pixel(x, y) — Sets the pixel at (x, y). The units are in pixels and have an origin of (0, 0). One pixel, one moment ⭐
  • term_drawrect(x0, y0, x1, y1) — Draw the outline of a rectangle with the text coordinate corners of (x0, y0) and (x1, y1). The units are in character cells and have an origin of (1, 1). Terminal rectangle moment 🦋
  • term_putimage(name, x0, y0, x1, y1, f) — Load the PNG file name and place it in the rectangle with the text coordinate corners (x0, y0) and (x1, y1) and fill with pixel f. The units are in character cells and have an origin of (1, 1). Text-cell image realness 💖
🚨 Vibe check caveat: this table is optional and should only be used if it is non-nil and if core.isFramebufferConsole() is true. Do not skip the check, bestie — fr fr.

🦋 Compatibility 🦋

All the interfaces described above are also available via the loader table through at last FreeBSD 15.0. (Quoted exactly, no cap — that's the page's lore.) 🔥

🔥 SEE ALSO 🔥

👑 AUTHORS 👑

The gfx.lua man page was written by Warner Losh <imp@FreeBSD.org>. Big slay to Warner, iconic behavior 👑💅

📅 Source/version/date sign-off: Debian, GFX.LUA(8), March 29, 2025. Byeee, bestie 🎀💖

📦 where this page comes from