jammy (1) unipng2hex.1.gz

Provided by: unifont-bin_14.0.01-1_amd64 bug

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    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),  unibmpbump(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),    unihexrotate(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)