1 @comment TROFF INPUT: .TH UNIBMP2HEX 1 "2007 Dec 31"
5 @c DEBUG: print_menu("@section")
9 * unibmp2hex SYNOPSIS::
10 * unibmp2hex DESCRIPTION::
11 * unibmp2hex OPTIONS::
13 * unibmp2hex SEE ALSO::
15 * unibmp2hex LICENSE::
21 @comment TROFF INPUT: .SH NAME
24 @subsection unibmp2hex NAME
25 @c DEBUG: print_menu("unibmp2hex NAME")
27 unibmp2hex @minus{} Bitmap graphics file to GNU Unifont .hex file converter
28 @comment TROFF INPUT: .SH SYNOPSIS
30 @node unibmp2hex SYNOPSIS
31 @subsection unibmp2hex SYNOPSIS
32 @c DEBUG: print_menu("unibmp2hex SYNOPSIS")
34 @comment TROFF INPUT: .br
36 @comment TROFF INPUT: .B unibmp2hex
38 [-phexpage] [-iinput@t{_}file.bmp] [-ooutput@t{_}file.hex] [-w]
39 @comment TROFF INPUT: .SH DESCRIPTION
41 @node unibmp2hex DESCRIPTION
42 @subsection unibmp2hex DESCRIPTION
43 @c DEBUG: print_menu("unibmp2hex DESCRIPTION")
45 @comment TROFF INPUT: .B unibmp2hex
47 reads a bitmap produced by
48 @comment TROFF INPUT: .B unihex2bmp
50 before or after editing, and converts it back into a Unifont .hex format
51 file. The graphics file contains a block of 256 Unicode code points
52 arranged in a 16 by 16 grid. Each code point appears in a 32 by 32
53 pixel grid. Characters are either 16 rows high by 8 columns, or 16 rows by
55 @comment TROFF INPUT: .PP
57 @comment TROFF INPUT: .SH OPTIONS
59 @node unibmp2hex OPTIONS
60 @subsection unibmp2hex OPTIONS
61 @c DEBUG: print_menu("unibmp2hex OPTIONS")
63 @comment TROFF INPUT: .TP 12
65 @c ---------------------------------------------------------------------
68 Specify that the code points will be assigned to the 256 block space
69 @comment TROFF INPUT: .I pagenum
71 in the .hex file. If not specified,
72 @comment TROFF INPUT: .B unibmp2hex
74 will determine the appropriate block by reading the row and column
75 headers. Note that "page" is not a standard
76 Unicode term. It refers to an output bitmap graphics page of
79 @comment TROFF INPUT: .I pagenum
81 is greater than FF, the block resides above the Unicode Basic
82 Multilingual Plane. In that event, the .hex file will contain
83 eight digit hexadecimal code points rather than the Unifont
84 standard of four hexadecimal code points.
85 @comment TROFF INPUT: .TP
88 Specify the input file. The default is STDIN.
89 @comment TROFF INPUT: .TP
92 Specify the output file. The default is STDOUT.
93 @comment TROFF INPUT: .TP
96 Force all output .hex glyphs to be 16 pixels wide rather than dual
97 width (8 or 16 pixels).
98 @comment TROFF INPUT: .PP
101 @comment TROFF INPUT: .PP
103 @comment TROFF INPUT: .RS
105 @c ---------------------------------------------------------------------
107 unibmp2hex -imy@t{_}input@t{_}file.bmp -omy@t{_}output@t{_}file.hex
108 @comment TROFF INPUT: .RE
112 @c ---------------------------------------------------------------------
113 @comment TROFF INPUT: .SH FILES
117 @c ---------------------------------------------------------------------
119 @node unibmp2hex FILES
120 @subsection unibmp2hex FILES
121 @c DEBUG: print_menu("unibmp2hex FILES")
123 *.bmp or *.wbmp graphics files
124 @comment TROFF INPUT: .SH SEE ALSO
126 @node unibmp2hex SEE ALSO
127 @subsection unibmp2hex SEE ALSO
128 @c DEBUG: print_menu("unibmp2hex SEE ALSO")
130 @comment TROFF INPUT: .BR bdfimplode(1),
132 @comment TROFF INPUT: .BR hex2bdf(1),
134 @comment TROFF INPUT: .BR hex2sfd(1),
136 @comment TROFF INPUT: .BR hexbraille(1),
138 @comment TROFF INPUT: .BR hexdraw(1),
140 @comment TROFF INPUT: .BR hexkinya(1),
142 @comment TROFF INPUT: .BR hexmerge(1),
144 @comment TROFF INPUT: .BR johab2ucs2(1),
146 @comment TROFF INPUT: .BR unibdf2hex(1),
148 @comment TROFF INPUT: .BR unicoverage(1),
150 @comment TROFF INPUT: .BR unidup(1),
152 @comment TROFF INPUT: .BR unifont(5),
154 @comment TROFF INPUT: .BR unifont-viewer(1),
155 @b{unifont-viewer(1),}
156 @comment TROFF INPUT: .BR unifontchojung(1),
157 @b{unifontchojung(1),}
158 @comment TROFF INPUT: .BR unifontksx(1),
160 @comment TROFF INPUT: .BR unifontpic(1),
162 @comment TROFF INPUT: .BR unigencircles(1),
163 @b{unigencircles(1),}
164 @comment TROFF INPUT: .BR unigenwidth(1),
166 @comment TROFF INPUT: .BR unihex2bmp(1),
168 @comment TROFF INPUT: .BR unihex2png(1),
170 @comment TROFF INPUT: .BR unihexfill(1),
172 @comment TROFF INPUT: .BR unihexgen(1),
174 @comment TROFF INPUT: .BR unipagecount(1),
176 @comment TROFF INPUT: .BR unipng2hex(1)
178 @comment TROFF INPUT: .SH AUTHOR
180 @node unibmp2hex AUTHOR
181 @subsection unibmp2hex AUTHOR
182 @c DEBUG: print_menu("unibmp2hex AUTHOR")
184 @comment TROFF INPUT: .B unibmp2hex
186 was written by Paul Hardy.
187 @comment TROFF INPUT: .SH LICENSE
189 @node unibmp2hex LICENSE
190 @subsection unibmp2hex LICENSE
191 @c DEBUG: print_menu("unibmp2hex LICENSE")
193 @comment TROFF INPUT: .B unibmp2hex
195 is Copyright @copyright{} 2007, 2008 Paul Hardy.
196 @comment TROFF INPUT: .PP
198 This program is free software; you can redistribute it and/or modify
199 it under the terms of the GNU General Public License as published by
200 the Free Software Foundation; either version 2 of the License, or
201 (at your option) any later version.
202 @comment TROFF INPUT: .SH BUGS
204 @node unibmp2hex BUGS
205 @subsection unibmp2hex BUGS
206 @c DEBUG: print_menu("unibmp2hex BUGS")
208 No known real bugs exist, except that this software does not perform
209 extensive error checking on its input files. If they're not in the
210 format of the original bitmapped output from
211 @comment TROFF INPUT: .B unihex2bmp,
214 @comment TROFF INPUT: .PP
216 If the output file is for a "page" containing space code points and the
217 bitmap file squares for those code points are not empty,
218 @comment TROFF INPUT: .B unibmp2hex
220 preserves the graphics as they are drawn.