font-problems is a command-line tool for reading and writing console bitmap fonts. These are fonts described by a rectangular pixel matrix, used for small hardware projects like light-up signs or low-resolution terminals.
In particular, it can read build a PSF file out of a BMP file, and write a PSF into a BMP file for easy editing. Some examples are in the
Building and running requires node.js.
$ npm install $ ./bin/font-problems --help
Supported formats are:
.bmp grid of glyphs .psf portable screen font (used by Linux and PC DOS) .h C header (output only) .rs Rust header (output only)
A font in BMP format is a regular grid of glyphs. You can specify the glyph dimensions manually, though it can usually detect the borders automatically by noticing the empty pixels between letters. The glyphs are assumed to be drawn in a dark color (like black) on a light color (like white), though they can be read from a white-on-black file using
Glyphs that aren't as wide as the cell should be pushed up against the left edge. For proportional fonts, font-problems will detect the whitespace on the right edge, and remove it.
"Header file" format is a C or Rust header file with one constant each for the glyph width (monospace only) and height, an array of cell data. You can use these to directly include a bitmap font in the source for your project.
For proportional fonts, there's also an array of offsets for indexing. The cell data for character n starts at
offset[n] (inclusive) and goes through
offset[n + 1] (exclusive))
Each int is a single row or column of pixels, in LSB or MSB order. LSB (the default) means the left or top pixel is in the least-significant bit.
PSF file format is described here: http://www.win.tue.nl/~aeb/linux/kbd/font-formats-1.html
Each glyph must be the same width and height in a PSF file (monospace), and exactly 256 or 512 characters must be defined. BIOS only supports a glyph width of 8, so only framebuffers can use other widths. (Linux still uses BIOS to draw text in a surprising number of cases.)
Font-problems will generate a simple unicode mapping table for PSF files, which you can specify with "--map". This is a text file in a particular format, described here: PSF map files
Three sample fonts are included, in the fonts/ folder:
"Tom Thumb" is from my blog, with some line-drawing and block characters added, for console tools like Midnight Commander. Each cell is 4x6, which I believe is the smallest a bitmap font can be while still having any legibility.
"Lola" is a simple proportional font, ranging from 4x8 to 6x8, in ASCII only. It was designed to work on LED matrix displays like this one.
"Oranj" is a 6x8 monospace font inspired by the Apple II, with support for most Latin glyphs.
All of these fonts are licensed as Creative Commons "share & adapt": http://creativecommons.org/licenses/by/4.0/
Apache 2 (open-source) license, included in
@robey - Robey Pointer firstname.lastname@example.org