NAME

       unifontpic - Convert GNU Unifont .hex input to a bitmap image of the whole font

SYNOPSIS

       unifontpic [-dnnn] [-l] [-t] [-Pplane] < input-font.hex > output-font.bmp

DESCRIPTION

       unifontpic reads a GNU Unifont .hex file from STDIN and writes a two dimensional rendering
       for each glyph to STDOUT.  The output displays an entire Unicode plane of 65,536 glyphs as
       one large graphic image, showing a grid of 256 glyphs by 256 glyphs as the default, or (at
       your option) a long version of 16 glyphs across by 4,096 glyphs down.

       Input can be one or more files in Unifont .hex format.  They don't have to be  sorted,  as
       unifontpic  will  populate the entire glyph array of 65,536 code points before writing its
       output.  The input glyph code points should all be unique, as feeding  in  duplicate  code
       points will produce unpredictable results.  Use unidup (1) on a sorted input of .hex files
       to guarantee no code point duplication.

OPTIONS

       -d    Specify a Dots per Inch (DPI) resolution of nnn.  For example, specifying -d120 will
             encode the bitmap graphics file output as having a resolution of 120 DPI.

       -l    Produce  a  long  chart, 16 glyphs wide by 4,096 glyphs tall.  The default is a wide
             chart, 256 glyphs wide by 256 glyphs tall.

       -t    Use tiny numbers for the row and column code point labels.  Tiny numbers are on a  4
             by 5 pixel grid.  Only tiny code point labels appear on the long chart variant; this
             option only has effect for wide charts (the default, of 256 by 256 glyphs).  If this
             option  is  not specified for the default 256-by-256 grid, row and column code point
             labels are taken from Unifont's glyphs for `0' to `9' and `A' to `F'.

       -P    Print a chart for Unicode plane number plane.  The default is Plane 0,  the  Unicode
             Basic  Multilingual  Plane (BMP).  The range of Unicode plane range is 0 through 17,
             inclusive.  The plane number is printed on the chart title line.

EXAMPLES

       Sample usage:

              cat *.hex | unifontpic -d120 > unifontpic.bmp

       To generate a bitmap that shows combining circles, from the font/ subdirectory:

              sort  plane00/*.hex  |  unigencircles  ttfsrc/combining.txt  |   unifontpic   -d120
              >unifontpic.bmp

FILES

       *.hex GNU Unifont font files

SEE ALSO

       bdfimplode(1), hex2bdf(1), hex2otf(1), hex2sfd(1), hexbraille(1), hexdraw(1), hexkinya(1),
       hexmerge(1), johab2ucs2(1), unibdf2hex(1), unibmp2hex(1),  unibmpbump(1),  unicoverage(1),
       unidup(1),     unifont(5),     unifont-viewer(1),    unifont1per(1),    unifontchojung(1),
       unifontksx(1),    unigencircles(1),    unigenwidth(1),    unihex2bmp(1),    unihex2png(1),
       unihexfill(1), unihexgen(1), unihexrotate(1), unipagecount(1), unipng2hex(1)

AUTHOR

       unifontpic was written by Paul Hardy.

LICENSE

       unifontpic is Copyright © 2013 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.

BUGS

       No known bugs exist.

                                           2013 Sep 07                              UNIFONTPIC(1)