UNIHEX2BMP(1)

💖 unihex2bmp — the manual page, but make it make sense 💖

okay bestie, welcome to unihex2bmp, a General Commands Manual page and honestly? it's giving glow-up energy for your font files. it takes a GNU Unifont .hex file and turns it into a whole picture. a bitmap one. iconic behavior, no cap. 🎀

---

✨ NAME ✨

unihex2bmp — GNU Unifont .hex file to bitmap graphics file converter 🦋

---

🌸 SYNOPSIS 🌸

unihex2bmp [-phexpage] [-iinput_file.hex] [-ooutput_file.bmp] [-f] [-w]

like. that's it. that's the whole vibe. 😌

---

💅 DESCRIPTION 💅

so here's the tea: unihex2bmp reads one GNU Unifont .hex file Unicode page of 256 code points, and converts that page into either a Microsoft Windows Bitmap (.bmp) or a Wireless Bitmap (.wbmp) file. yes, a real graphics file. we're doing that. 🫶

the bitmap file shows the glyphs of a Unicode block of 256 code points laid out in a 32 by 32 pixel grid. as for the glyphs themselves — they must be 16 rows high, and 8, 16, 24, or 31 (encoded as 32) columns wide. those are the rules, bestie, i don't make them. ✨

the default page is 0; that's the range U+0000 through U+00FF. page zero, first page, main character of the hex file, love that for her. 💖

and the plot twist? the bitmap can be printed. you can also edit it with a bitmap editor (go off, honestly). then — and this is the slay part — an edited bitmap can be re-converted back into a GNU Unifont .hex file with the unibmp2hex command. full circle. the cycle continues. 🔥

---

🎀 OPTIONS 🎀

• -p — extract page hexpage from the .hex file. the default is Page 0, aka Unicode range U+0000 through U+00FF. and ngl, quick heads up: "page" is not a standard Unicode term, so don't go quoting it at a Unicode conference. it refers to an output bitmap graphics page of 16 by 16 code points. iykyk. 💅
• -i — specify the input file. default is STDIN. (so if you're lazy, she'll just read whatever you pipe in. we love a flexible queen. 🦋)
• -o — specify the output file. default is STDOUT. (same energy, other direction ✨)
• -f — "flip" (transpose) the grid, swapping rows and columns from the Unicode standard orientation. it's giving rotated for the aesthetic 🌈
• -w — produce a Wireless Bitmap format file instead of a Microsoft Windows Bitmap file. small file, big vibe. 💀

---

🌟 EXAMPLE 🌟

sample usage, copy it, paste it, live it:

unihex2bmp -imy_input_file.hex -omy_output_file.bmp

look at her go. 🎀

---

🍓 FILES 🍓

• *.hex GNU Unifont font files

---

👑 SEE ALSO 👑

bdfimplode(1), hex2bdf(1), hex2otf(1), hex2sfd(1), hexbraille(1), hexdraw(1), hexkinya(1), hexmerge(1), johab2syllables(1), johab2ucs2(1), unibdf2hex(1), unibmp2hex(1), unibmpbump(1), unicoverage(1), unidup(1), unifont(5), unifont-johab631(5), unifont-viewer(1), unifont1per(1), unifontchojung(1), unifontksx(1), unifontpic(1), unigen-hangul(1), unigencircles(1), unigenwidth(1), unihex2png(1), unihexfill(1), unihexgen(1), unihexpose(1), unihexrotate(1), unijohab2html(1), unipagecount(1), unipng2hex(1)

(that's the whole group chat. go say hi. 💜)

---

💖 AUTHOR 💖

unihex2bmp was written by Paul Hardy. shoutout to the icon, the moment, the legend. 👑

---

📜 LICENSE 📜

unihex2bmp is Copyright © 2007 Paul Hardy.

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

(fr fr, it's free, go forth and redistribute 🫶)

---

💀 BUGS 💀

no known real bugs exist, except that this software does not perform extensive error checking on its input files. so like — if they're not in the format of the original GNU Unifont .hex file, all bets are off. 😭 genuinely. no promises. chaos mode.

also, lines can be terminated either with line feed, or carriage return plus line feed. both are valid, she's not picky. 💅

---

okay that's the page!! written by Paul Hardy, copyright © 2007, and this whole thing is dated 2007 Dec 31 — yes she's an elder but she's still serving. 🦋✨ bye bestie, go convert some hex! 💖🌈🎀