1 .TH UNIHEX2PNG 1 "2013 Nov 09"
3 unihex2png \- GNU Unifont .hex file to Portable Network Graphics converter
19 reads a page of 256 Unicode code points from a GNU Unifont .hex file
20 and converts the page into a Portable Network Graphics (PNG) file.
21 The graphics file displays the glyphs
22 of a Unicode block of 256 code points in a 32 by 32 pixel grid,
23 or in a 40 by 40 pixel grid if "-r 32" is specified.
24 The glyphs themselves can be either 16, 24, or 32 pixels tall depending on
25 the "-r" parameter. They can be 8, 16, 24, or 32 pixels wide (widths of 32
26 are only supported if "-r 32" is specified).
27 The default page is 0; that is, the range U+0000 through U+00FF, inclusive.
29 The PNG file can be printed. It can also be edited with a graphics editor.
30 An edited PNG file can then be re-converted into a GNU Unifont .hex file
37 Specify the input file. If not omitted, a Unifont .hex file
41 Specify the output file.
46 from the .hex file. The default is Page 0 (Unicode range
47 U+0000 through U+00FF). Note that "page" is not a standard
48 Unicode term. It refers to an output bitmap graphics page of
54 of pixels in the output glyphs. Valid values are 16, 24, and 32.
55 The default is 16 pixel rows tall.
58 Print a help message of options and exit.
63 unihex2png -i my_input_file.hex -o my_output_file.png
66 *.hex GNU Unifont font files
81 .BR unifont-viewer(1),
82 .BR unifontchojung(1),
93 was written by Andrew Miller, starting by converting Paul Hardy's unihex2bmp
97 is Copyright \(co 2007 Paul Hardy, \(co 2013 Andrew Miller.
99 This program is free software; you can redistribute it and/or modify
100 it under the terms of the GNU General Public License as published by
101 the Free Software Foundation; either version 2 of the License, or
102 (at your option) any later version.
104 No known real bugs exist, but the optional pixel rows parameter is not
105 yet supported by all other Unifont utilities. Use of glyphs taller than
106 the default of 16 pixels is considered experimental. Currently
107 .B unihex2png, unipng2hex, hexdraw,
110 tentatively support glyphs that are 16, 24, and 32 pixels tall.
113 extensive error checking on input files. If they're not in the
114 format of the original GNU Unifont .hex file, all bets are off.
115 Lines can be terminated either with line feed, or
116 carriage return plus line feed.