UNIBMP2HEX(1)

💖 UNIBMP2HEX 💖

okay bestie, gather round, because we're talking about unibmp2hex(1) — a whole General Commands Manual moment, and honestly? she ate. ✨

---

🌸 NAME 🌸

unibmp2hex — the Bitmap graphics file → GNU Unifont .hex file converter, no cap 💅

---

🦋 SYNOPSIS 🦋

unibmp2hex [-phexpage] [-iinput_file.bmp] [-ooutput_file.hex] [-w]

---

✨ DESCRIPTION ✨

so here's the vibe: unibmp2hex reads in a bitmap that was made by unihex2bmp — either before or after you've edited it, both are valid — and converts it right back into a Unifont .hex format file. glow-up complete 🫶

the graphics file has a whole block of 256 Unicode code points in it, arranged in a 16 by 16 grid. and each individual code point? she's living in a 32 by 32 pixel grid.

characters are 16 rows high, and 8, 16, or 31 (treated as 32) columns wide. yes, 31 gets treated as 32 — she's rounding up, and honestly, good for her. 💀

---

💅 OPTIONS 💅

• -p — tells unibmp2hex that the code points are gonna be assigned to the 256 block space pagenum in the .hex file. if you don't pass this, unibmp2hex will figure out the right block all by herself by reading the row and column headers. main character behavior tbh. 🎀

quick note bestie: "page" is not a standard Unicode term. it just means an output bitmap graphics page of 16 by 16 code points. iykyk.

and listen — if pagenum is greater than FF, that block lives above the Unicode Basic Multilingual Plane. when that happens, the .hex file will contain eight digit hexadecimal code points instead of the Unifont standard of four hexadecimal code points. she switches formats, she's flexible. 💅

• -i — specify the input file. default is STDIN. 🌸
• -o — specify the output file. default is STDOUT. 🌸
• -w — force ALL output .hex glyphs to be 16 pixels wide, rather than dual width (8 or 16 pixels). periodt. 👑

---

🌈 EXAMPLE 🌈

sample usage, bestie, look how easy:

unibmp2hex -imy_input_file.bmp -omy_output_file.hex

---

🍓 FILES 🍓

*.bmp or *.wbmp graphics files — that's the whole menu 💜

---

🧚 SEE ALSO 🧚

the whole friend group, fr fr:

bdfimplode(1), hex2bdf(1), hex2otf(1), hex2sfd(1), hexbraille(1), hexdraw(1), hexkinya(1), hexmerge(1), johab2syllables(1), johab2ucs2(1), unibdf2hex(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), unihex2bmp(1), unihex2png(1), unihexfill(1), unihexgen(1), unihexpose(1), unihexrotate(1), unijohab2html(1), unipagecount(1), unipng2hex(1)

---

👑 AUTHOR 👑

unibmp2hex was written by Paul Hardy. iconic of him, honestly. 🌟

---

💜 LICENSE 💜

unibmp2hex is Copyright © 2007, 2008 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. slay. 🎀

---

💀 BUGS 💀

okay so, no known real bugs exist, bestie — except that this software does not perform extensive error checking on its input files. if they're not in the format of the original bitmapped output from unihex2bmp, all bets are off. 😭 like, genuinely. we warned you. 🙈

and one more thing: if the output file is for a "page" containing space code points, and the bitmap file squares for those code points are not empty, unibmp2hex preserves the graphics as they are drawn. she doesn't clean up after you, she just leaves it exactly how you drew it. 💅

---

and that's the whole page, bestie!! 🫶 this one's from the General Commands Manual, dated 2007 Dec 31 — she's a lil vintage icon and we love her for it. mwah. 💖✨🎀🦋🌸