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: .SH OPTIONS
80 @node unihex2png OPTIONS
81 @subsection unihex2png OPTIONS
82 @c DEBUG: print_menu("unihex2png OPTIONS")
84 @comment TROFF INPUT: .TP 12
86 @c ---------------------------------------------------------------------
89 Specify the input file. If not omitted, a Unifont .hex file
91 @comment TROFF INPUT: .TP
94 Specify the output file.
95 @comment TROFF INPUT: .TP
99 @comment TROFF INPUT: .I pagenum
101 from the .hex file. The default is Page 0 (Unicode range
102 U+0000 through U+00FF). Note that "page" is not a standard
103 Unicode term. It refers to an output bitmap graphics page of
104 16 by 16 code points.
105 @comment TROFF INPUT: .TP
109 @comment TROFF INPUT: .I rows
111 of pixels in the output glyphs. Valid values are 16, 24, and 32.
112 The default is 16 pixel rows tall.
113 @comment TROFF INPUT: .TP
116 Print a help message of options and exit.
117 @comment TROFF INPUT: .SH EXAMPLE
121 @c ---------------------------------------------------------------------
123 @node unihex2png EXAMPLE
124 @subsection unihex2png EXAMPLE
125 @c DEBUG: print_menu("unihex2png EXAMPLE")
128 @comment TROFF INPUT: .PP
130 @comment TROFF INPUT: .RS
132 @c ---------------------------------------------------------------------
134 unihex2png -i my@t{_}input@t{_}file.hex -o my@t{_}output@t{_}file.png
135 @comment TROFF INPUT: .RE
139 @c ---------------------------------------------------------------------
140 @comment TROFF INPUT: .SH FILES
142 @node unihex2png FILES
143 @subsection unihex2png FILES
144 @c DEBUG: print_menu("unihex2png FILES")
146 *.hex GNU Unifont font files
147 @comment TROFF INPUT: .SH SEE ALSO
149 @node unihex2png SEE ALSO
150 @subsection unihex2png SEE ALSO
151 @c DEBUG: print_menu("unihex2png SEE ALSO")
153 @comment TROFF INPUT: .BR bdfimplode(1),
155 @comment TROFF INPUT: .BR hex2bdf(1),
157 @comment TROFF INPUT: .BR hex2sfd(1),
159 @comment TROFF INPUT: .BR hexbraille(1),
161 @comment TROFF INPUT: .BR hexdraw(1),
163 @comment TROFF INPUT: .BR hexkinya(1),
165 @comment TROFF INPUT: .BR hexmerge(1),
167 @comment TROFF INPUT: .BR johab2ucs2(1),
169 @comment TROFF INPUT: .BR unibdf2hex(1),
171 @comment TROFF INPUT: .BR unibmp2hex(1),
173 @comment TROFF INPUT: .BR unicoverage(1),
175 @comment TROFF INPUT: .BR unidup(1),
177 @comment TROFF INPUT: .BR unifont(5),
179 @comment TROFF INPUT: .BR unifont-viewer(1),
180 @b{unifont-viewer(1),}
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 unihexfill(1),
195 @comment TROFF INPUT: .BR unihexgen(1),
197 @comment TROFF INPUT: .BR unipagecount(1),
199 @comment TROFF INPUT: .BR unipng2hex(1)
201 @comment TROFF INPUT: .SH AUTHOR
203 @node unihex2png AUTHOR
204 @subsection unihex2png AUTHOR
205 @c DEBUG: print_menu("unihex2png AUTHOR")
207 @comment TROFF INPUT: .B unihex2png
209 was written by Andrew Miller, starting by converting Paul Hardy's unihex2bmp
211 @comment TROFF INPUT: .SH LICENSE
213 @node unihex2png LICENSE
214 @subsection unihex2png LICENSE
215 @c DEBUG: print_menu("unihex2png LICENSE")
217 @comment TROFF INPUT: .B unihex2png
219 is Copyright @copyright{} 2007 Paul Hardy, @copyright{} 2013 Andrew Miller.
220 @comment TROFF INPUT: .PP
222 This program is free software; you can redistribute it and/or modify
223 it under the terms of the GNU General Public License as published by
224 the Free Software Foundation; either version 2 of the License, or
225 (at your option) any later version.
226 @comment TROFF INPUT: .SH BUGS
228 @node unihex2png BUGS
229 @subsection unihex2png BUGS
230 @c DEBUG: print_menu("unihex2png BUGS")
232 No known real bugs exist, but the optional pixel rows parameter is not
233 yet supported by all other Unifont utilities. Use of glyphs taller than
234 the default of 16 pixels is considered experimental. Currently
235 @comment TROFF INPUT: .B unihex2png, unipng2hex, hexdraw,
236 @b{unihex2png, unipng2hex, hexdraw,}
238 @comment TROFF INPUT: .B hex2bdf
240 tentatively support glyphs that are 16, 24, and 32 pixels tall.
241 @comment TROFF INPUT: .PP
244 extensive error checking on input files. If they're not in the
245 format of the original GNU Unifont .hex file, all bets are off.
246 Lines can be terminated either with line feed, or
247 carriage return plus line feed.