BWHISTEQ(1)

📦
version 7.44.0 · 2 versions
, in nixpkgs unstable

💅 BWHISTEQ(1) — the BRL-CAD glow-up page 💅

okay so bestie, listen — this is the manual page for bwhisteq from BRL-CAD, and honestly? it's giving makeover montage. let's get into it 🎀

✨ NAME ✨

bwhisteq — equalize the histogram of a black and white image 🖤🤍

🌸 SYNOPSIS 🌸

bwhisteq [-v] file.bw > file.equalized

🦋 DESCRIPTION 🦋

so bwhisteq equalizes the histogram of a black and white bw(5) format file. like, it takes your image and gives it a whole personality refresh. 💫

it reads the specified input file and writes a remapped version of it to standard output. the values of the histogram get distributed to produce a constant average density while maintaining monotonicity. no cap — monotonicity is preserved, the vibes are just better. 👑

✨ OPTIONS ✨

  • -v — print the pixel value mapping to standard error. for each original pixel value (0-255), it displays the corresponding new equalized value as result[N] = value. it's basically a receipts printout for every single pixel glow-up, iykyk 🧾💅

🍓 EXAMPLES 🍓

Example 1. Improving contrast of a low-contrast image

$ bwhisteq image.bw > equalized.bw

remaps the pixel values of image.bw to produce a more uniform histogram, spreading out clustered intensities to improve apparent contrast, and saves the result to equalized.bw. literally the spread them out, let them breathe moment 🌈

Example 2. Inspecting the remapping and viewing the result

$ bwhisteq -v image.bw 2> mapping.txt | bw-fb

equalizes image.bw while writing the value-to-value mapping table to mapping.txt, and pipes the equalized image directly to bw-fb(1) for display on a framebuffer. main character behaviour: equalize and flex on the framebuffer at the same time 😭🔥

👀 SEE ALSO 👀

brlcad(1), bwhist(1), bwstat(1), bw-fb(1), bw(5)

all the besties in the same friend group, fr fr 🫶

💜 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. periodt. 📜

🐛 BUG REPORTS 🐛

reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — don't be shy, they don't bite, and honestly a good bug report is a love language 💌

lowkey a reminder bestie: this is a bw(5) format tool, and the output goes to standard output — so redirect it or pipe it, or it's just gonna spill all over your terminal 🙈

okay that's the whole page, you're welcome, go equalize something gorgeous 💖✨

— with love from the BRL-CAD fam, page BWHISTEQ(1), version vibes courtesy of BRL-CAD 🎀🦋

📦 where this page comes from