347bff46d5b72b535cd7710d8ecb5b7e8296594d
[unifont.git] / man / unihex2bmp.1
1 .TH UNIHEX2BMP 1 "2007 Dec 31"
2 .SH NAME
3 unihex2bmp \- GNU Unifont .hex file to bitmap graphics file converter
4 .SH SYNOPSIS
5 .br
6 .B unihex2bmp
7 [-phexpage] [-iinput_file] [-ooutput_file] [-f] [-w]
8 .SH DESCRIPTION
9 .B unihex2bmp
10 reads a GNU Unifont .hex file Unicode page of 256 code points
11 and converts the page into a Microsoft Windows Bitmap (.bmp) or
12 Wireless Bitmap (.wbmp) file.  The bitmap file displays the glyphs
13 of a Unicode block of 256 code points in a 32 by 32 pixel grid.
14 The glyphs themselves must be 16 rows, and either 8 columns or
15 16 columns wide. The default page is 0; that is, the range
16 U+0000 throught U+00FF.
17 .PP
18 The bitmap can be printed.  It can also be edited with a bitmap editor.
19 An edited bitmap can then be re-converted into a GNU Unifont .hex file
20 with the
21 .B unibmp2hex
22 command.
23 .PP
24 .SH OPTIONS
25 .TP 12
26 -ppagenum
27 Extract page
28 .I pagenum
29 from the .hex file.  The default is Page 0 (Unicode range
30 U+0000 through U+00FF).  Note that "page" is not a standard
31 Unicode term.  It refers to an output bitmap graphics page of
32 16 by 16 code points.
33 .TP
34 -i
35 Specify the input file. The default is stdin.
36 .TP
37 -o
38 Specify the output file. The default is stdout.
39 .TP
40 -f
41 "Flip" (transpose) the grid so it matches the Unicode standard order.
42 .TP
43 -w
44 Produce a Wireless Bitmap format file instead of a Microsoft Windows
45 Bitmap file.
46 .SH FILES
47 .TP 15
48 *.hex GNU Unifont font files
49 .SH SEE ALSO
50 .BR bdfimplode (1),
51 .BR hex2bdf (1),
52 .BR hex2sfd (1),
53 .BR hexbraille (1),
54 .BR hexdraw (1),
55 .BR hexmerge (1),
56 .BR johab2ucs2 (1),
57 .BR unibdf2hex (1),
58 .BR unifontpic (1),
59 .BR unibmp2hex (1),
60 .BR unicoverage (1),
61 .BR unidup (1),
62 .BR unifontchojung (1),
63 .BR unifontksx (1),
64 .BR unigencircles (1),
65 .BR unigenwidth (1),
66 .BR unihexgen (1),
67 .BR unipagecount (1),
68 .BR uniunmask (1)
69 .SH AUTHOR
70 .B unihex2bmp
71 was written by Paul Hardy.
72 .SH LICENSE
73 .B unihex2bmp
74 is Copyright \(co 2007 Paul Hardy, and is released under version 2 of
75 the GNU General Public License, or (at your option) a later version.
76 .SH BUGS
77 No known real bugs exist, except that this software does not perform
78 extensive error checking on its input files.  If they're not in the
79 format of the original GNU Unifont hex file, all bets are off.
80 Lines can be terminated either with carriage return, or
81 carriage return plus line feed.