unifont-7.0.06.tar.gz
[unifont.git] / man / hex2bdf.1
1 .TH HEX2BDF 1 "2008 Jul 06"
2 .SH NAME
3 hex2bdf \- Convert a GNU Unifont .hex file into a BDF font
4 .SH SYNOPSIS
5 .br
6 .B hex2bdf
7 <
8 .I input-font.hex
9 >
10 .I output-font.bdf
11 .SH DESCRIPTION
12 .B hex2bdf
13 reads a sorted GNU Unifont .hex file (sorted with the Unix
14 .B sort
15 utility) from STDIN and writes a BDF version of the font
16 to STDOUT.
17 .SH OPTIONS
18 .TP 12
19 -f "font-name"
20 Specify the target font name.  If omitted, the default
21 font name "Unifont" is assigned.
22 .TP
23 -v "font-version"
24 Specify the target font version.  If omitted, the default
25 version "1.0" is assigned.
26 .TP
27 -c "font-copyright"
28 Specify the target font copyright information.  The default
29 is the null string.
30 .TP
31 -r <pixel-rows> 
32 Specify how many pixel rows tall a glyph is.  The default
33 is the traditional Unifont 16 rows of pixels.  This is an
34 addition to support
35 .B unihex2png(1)
36 and
37 .B unipng2hex(1),
38 which allow designing glyphs that are 16, 24, or 32
39 pixel rows tall.
40 .SH EXAMPLE
41 Sample usage:
42 .PP
43 .RS
44 hex2bdf -f "Unifont" -c "(C) 2013..." unifont.hex > unifont.bdf
45 .RE
46 .SH FILES
47 *.hex GNU Unifont font files
48 .SH SEE ALSO
49 .BR bdfimplode(1),
50 .BR hex2sfd(1),
51 .BR hexbraille(1),
52 .BR hexdraw(1),
53 .BR hexkinya(1),
54 .BR hexmerge(1),
55 .BR johab2ucs2(1),
56 .BR unibdf2hex(1),
57 .BR unibmp2hex(1),
58 .BR unicoverage(1),
59 .BR unidup(1),
60 .BR unifont(5),
61 .BR unifont-viewer(1),
62 .BR unifontchojung(1),
63 .BR unifontksx(1),
64 .BR unifontpic(1),
65 .BR unigencircles(1),
66 .BR unigenwidth(1),
67 .BR unihex2bmp(1),
68 .BR unihex2png(1),
69 .BR unihexfill(1),
70 .BR unihexgen(1),
71 .BR unipagecount(1),
72 .BR unipng2hex(1)
73 .SH AUTHOR
74 .B hex2bdf
75 was written by Roman Czyborra.
76 .SH LICENSE
77 .B hex2bdf
78 is Copyright \(co 1998 Roman Czyborra.
79 .PP
80 This program is free software; you can redistribute it and/or modify
81 it under the terms of the GNU General Public License as published by
82 the Free Software Foundation; either version 2 of the License, or
83 (at your option) any later version.
84 .SH BUGS
85 No known bugs exist.  Support for glyph heights other than 16 pixels is
86 brand new and has not been extensively tested.