1UNIPNG2HEX(1) General Commands Manual UNIPNG2HEX(1)
2
6 unipng2hex - Portable Network Graphics to GNU Unifont .hex file con‐
7 verter
8
10 unipng2hex -i input_file.png [-o output_file.hex ] [-w width ]
11
13 unipng2hex reads a PNG file produced by unihex2png before or after
14 editing, and converts it back into a Unifont .hex format file. The PNG
15 file contains a block of 256 Unicode code points arranged in a 16 by 16
16 grid. Each code point appears in a 32 by 32 or a 40 by 40 pixel grid.
17 Characters are either 16, 24 or 32 pixel rows high, depending on the
18 "-r" parameter specified by unihex2png. They can be 8, 16, 24, or 32
19 pixel columns wide (widths of 32 are only supported for 32 pixel row
20 tall characters).
21
23 -i Specify the input file.
24 -o Specify the output file. If omitted, a file in the Unifont
26 .hex format is written to STDOUT.
27 -w width Specify the minimum width of the output glyphs. Valid val‐
29 ues are 16, 24,
30 and 32. The default is no minimum width.
31 -h Print a help message of options and exit.
33
35 Sample usage:
36 unipng2hex -i my_input_file.png -o my_output_file.hex
38
40 *.png graphics files
41
43 bdfimplode(1), hex2bdf(1), hex2sfd(1), hexbraille(1), hexdraw(1),
44 hexkinya(1), hexmerge(1), johab2ucs2(1), unibdf2hex(1), unibmp2hex(1),
45 unicoverage(1), unidup(1), unifont(5), unifont-viewer(1), uni‐
46 font1per(1), unifontchojung(1), unifontksx(1), unifontpic(1), unigen‐
47 circles(1), unigenwidth(1), unihex2bmp(1), unihex2png(1), unihex‐
48 fill(1), unihexgen(1), unipagecount(1)
49
51 unipng2hex was written by Andrew Miller, starting by converting Paul
52 Hardy's unibmp2hex C program to Perl.
53
55 unipng2hex is Copyright © 2007, 2008 Paul Hardy, © 2013 Andrew Miller.
56 This program is free software; you can redistribute it and/or modify it
58 under the terms of the GNU General Public License as published by the
59 Free Software Foundation; either version 2 of the License, or (at your
60 option) any later version.
61
63 No known real bugs exist, but the optional pixel rows parameter is not
64 yet supported by all other Unifont utilities. Use of glyphs taller
65 than the default of 16 pixels is considered experimental. Currently
66 unihex2png, unipng2hex, hexdraw, and hex2bdf tentatively support glyphs
67 that are 16, 24, and 32 pixels tall.
68 Also, this software does not perform extensive error checking on its
70 input files. If they're not in the format of the original PNG output
71 from unihex2png, all bets are off.
72 If the output file is for a "page" containing space code points and the
74 PNG file squares for those code points are not empty, unipng2hex pre‐
75 serves the graphics as they are drawn.
76 unipng2hex is designed to work with black and white pixels; do not use
78 other colors.
79 2013 Nov 09 UNIPNG2HEX(1)