NAME

       unipng2hex - Portable Network Graphics to GNU Unifont .hex file converter

SYNOPSIS

       unipng2hex -i input_file.png [-o output_file.hex ] [-w width ]

DESCRIPTION

       unipng2hex  reads  a PNG file produced by unihex2png before or after editing, and converts
       it back into a Unifont .hex format file.  The PNG file contains a  block  of  256  Unicode
       code points arranged in a 16 by 16 grid.  Each code point appears in a 32 by 32 or a 40 by
       40 pixel grid.  Characters are either 16, 24 or 32 pixel rows high, depending on the  "-r"
       parameter  specified  by  unihex2png.   They  can  be  8, 16, 24, or 32 pixel columns wide
       (widths of 32 are only supported for 32 pixel row tall characters).

OPTIONS

       -i          Specify the input file.

       -o          Specify the output file.  If omitted, a file in the  Unifont  .hex  format  is
                   written to STDOUT.

       -w width    Specify the minimum width of the output glyphs.  Valid values are 16, 24,
                    and 32.  The default is no minimum width.

       -h          Print a help message of options and exit.

EXAMPLE

       Sample usage:

              unipng2hex -i my_input_file.png -o my_output_file.hex

FILES

       *.png graphics files

SEE ALSO

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

AUTHOR

       unipng2hex  was written by Andrew Miller, starting by converting Paul Hardy's unibmp2hex C
       program to Perl.

LICENSE

       unipng2hex is Copyright © 2007, 2008 Paul Hardy, © 2013 Andrew Miller.

       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 real bugs exist, but the optional pixel rows parameter is not  yet  supported  by
       all  other  Unifont  utilities.   Use  of  glyphs  taller than the default of 16 pixels is
       considered  experimental.   Currently  unihex2png,  unipng2hex,   hexdraw,   and   hex2bdf
       tentatively support glyphs that are 16, 24, and 32 pixels tall.

       Also,  this  software  does  not  perform extensive error checking on its input files.  If
       they're not in the format of the original PNG output from unihex2png, all bets are off.

       If the output file is for a "page" containing space code points and the PNG  file  squares
       for those code points are not empty, unipng2hex preserves the graphics as they are drawn.

       unipng2hex is designed to work with black and white pixels; do not use other colors.

                                           2013 Nov 09                              UNIPNG2HEX(1)