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),
94 was written by Andrew Miller, starting by converting Paul Hardy's unihex2bmp
98 is Copyright \(co 2007 Paul Hardy, \(co 2013 Andrew Miller.
100 This program is free software; you can redistribute it and/or modify
101 it under the terms of the GNU General Public License as published by
102 the Free Software Foundation; either version 2 of the License, or
103 (at your option) any later version.
105 No known real bugs exist, but the optional pixel rows parameter is not
106 yet supported by all other Unifont utilities. Use of glyphs taller than
107 the default of 16 pixels is considered experimental. Currently
108 .B unihex2png, unipng2hex, hexdraw,
111 tentatively support glyphs that are 16, 24, and 32 pixels tall.
114 extensive error checking on input files. If they're not in the
115 format of the original GNU Unifont .hex file, all bets are off.
116 Lines can be terminated either with line feed, or
117 carriage return plus line feed.