1 @comment TROFF INPUT: .TH UNIFONTPIC 1 "2013 Sep 07"
5 @c DEBUG: print_menu("@section")
9 * unifontpic SYNOPSIS::
10 * unifontpic DESCRIPTION::
11 * unifontpic OPTIONS::
12 * unifontpic EXAMPLES::
14 * unifontpic SEE ALSO::
16 * unifontpic LICENSE::
22 @comment TROFF INPUT: .SH NAME
25 @subsection unifontpic NAME
26 @c DEBUG: print_menu("unifontpic NAME")
28 unifontpic @minus{} Convert GNU Unifont .hex input to a bitmap image of the whole font
29 @comment TROFF INPUT: .SH SYNOPSIS
31 @node unifontpic SYNOPSIS
32 @subsection unifontpic SYNOPSIS
33 @c DEBUG: print_menu("unifontpic SYNOPSIS")
35 @comment TROFF INPUT: .br
37 @comment TROFF INPUT: .B unifontpic
40 @comment TROFF INPUT: .I input-font.hex
43 @comment TROFF INPUT: .I output-font.bmp
45 @comment TROFF INPUT: .SH DESCRIPTION
47 @node unifontpic DESCRIPTION
48 @subsection unifontpic DESCRIPTION
49 @c DEBUG: print_menu("unifontpic DESCRIPTION")
51 @comment TROFF INPUT: .B unifontpic
53 reads a GNU Unifont .hex file from STDIN and writes a two dimensional
54 rendering for each glyph to STDOUT.
55 The output displays the entire Unicode Basic Multilingual Plane (BMP)
56 as one large graphic image, showing a grid of 256 glyphs by 256 glyphs
57 as the default, or (at your option) 16 glyphs across by 4,096 glyphs down.
58 @comment TROFF INPUT: .PP
60 Input can be one or more files in Unifont .hex format. They don't
62 @comment TROFF INPUT: .B unifontpic
64 will populate the entire glyph array of 65,536 code points before
65 writing its output. The input glyph code points should all be
66 unique, as feeding in duplicate code points will produce unpredictable
68 @comment TROFF INPUT: .B unidup (1)
70 on a sorted input of .hex files to guarantee no code point
72 @comment TROFF INPUT: .SH OPTIONS
74 @node unifontpic OPTIONS
75 @subsection unifontpic OPTIONS
76 @c DEBUG: print_menu("unifontpic OPTIONS")
78 @comment TROFF INPUT: .TP 12
80 @c ---------------------------------------------------------------------
83 Specify a Dots per Inch (DPI) resolution of
84 @comment TROFF INPUT: .I nnn.
86 For example, specifying -d120 will encode the bitmap graphics file
87 output as having a resolution of 120 DPI.
88 @comment TROFF INPUT: .TP
91 Produce a long chart, 16 glyphs wide by 4,096 glyphs tall.
92 The default is a wide chart, 256 glyphs wide by 256 glyphs tall.
93 @comment TROFF INPUT: .TP
96 Use tiny numbers for the row and column code point labels. Tiny
97 numbers are on a 4 by 5 pixel grid. Only tiny code point labels
98 appear on the long chart variant; this option only has effect
99 for wide charts (the default, of 256 by 256 glyphs). If this option
100 is not specified for the default 256-by-256 grid, row and column
101 code point labels are taken from Unifont's glyphs for `0' to `9'
103 @comment TROFF INPUT: .SH EXAMPLES
107 @c ---------------------------------------------------------------------
109 @node unifontpic EXAMPLES
110 @subsection unifontpic EXAMPLES
111 @c DEBUG: print_menu("unifontpic EXAMPLES")
114 @comment TROFF INPUT: .PP
116 @comment TROFF INPUT: .RS
118 @c ---------------------------------------------------------------------
120 cat *.hex | unifontpic -d120 > unifontpic.bmp
121 @comment TROFF INPUT: .RE
125 @c ---------------------------------------------------------------------
126 @comment TROFF INPUT: .PP
128 To generate a bitmap that shows combining circles, from the
129 @comment TROFF INPUT: .B font/
132 @comment TROFF INPUT: .PP
134 @comment TROFF INPUT: .RS
136 @c ---------------------------------------------------------------------
138 sort hexsrc/*.hex | unigencircles ttfsrc/combining.txt |
139 unifontpic -d120 >unifontpic.bmp
140 @comment TROFF INPUT: .RE
144 @c ---------------------------------------------------------------------
145 @comment TROFF INPUT: .SH FILES
147 @node unifontpic FILES
148 @subsection unifontpic FILES
149 @c DEBUG: print_menu("unifontpic FILES")
151 *.hex GNU Unifont font files
152 @comment TROFF INPUT: .SH SEE ALSO
154 @node unifontpic SEE ALSO
155 @subsection unifontpic SEE ALSO
156 @c DEBUG: print_menu("unifontpic SEE ALSO")
158 @comment TROFF INPUT: .BR bdfimplode(1),
160 @comment TROFF INPUT: .BR hex2bdf(1),
162 @comment TROFF INPUT: .BR hex2sfd(1),
164 @comment TROFF INPUT: .BR hexbraille(1),
166 @comment TROFF INPUT: .BR hexdraw(1),
168 @comment TROFF INPUT: .BR hexmerge(1),
170 @comment TROFF INPUT: .BR johab2ucs2(1),
172 @comment TROFF INPUT: .BR unibdf2hex(1),
174 @comment TROFF INPUT: .BR unibmp2hex(1),
176 @comment TROFF INPUT: .BR unicoverage(1),
178 @comment TROFF INPUT: .BR unidup(1),
180 @comment TROFF INPUT: .BR unifont(5),
182 @comment TROFF INPUT: .BR unifontchojung(1),
183 @b{unifontchojung(1),}
184 @comment TROFF INPUT: .BR unifontksx(1),
186 @comment TROFF INPUT: .BR unigencircles(1),
187 @b{unigencircles(1),}
188 @comment TROFF INPUT: .BR unigenwidth(1),
190 @comment TROFF INPUT: .BR unihex2bmp(1),
192 @comment TROFF INPUT: .BR unihex2png(1),
194 @comment TROFF INPUT: .BR unihexgen(1),
196 @comment TROFF INPUT: .BR unipagecount(1),
198 @comment TROFF INPUT: .BR unipng2hex(1)
200 @comment TROFF INPUT: .SH AUTHOR
202 @node unifontpic AUTHOR
203 @subsection unifontpic AUTHOR
204 @c DEBUG: print_menu("unifontpic AUTHOR")
206 @comment TROFF INPUT: .B unifontpic
208 was written by Paul Hardy.
209 @comment TROFF INPUT: .SH LICENSE
211 @node unifontpic LICENSE
212 @subsection unifontpic LICENSE
213 @c DEBUG: print_menu("unifontpic LICENSE")
215 @comment TROFF INPUT: .B unifontpic
217 is Copyright @copyright{} 2013 Paul Hardy.
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 unifontpic BUGS
227 @subsection unifontpic BUGS
228 @c DEBUG: print_menu("unifontpic BUGS")