UNIFONT1PER(1)

💖 UNIFONT1PER 💖

okay bestie, gather round, because unifont1per is one of those tiny little tools that does exactly one thing and does it slay. it's a General Commands Manual page, she's from the GNU Unifont crew, and she's here to turn your font data into actual pictures. no cap.

---

✨ NAME ✨

unifont1per — bestie, this makes BMP glyph files out of a GNU Unifont .hex file. that's the whole job. iconic.

---

🌸 SYNOPSIS 🌸

unifont1per < input_file.hex

she reads from standard input, so pipe it in like the main character she is. 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea: unifont1per reads a GNU Unifont .hex file, and for each and every code point in that file, it creates an output Bitmapped Graphics (.bmp) file right there in the current directory. 💅

the filename for each output file is U+codepoint.bmp, where codepoint is the Unicode codepoint for that glyph. literally naming them after themselves, self-obsessed queen behavior.

each glyph entry in a Unifont .hex file is expected to be 16 rows tall, and can be 8, 16, 24, or 32 pixels wide. and here's the cute part — the glyph sizes in the output files get determined on a glyph-by-glyph basis. no universal sizing, every glyph gets to be its own person. 🌈

this program can be of use in extracting individual glyphs to display in a document or on a web page. so if you're building a website and you need one specific little guy, she's your girl. ✨

WARNING! ⚠️ this program generates one output file per code point that appears in the input stream. if you feed this program a file with 1000 code points, it will generate 1000 files in your current directory. 💀 bestie. that's a LOT of files. your directory is gonna be absolutely crammed. please look before you leap, i am begging.

---

🎀 OPTIONS 🎀

• None. — nope! zero! nothing! she takes no flags, no options, no nothing. she simply is. 💖

---

🍓 FILES 🍓

• *.hex — GNU Unifont font files, read from standard input. that's it. that's the file situation. 🧚

---

👑 SEE ALSO 👑

the whole unifont girl squad, all linked up:

• 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)
• 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 💜

unifont1per was written by Paul Hardy. king behavior, honestly. 🫡

---

⭐ LICENSE ⭐

unifont1per is Copyright © 2017 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.

^(that's the standard GPL blessing, she's free and open and generous about it 💖)

---

😭 BUGS 😭

No known real bugs exist, except that this software does not perform extensive error checking on its input files. 🫠 so like... she trusts you. maybe too much.

If they're not in the format of the original GNU Unifont .hex file, all bets are off. fr fr, no promises, no refunds, chaos mode enabled. 💀

Lines can be terminated either with line feed, or carriage return plus line feed. so both \n and \r\n are fine, she's flexible like that. 💅

---

and that's the whole page, bestie!! 🎀 go forth and generate way too many .bmp files, you absolute icon. 👑

sending you off with love from the 2017 Jun 11 edition of UNIFONT1PER(1) — mwah, kiss kiss, go slay. 💖✨🦋