1UNIHEX2PNG(1) General Commands Manual UNIHEX2PNG(1)
2
6 unihex2png - GNU Unifont .hex file to Portable Network Graphics con‐
7 verter
8
10 unihex2png [-i input_file.hex ] -o output_file.png [-p pagenum ] [-r
11 rows ]
12
14 unihex2png reads a page of 256 Unicode code points from a GNU Unifont
15 .hex file and converts the page into a Portable Network Graphics (PNG)
16 file. The graphics file displays the glyphs of a Unicode block of 256
17 code points in a 32 by 32 pixel grid, or in a 40 by 40 pixel grid if
18 "-r 32" is specified. The glyphs themselves can be either 16, 24, or
19 32 pixels tall depending on the "-r" parameter. They can be 8, 16, 24,
20 or 32 pixels wide (widths of 32 are only supported if "-r 32" is speci‐
21 fied). The default page is 0; that is, the range U+0000 through
22 U+00FF, inclusive.
23 The PNG file can be printed. It can also be edited with a graphics
25 editor. An edited PNG file can then be re-converted into a GNU Unifont
26 .hex file with the unipng2hex command.
27
29 -i Specify the input file. If not omitted, a Unifont .hex
30 file is read from STDIN.
31 -o Specify the output file.
33 -p pagenum Extract page pagenum from the .hex file. The default is
35 Page 0 (Unicode range U+0000 through U+00FF). Note that
36 "page" is not a standard Unicode term. It refers to an
37 output bitmap graphics page of 16 by 16 code points.
38 -r rows Specify the rows of pixels in the output glyphs. Valid
40 values are 16, 24, and 32. The default is 16 pixel rows
41 tall.
42 -h Print a help message of options and exit.
44
46 Sample usage:
47 unihex2png -i my_input_file.hex -o my_output_file.png
49
51 *.hex GNU Unifont font files
52
54 bdfimplode(1), hex2bdf(1), hex2sfd(1), hexbraille(1), hexdraw(1),
55 hexkinya(1), hexmerge(1), johab2ucs2(1), unibdf2hex(1), unibmp2hex(1),
56 unicoverage(1), unidup(1), unifont(5), unifont-viewer(1), uni‐
57 font1per(1), unifontchojung(1), unifontksx(1), unifontpic(1), unigen‐
58 circles(1), unigenwidth(1), unihex2bmp(1), unihexfill(1), unihexgen(1),
59 unipagecount(1), unipng2hex(1)
60
62 unihex2png was written by Andrew Miller, starting by converting Paul
63 Hardy's unihex2bmp C program to Perl.
64
66 unihex2png is Copyright © 2007 Paul Hardy, © 2013 Andrew Miller.
67 This program is free software; you can redistribute it and/or modify it
69 under the terms of the GNU General Public License as published by the
70 Free Software Foundation; either version 2 of the License, or (at your
71 option) any later version.
72
74 No known real bugs exist, but the optional pixel rows parameter is not
75 yet supported by all other Unifont utilities. Use of glyphs taller
76 than the default of 16 pixels is considered experimental. Currently
77 unihex2png, unipng2hex, hexdraw, and hex2bdf tentatively support glyphs
78 that are 16, 24, and 32 pixels tall.
79 Also, there is no extensive error checking on input files. If they're
81 not in the format of the original GNU Unifont .hex file, all bets are
82 off. Lines can be terminated either with line feed, or carriage return
83 plus line feed.
84 2013 Nov 09 UNIHEX2PNG(1)