UNIHEXPOSE(1)

✨ UNIHEXPOSE(1) β€” the manual page, but make it cute ✨

okay so bestie, welcome to unihexpose, part of the General Commands Manual crew. It's a tiny little icon that flips your glyphs sideways. Let's get into it πŸ’–


🌸 NAME 🌸

unihexpose β€” Convert a GNU Unifont glyph into column-major format

Like, it takes a glyph and poses it. The name is literally "unihex" + "pose" and honestly? Ate. πŸ‘‘


πŸŽ€ SYNOPSIS πŸŽ€

unihexpose < input-font.hex > transposed-font.hex

That's the whole vibe. Pipe in, pipe out, no flags, no drama, no --help nonsense. Just redirects, bestie. πŸ¦‹


πŸ’… DESCRIPTION πŸ’…

Okay so here's the tea. unihexpose reads a sorted GNU Unifont .hex file from STDIN and writes a transposed Unifont .hex file to STDOUT. That's the deal. No files to name, no options to remember β€” the shell redirection is the interface. Iconic behaviour honestly. ✨

The output .hex file contains glyphs encoded in column major format, with 8 rows per output column. Why would you even want that, you ask? Because it simplifies output of Unifont glyphs on graphics displays whose controller chips are designed to autoincrement across a line of 8 pixel rows, one column at a time. So instead of walking left-to-right along a row, the chip walks top-to-bottom down a column, and this tool pre-chews the glyph so that motion just works. Main character energy from the display controller fr fr πŸ”₯

The output .hex file contains a Unifont glyph in two halves: the first half is the first 8 pixel rows, and the second half is the second 8 pixel rows. The glyphs are 8 or 16 columns wide. So yeah β€” the halves are a row split, the widths are 8 or 16. Not me double-checking that twice 😭

Heads up babes: the input needs to be a sorted .hex file. That's what the page says, so that's what we're doing. πŸ™ˆ

πŸ“ FILES πŸ“

  • *.hex β€” GNU Unifont font files

That's it. That's the list. One glob and we move on. πŸ’œ


🌈 SEE ALSO 🌈

The whole Unifont extended cinematic universe, bestie β€” go read these too:

Yes, unihexpose(1) is in its own SEE ALSO list. Self-love. We respect it. 🫢


🧚 AUTHOR 🧚

unihexpose was written by Paul Hardy. Thank you Paul, king behaviour πŸ‘‘


πŸ‘‘ LICENSE πŸ‘‘

hexdraw is Copyright Β© 2023 Paul Hardy.

And yes bestie, it literally says hexdraw right there in the license section of the unihexpose page. I am not fixing it, I am not touching it, I am reporting it faithfully. That's the rule πŸ’€

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. πŸŽ€


πŸ’€ BUGS πŸ’€

No known bugs exist.

Not one. Zero. Clean sheet. The bug tracker is a peaceful meadow. 🌸


And that's the whole page, bestie! This was UNIHEXPOSE(1) from the General Commands Manual, and the version at the bottom was dated 2023 Aug 05. Go transpose some glyphs, you absolute icon βœ¨πŸ¦‹πŸ’–

πŸ“¦ where this page comes from