Number of characters to put in one line. Defaults to autodetect. Ignored
if -p is used.
- -c <pixels>
- Character cell size. The special values auto and autorect may be used to
- choose an autodetected square or rectangle cell, respectively. Defaults to
- autodetected square. Ignored if -p is used.
+ -c <pixels>[x<pixels>]
+ Character cell size. If only a single number is given, a square cell is
+ used. The special values auto and autorect may be used to choose an
+ autodetected square or rectangle cell, respectively. The default is auto.
+ Ignored if -p is used.
-o <filename>
Output file name. Use - for stdout; the output is a png image, so it's
file alongside the image.
The basic format is line-based. Empty lines, or those starting with a hash
-sign (#), should be ignored. Data lines consist of fields separated with
-spaces.
+sign (#), should be ignored. Data lines consist of a keyword followed by
+space-separated fields.
-The first data line contains five fields with overall information about the
-image and the font:
+The keyword "font" is followed by five fields with overall information about
+the image and the font:
Fields 1-2: width and height of the image
Field 3: nominal size of the font
Fields 4-5: ascent and descent of the font
-Subsequent data lines each describe a single glyph and contain eight fields:
+The keyword "glyph" is followed by eight fields describing a single glyph:
Field 1: the code point of the glyph
Fields 2-3: x and y position of the glyph in the image
Fields 6-7: x and y offset of the glyph from its base point
Field 8: advance from this glyph to the next
+The keyword "kern" is followed by three fields describing kerning between two
+glyphs:
+
+ Field 1: the code point of the left-hand glyph
+ Field 2: the code point of the right-hand glyph
+ Field 3: kerning distance between the glyphs
+
The following ASCII art image illustrates most of these metrics. Note that in
some fonts, not all of the glyphs fit completely inside the character box.
Changelog
-next
+1.0
- Improve the packing algorithm
- Non-square cells for grid mode
- Option to invert colors
+- Include kerning information in definition file
0.3
- Restructure the code