doc/hex2bdf.texi

   1 @comment TROFF INPUT: .TH HEX2BDF 1 "2008 Jul 06"
   2
   3 @node hex2bdf
   4 @section hex2bdf
   5 @c DEBUG: print_menu("@section")
   6
   7 @menu
   8 * hex2bdf NAME::
   9 * hex2bdf SYNOPSIS::
  10 * hex2bdf DESCRIPTION::
  11 * hex2bdf OPTIONS::
  12 * hex2bdf EXAMPLE::
  13 * hex2bdf FILES::
  14 * hex2bdf SEE ALSO::
  15 * hex2bdf AUTHOR::
  16 * hex2bdf LICENSE::
  17 * hex2bdf BUGS::
  18
  19 @end menu
  20
  21
  22 @comment TROFF INPUT: .SH NAME
  23
  24 @node hex2bdf NAME
  25 @subsection hex2bdf NAME
  26 @c DEBUG: print_menu("hex2bdf NAME")
  27
  28 hex2bdf @minus{} Convert a GNU Unifont .hex file into a BDF font
  29 @comment TROFF INPUT: .SH SYNOPSIS
  30
  31 @node hex2bdf SYNOPSIS
  32 @subsection hex2bdf SYNOPSIS
  33 @c DEBUG: print_menu("hex2bdf SYNOPSIS")
  34
  35 @comment TROFF INPUT: .br
  36 @comment .br
  37 @comment TROFF INPUT: .B hex2bdf
  38 @b{hex2bdf}
  39 <
  40 @comment TROFF INPUT: .I input-font.hex
  41 @i{input-font.hex}
  42 >
  43 @comment TROFF INPUT: .I output-font.bdf
  44 @i{output-font.bdf}
  45 @comment TROFF INPUT: .SH DESCRIPTION
  46
  47 @node hex2bdf DESCRIPTION
  48 @subsection hex2bdf DESCRIPTION
  49 @c DEBUG: print_menu("hex2bdf DESCRIPTION")
  50
  51 @comment TROFF INPUT: .B hex2bdf
  52 @b{hex2bdf}
  53 reads a sorted GNU Unifont .hex file (sorted with the Unix
  54 @comment TROFF INPUT: .B sort
  55 @b{sort}
  56 utility) from STDIN and writes a BDF version of the font
  57 to STDOUT.
  58 @comment TROFF INPUT: .SH OPTIONS
  59
  60 @node hex2bdf OPTIONS
  61 @subsection hex2bdf OPTIONS
  62 @c DEBUG: print_menu("hex2bdf OPTIONS")
  63
  64 @comment TROFF INPUT: .TP 12
  65
  66 @c ---------------------------------------------------------------------
  67 @table @code
  68 @item -f "font-name"
  69 Specify the target font name.  If omitted, the default
  70 font name "Unifont" is assigned.
  71 @comment TROFF INPUT: .TP
  72
  73 @item -v "font-version"
  74 Specify the target font version.  If omitted, the default
  75 version "1.0" is assigned.
  76 @comment TROFF INPUT: .TP
  77
  78 @item -c "font-copyright"
  79 Specify the target font copyright information.  The default
  80 is the null string.
  81 @comment TROFF INPUT: .TP
  82
  83 @item -r <pixel-rows>
  84 Specify how many pixel rows tall a glyph is.  The default
  85 is the traditional Unifont 16 rows of pixels.  This is an
  86 addition to support
  87 @comment TROFF INPUT: .B unihex2png(1)
  88 @b{unihex2png(1)}
  89 and
  90 @comment TROFF INPUT: .B unipng2hex(1),
  91 @b{unipng2hex(1),}
  92 which allow designing glyphs that are 16, 24, or 32
  93 pixel rows tall.
  94 @comment TROFF INPUT: .SH EXAMPLE
  95
  96 @end table
  97
  98 @c ---------------------------------------------------------------------
  99
 100 @node hex2bdf EXAMPLE
 101 @subsection hex2bdf EXAMPLE
 102 @c DEBUG: print_menu("hex2bdf EXAMPLE")
 103
 104 Sample usage:
 105 @comment TROFF INPUT: .PP
 106
 107 @comment TROFF INPUT: .RS
 108
 109 @c ---------------------------------------------------------------------
 110 @quotation
 111 hex2bdf -f "Unifont" -c "(C) 2013..." unifont.hex > unifont.bdf
 112 @comment TROFF INPUT: .RE
 113
 114 @end quotation
 115
 116 @c ---------------------------------------------------------------------
 117 @comment TROFF INPUT: .SH FILES
 118
 119 @node hex2bdf FILES
 120 @subsection hex2bdf FILES
 121 @c DEBUG: print_menu("hex2bdf FILES")
 122
 123 *.hex GNU Unifont font files
 124 @comment TROFF INPUT: .SH SEE ALSO
 125
 126 @node hex2bdf SEE ALSO
 127 @subsection hex2bdf SEE ALSO
 128 @c DEBUG: print_menu("hex2bdf SEE ALSO")
 129
 130 @comment TROFF INPUT: .BR bdfimplode(1),
 131 @b{bdfimplode(1),}
 132 @comment TROFF INPUT: .BR hex2sfd(1),
 133 @b{hex2sfd(1),}
 134 @comment TROFF INPUT: .BR hexbraille(1),
 135 @b{hexbraille(1),}
 136 @comment TROFF INPUT: .BR hexdraw(1),
 137 @b{hexdraw(1),}
 138 @comment TROFF INPUT: .BR hexkinya(1),
 139 @b{hexkinya(1),}
 140 @comment TROFF INPUT: .BR hexmerge(1),
 141 @b{hexmerge(1),}
 142 @comment TROFF INPUT: .BR johab2ucs2(1),
 143 @b{johab2ucs2(1),}
 144 @comment TROFF INPUT: .BR unibdf2hex(1),
 145 @b{unibdf2hex(1),}
 146 @comment TROFF INPUT: .BR unibmp2hex(1),
 147 @b{unibmp2hex(1),}
 148 @comment TROFF INPUT: .BR unicoverage(1),
 149 @b{unicoverage(1),}
 150 @comment TROFF INPUT: .BR unidup(1),
 151 @b{unidup(1),}
 152 @comment TROFF INPUT: .BR unifont(5),
 153 @b{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),
 159 @b{unifontksx(1),}
 160 @comment TROFF INPUT: .BR unifontpic(1),
 161 @b{unifontpic(1),}
 162 @comment TROFF INPUT: .BR unigencircles(1),
 163 @b{unigencircles(1),}
 164 @comment TROFF INPUT: .BR unigenwidth(1),
 165 @b{unigenwidth(1),}
 166 @comment TROFF INPUT: .BR unihex2bmp(1),
 167 @b{unihex2bmp(1),}
 168 @comment TROFF INPUT: .BR unihex2png(1),
 169 @b{unihex2png(1),}
 170 @comment TROFF INPUT: .BR unihexfill(1),
 171 @b{unihexfill(1),}
 172 @comment TROFF INPUT: .BR unihexgen(1),
 173 @b{unihexgen(1),}
 174 @comment TROFF INPUT: .BR unipagecount(1),
 175 @b{unipagecount(1),}
 176 @comment TROFF INPUT: .BR unipng2hex(1)
 177 @b{unipng2hex(1)}
 178 @comment TROFF INPUT: .SH AUTHOR
 179
 180 @node hex2bdf AUTHOR
 181 @subsection hex2bdf AUTHOR
 182 @c DEBUG: print_menu("hex2bdf AUTHOR")
 183
 184 @comment TROFF INPUT: .B hex2bdf
 185 @b{hex2bdf}
 186 was written by Roman Czyborra.
 187 @comment TROFF INPUT: .SH LICENSE
 188
 189 @node hex2bdf LICENSE
 190 @subsection hex2bdf LICENSE
 191 @c DEBUG: print_menu("hex2bdf LICENSE")
 192
 193 @comment TROFF INPUT: .B hex2bdf
 194 @b{hex2bdf}
 195 is Copyright @copyright{} 1998 Roman Czyborra.
 196 @comment TROFF INPUT: .PP
 197
 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
 203
 204 @node hex2bdf BUGS
 205 @subsection hex2bdf BUGS
 206 @c DEBUG: print_menu("hex2bdf BUGS")
 207
 208 No known bugs exist.  Support for glyph heights other than 16 pixels is
 209 brand new and has not been extensively tested.