1 @comment TROFF INPUT: .TH UNIPNG2HEX 1 "2013 Nov 09"
5 @c DEBUG: print_menu("@section")
9 * unipng2hex SYNOPSIS::
10 * unipng2hex DESCRIPTION::
11 * unipng2hex OPTIONS::
12 * unipng2hex EXAMPLE::
14 * unipng2hex SEE ALSO::
16 * unipng2hex LICENSE::
22 @comment TROFF INPUT: .SH NAME
25 @subsection unipng2hex NAME
26 @c DEBUG: print_menu("unipng2hex NAME")
28 unipng2hex @minus{} Portable Network Graphics to GNU Unifont .hex file converter
29 @comment TROFF INPUT: .SH SYNOPSIS
31 @node unipng2hex SYNOPSIS
32 @subsection unipng2hex SYNOPSIS
33 @c DEBUG: print_menu("unipng2hex SYNOPSIS")
35 @comment TROFF INPUT: .br
37 @comment TROFF INPUT: .B unipng2hex
40 @comment TROFF INPUT: .I input_file.png
41 @i{input@t{_}file.png}
43 @comment TROFF INPUT: .I output_file.hex
44 @i{output@t{_}file.hex}
46 @comment TROFF INPUT: .I width
49 @comment TROFF INPUT: .SH DESCRIPTION
51 @node unipng2hex DESCRIPTION
52 @subsection unipng2hex DESCRIPTION
53 @c DEBUG: print_menu("unipng2hex DESCRIPTION")
55 @comment TROFF INPUT: .B unipng2hex
57 reads a PNG file produced by
58 @comment TROFF INPUT: .B unihex2png
60 before or after editing, and converts it back into a Unifont .hex format
61 file. The PNG file contains a block of 256 Unicode code points
62 arranged in a 16 by 16 grid. Each code point appears in a 32 by 32 or a 40
63 by 40 pixel grid. Characters are either 16, 24 or 32 pixel rows high,
64 depending on the "-r" parameter specified by
65 @comment TROFF INPUT: .B unihex2png.
67 They can be 8, 16, 24, or 32 pixel columns wide (widths of 32 are only
68 supported for 32 pixel row tall characters).
69 @comment TROFF INPUT: .SH OPTIONS
71 @node unipng2hex OPTIONS
72 @subsection unipng2hex OPTIONS
73 @c DEBUG: print_menu("unipng2hex OPTIONS")
75 @comment TROFF INPUT: .TP 12
77 @c ---------------------------------------------------------------------
80 Specify the input file.
81 @comment TROFF INPUT: .TP
84 Specify the output file. If omitted, a file in the Unifont .hex format
86 @comment TROFF INPUT: .TP
89 Specify the minimum width of the output glyphs. Valid values are 16, 24,
90 and 32. The default is no minimum width.
91 @comment TROFF INPUT: .TP
94 Print a help message of options and exit.
95 @comment TROFF INPUT: .SH EXAMPLE
99 @c ---------------------------------------------------------------------
101 @node unipng2hex EXAMPLE
102 @subsection unipng2hex EXAMPLE
103 @c DEBUG: print_menu("unipng2hex EXAMPLE")
106 @comment TROFF INPUT: .PP
108 @comment TROFF INPUT: .RS
110 @c ---------------------------------------------------------------------
112 unipng2hex -i my@t{_}input@t{_}file.png -o my@t{_}output@t{_}file.hex
113 @comment TROFF INPUT: .RE
117 @c ---------------------------------------------------------------------
118 @comment TROFF INPUT: .SH FILES
120 @node unipng2hex FILES
121 @subsection unipng2hex FILES
122 @c DEBUG: print_menu("unipng2hex FILES")
125 @comment TROFF INPUT: .SH SEE ALSO
127 @node unipng2hex SEE ALSO
128 @subsection unipng2hex SEE ALSO
129 @c DEBUG: print_menu("unipng2hex SEE ALSO")
131 @comment TROFF INPUT: .BR bdfimplode(1),
133 @comment TROFF INPUT: .BR hex2bdf(1),
135 @comment TROFF INPUT: .BR hex2sfd(1),
137 @comment TROFF INPUT: .BR hexbraille(1),
139 @comment TROFF INPUT: .BR hexdraw(1),
141 @comment TROFF INPUT: .BR hexkinya(1),
143 @comment TROFF INPUT: .BR hexmerge(1),
145 @comment TROFF INPUT: .BR johab2ucs2(1),
147 @comment TROFF INPUT: .BR unibdf2hex(1),
149 @comment TROFF INPUT: .BR unibmp2hex(1),
151 @comment TROFF INPUT: .BR unicoverage(1),
153 @comment TROFF INPUT: .BR unidup(1),
155 @comment TROFF INPUT: .BR unifont(5),
157 @comment TROFF INPUT: .BR unifont-viewer(1),
158 @b{unifont-viewer(1),}
159 @comment TROFF INPUT: .BR unifontchojung(1),
160 @b{unifontchojung(1),}
161 @comment TROFF INPUT: .BR unifontksx(1),
163 @comment TROFF INPUT: .BR unifontpic(1),
165 @comment TROFF INPUT: .BR unigencircles(1),
166 @b{unigencircles(1),}
167 @comment TROFF INPUT: .BR unigenwidth(1),
169 @comment TROFF INPUT: .BR unihex2bmp(1),
171 @comment TROFF INPUT: .BR unihex2png(1),
173 @comment TROFF INPUT: .BR unihexfill(1),
175 @comment TROFF INPUT: .BR unihexgen(1),
177 @comment TROFF INPUT: .BR unipagecount(1)
179 @comment TROFF INPUT: .SH AUTHOR
181 @node unipng2hex AUTHOR
182 @subsection unipng2hex AUTHOR
183 @c DEBUG: print_menu("unipng2hex AUTHOR")
185 @comment TROFF INPUT: .B unipng2hex
187 was written by Andrew Miller, starting by converting Paul Hardy's
188 @comment TROFF INPUT: .B unibmp2hex
191 @comment TROFF INPUT: .SH LICENSE
193 @node unipng2hex LICENSE
194 @subsection unipng2hex LICENSE
195 @c DEBUG: print_menu("unipng2hex LICENSE")
197 @comment TROFF INPUT: .B unipng2hex
199 is Copyright @copyright{} 2007, 2008 Paul Hardy, @copyright{} 2013 Andrew Miller.
200 @comment TROFF INPUT: .PP
202 This program is free software; you can redistribute it and/or modify
203 it under the terms of the GNU General Public License as published by
204 the Free Software Foundation; either version 2 of the License, or
205 (at your option) any later version.
206 @comment TROFF INPUT: .SH BUGS
208 @node unipng2hex BUGS
209 @subsection unipng2hex BUGS
210 @c DEBUG: print_menu("unipng2hex BUGS")
212 No known real bugs exist, but the optional pixel rows parameter is not
213 yet supported by all other Unifont utilities. Use of glyphs taller than
214 the default of 16 pixels is considered experimental. Currently
215 @comment TROFF INPUT: .B unihex2png, unipng2hex, hexdraw,
216 @b{unihex2png, unipng2hex, hexdraw,}
218 @comment TROFF INPUT: .B hex2bdf
220 tentatively support glyphs that are 16, 24, and 32 pixels tall.
221 @comment TROFF INPUT: .PP
223 Also, this software does not perform extensive error checking on its
224 input files. If they're not in the format of the original PNG output from
225 @comment TROFF INPUT: .B unihex2png,
228 @comment TROFF INPUT: .PP
230 If the output file is for a "page" containing space code points and the
231 PNG file squares for those code points are not empty,
232 @comment TROFF INPUT: .B unipng2hex
234 preserves the graphics as they are drawn.
235 @comment TROFF INPUT: .PP
237 @comment TROFF INPUT: .B unipng2hex
239 is designed to work with black and white pixels; do not use other