1 @comment TROFF INPUT: .TH UNIHEX2PNG 1 "2013 Nov 09"
5 @c DEBUG: print_menu("@section")
9 * unihex2png SYNOPSIS::
10 * unihex2png DESCRIPTION::
11 * unihex2png OPTIONS::
12 * unihex2png EXAMPLE::
14 * unihex2png SEE ALSO::
16 * unihex2png LICENSE::
22 @comment TROFF INPUT: .SH NAME
25 @subsection unihex2png NAME
26 @c DEBUG: print_menu("unihex2png NAME")
28 unihex2png @minus{} GNU Unifont .hex file to Portable Network Graphics converter
29 @comment TROFF INPUT: .SH SYNOPSIS
31 @node unihex2png SYNOPSIS
32 @subsection unihex2png SYNOPSIS
33 @c DEBUG: print_menu("unihex2png SYNOPSIS")
35 @comment TROFF INPUT: .br
37 @comment TROFF INPUT: .B unihex2png
40 @comment TROFF INPUT: .I input_file.hex
41 @i{input@t{_}file.hex}
44 @comment TROFF INPUT: .I output_file.png
45 @i{output@t{_}file.png}
47 @comment TROFF INPUT: .I pagenum
50 @comment TROFF INPUT: .I rows
53 @comment TROFF INPUT: .SH DESCRIPTION
55 @node unihex2png DESCRIPTION
56 @subsection unihex2png DESCRIPTION
57 @c DEBUG: print_menu("unihex2png DESCRIPTION")
59 @comment TROFF INPUT: .B unihex2png
61 reads a page of 256 Unicode code points from a GNU Unifont .hex file
62 and converts the page into a Portable Network Graphics (PNG) file.
63 The graphics file displays the glyphs
64 of a Unicode block of 256 code points in a 32 by 32 pixel grid,
65 or in a 40 by 40 pixel grid if "-r 32" is specified.
66 The glyphs themselves can be either 16, 24, or 32 pixels tall depending on
67 the "-r" parameter. They can be 8, 16, 24, or 32 pixels wide (widths of 32
68 are only supported if "-r 32" is specified).
69 The default page is 0; that is, the range U+0000 through U+00FF, inclusive.
70 @comment TROFF INPUT: .PP
72 The PNG file can be printed. It can also be edited with a graphics editor.
73 An edited PNG file can then be re-converted into a GNU Unifont .hex file
75 @comment TROFF INPUT: .B unipng2hex
78 @comment TROFF INPUT: .PP
80 @comment TROFF INPUT: .SH OPTIONS
82 @node unihex2png OPTIONS
83 @subsection unihex2png OPTIONS
84 @c DEBUG: print_menu("unihex2png OPTIONS")
86 @comment TROFF INPUT: .TP 12
88 @c ---------------------------------------------------------------------
91 Specify the input file. If not omitted, a Unifont .hex file
93 @comment TROFF INPUT: .TP
96 Specify the output file.
97 @comment TROFF INPUT: .TP
101 @comment TROFF INPUT: .I pagenum
103 from the .hex file. The default is Page 0 (Unicode range
104 U+0000 through U+00FF). Note that "page" is not a standard
105 Unicode term. It refers to an output bitmap graphics page of
106 16 by 16 code points.
107 @comment TROFF INPUT: .TP
111 @comment TROFF INPUT: .I rows
113 of pixels in the output glyphs. Valid values are 16, 24, and 32.
114 The default is 16 pixel rows tall.
115 @comment TROFF INPUT: .TP
118 Print a help message of options and exit.
119 @comment TROFF INPUT: .SH EXAMPLE
123 @c ---------------------------------------------------------------------
125 @node unihex2png EXAMPLE
126 @subsection unihex2png EXAMPLE
127 @c DEBUG: print_menu("unihex2png EXAMPLE")
130 @comment TROFF INPUT: .PP
132 @comment TROFF INPUT: .RS
134 @c ---------------------------------------------------------------------
136 unihex2png -i my@t{_}input@t{_}file.hex -o my@t{_}output@t{_}file.png
137 @comment TROFF INPUT: .RE
141 @c ---------------------------------------------------------------------
142 @comment TROFF INPUT: .SH FILES
144 @node unihex2png FILES
145 @subsection unihex2png FILES
146 @c DEBUG: print_menu("unihex2png FILES")
148 *.hex GNU Unifont font files
149 @comment TROFF INPUT: .SH SEE ALSO
151 @node unihex2png SEE ALSO
152 @subsection unihex2png SEE ALSO
153 @c DEBUG: print_menu("unihex2png SEE ALSO")
155 @comment TROFF INPUT: .BR bdfimplode(1),
157 @comment TROFF INPUT: .BR hex2bdf(1),
159 @comment TROFF INPUT: .BR hex2sfd(1),
161 @comment TROFF INPUT: .BR hexbraille(1),
163 @comment TROFF INPUT: .BR hexdraw(1),
165 @comment TROFF INPUT: .BR hexkinya(1),
167 @comment TROFF INPUT: .BR hexmerge(1),
169 @comment TROFF INPUT: .BR johab2ucs2(1),
171 @comment TROFF INPUT: .BR unibdf2hex(1),
173 @comment TROFF INPUT: .BR unibmp2hex(1),
175 @comment TROFF INPUT: .BR unicoverage(1),
177 @comment TROFF INPUT: .BR unidup(1),
179 @comment TROFF INPUT: .BR unifont(5),
181 @comment TROFF INPUT: .BR unifontchojung(1),
182 @b{unifontchojung(1),}
183 @comment TROFF INPUT: .BR unifontksx(1),
185 @comment TROFF INPUT: .BR unifontpic(1),
187 @comment TROFF INPUT: .BR unigencircles(1),
188 @b{unigencircles(1),}
189 @comment TROFF INPUT: .BR unigenwidth(1),
191 @comment TROFF INPUT: .BR unihex2bmp(1),
193 @comment TROFF INPUT: .BR unihexgen(1),
195 @comment TROFF INPUT: .BR unipagecount(1),
197 @comment TROFF INPUT: .BR unipng2hex(1)
199 @comment TROFF INPUT: .SH AUTHOR
201 @node unihex2png AUTHOR
202 @subsection unihex2png AUTHOR
203 @c DEBUG: print_menu("unihex2png AUTHOR")
205 @comment TROFF INPUT: .B unihex2png
207 was written by Andrew Miller, starting by converting Paul Hardy's unihex2bmp
209 @comment TROFF INPUT: .SH LICENSE
211 @node unihex2png LICENSE
212 @subsection unihex2png LICENSE
213 @c DEBUG: print_menu("unihex2png LICENSE")
215 @comment TROFF INPUT: .B unihex2png
217 is Copyright @copyright{} 2007 Paul Hardy, @copyright{} 2013 Andrew Miller.
218 @comment TROFF INPUT: .PP
220 This program is free software; you can redistribute it and/or modify
221 it under the terms of the GNU General Public License as published by
222 the Free Software Foundation; either version 2 of the License, or
223 (at your option) any later version.
224 @comment TROFF INPUT: .SH BUGS
226 @node unihex2png BUGS
227 @subsection unihex2png BUGS
228 @c DEBUG: print_menu("unihex2png BUGS")
230 No known real bugs exist, but the optional pixel rows parameter is not
231 yet supported by all other Unifont utilities. Use of glyphs taller than
232 the default of 16 pixels is considered experimental. Currently
233 @comment TROFF INPUT: .B unihex2png, unipng2hex, hexdraw,
234 @b{unihex2png, unipng2hex, hexdraw,}
236 @comment TROFF INPUT: .B hex2bdf
238 tentatively support glyphs that are 16, 24, and 32 pixels tall.
239 @comment TROFF INPUT: .PP
242 extensive error checking on input files. If they're not in the
243 format of the original GNU Unifont .hex file, all bets are off.
244 Lines can be terminated either with line feed, or
245 carriage return plus line feed.