FBCLEAR(1)

📦
version 7.44.0 · 2 versions
, in nixpkgs unstable

💅 FBCLEAR — bestie edition ✨

okay so real talk, this is fbclear from the BRL-CAD manual, section 1. she clears frame buffers. she's iconic. let's get into it 🎀

✨ NAME ✨

fbclear — clears a frame buffer to a color. that's it. that's the whole vibe check. 🌈

🦋 SYNOPSIS 🦋

fbclear [-c] [-F framebuffer] [-{sS} squaresize] [-{wW} width] [-{nN} height] [gray | r g b]

like… yes she's got a lot of flags. she's highkey versatile. periodt. 💅

💖 DESCRIPTION 💖

so fbclear erases a frame buffer using whatever method is efficient for the device being accessed — she's not gonna do extra work for no reason, she's got main character energy but she's also efficient about it, yk? no color arguments? it clears to black. done. 🖤

one single gray value (0 to 255) gets written into all three channels. or, if you're feeling fancy, three values (r g b) set each channel independently. ate. 🔥

which frame buffer are we clearing, you ask? bestie, that's chosen by the -F option, or by the FB_FILE environment variable, or otherwise it falls back to the default device for your system (see brlcad(1)). iykyk.

unless -c is given, fbclear leaves any colormap and zoom/pan settings untouched — and it'll print a note if a non-linear colormap or a non-unity zoom is in effect. she's polite like that, she tells you when something's up 🫶

🎀 OPTIONS 🎀

  • -c — also reset the colormap to linear, and reset the pan and zoom to their default (centered, un-zoomed) values. basically the full factory reset bestie ✨
  • -F framebuffer — use the specified framebuffer device, overriding the FB_FILE environment variable. she listens to you over the environment, queen 👑
  • -s squaresize, -S squaresize — set both the width and height of the frame buffer to squaresize pixels. square. balanced. symmetrical. we love her 🌸
  • -w width, -W width — set the width of the frame buffer to width pixels. just the width. not the height. don't get it twisted 💀
  • -n height, -N height — set the height of the frame buffer to height pixels. the other half of the equation, fr fr 🦋
lowercase and uppercase versions of -s, -w and -n are listed as paired flags in the synopsis — they're written exactly as -{sS} squaresize, -{wW} width and -{nN} height, so keep them as-is, bestie 💜

🌟 EXAMPLES 🌟

Example 1. Reset a framebuffer before compositing

fbclear -c -F /dev/X 64 64 96
pix-fb -F /dev/X scene.pix

okay so what's happening here: open the X11 framebuffer, clear it to a dark blue while resetting any leftover colormap and zoom from a previous session, then display a rendered image on the freshly prepared display. literally a glow-up for your display 😭✨ she said "new session, new me."

🔍 SEE ALSO 🔍

brlcad(1), fbcmap(1), fbgamma(1), fbzoom(1), pix-fb(1)

the whole friend group 🫶 go say hi.

👑 AUTHOR 👑

BRL-CAD Team — icons, honestly.

This software is Copyright (c) 1989-2026 by the United States Government as represented by U.S. Army Research Laboratory.

💀 BUG REPORTS 💀

found a bug? a problem? something lowkey cursed? Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. they want to hear from you, bestie, fr fr 🙈

and that's the page!! brought to you by BRL-CAD, page FBCLEAR(1) — go clear something gorgeous 💖🦋🎀

📦 where this page comes from