doc/unihex2bmp.texi

   1 @comment TROFF INPUT: .TH UNIHEX2BMP 1 "2007 Dec 31"
   2
   3 @node unihex2bmp
   4 @section unihex2bmp
   5 @c DEBUG: print_menu("@section")
   6
   7 @menu
   8 * unihex2bmp NAME::
   9 * unihex2bmp SYNOPSIS::
  10 * unihex2bmp DESCRIPTION::
  11 * unihex2bmp OPTIONS::
  12 * unihex2bmp FILES::
  13 * unihex2bmp SEE ALSO::
  14 * unihex2bmp AUTHOR::
  15 * unihex2bmp LICENSE::
  16 * unihex2bmp BUGS::
  17
  18 @end menu
  19
  20
  21 @comment TROFF INPUT: .SH NAME
  22
  23 @node unihex2bmp NAME
  24 @subsection unihex2bmp NAME
  25 @c DEBUG: print_menu("unihex2bmp NAME")
  26
  27 unihex2bmp @minus{} GNU Unifont .hex file to bitmap graphics file converter
  28 @comment TROFF INPUT: .SH SYNOPSIS
  29
  30 @node unihex2bmp SYNOPSIS
  31 @subsection unihex2bmp SYNOPSIS
  32 @c DEBUG: print_menu("unihex2bmp SYNOPSIS")
  33
  34 @comment TROFF INPUT: .br
  35 @comment .br
  36 @comment TROFF INPUT: .B unihex2bmp
  37 @b{unihex2bmp}
  38 [-phexpage] [-iinput@t{_}file.hex] [-ooutput@t{_}file.bmp] [-f] [-w]
  39 @comment TROFF INPUT: .SH DESCRIPTION
  40
  41 @node unihex2bmp DESCRIPTION
  42 @subsection unihex2bmp DESCRIPTION
  43 @c DEBUG: print_menu("unihex2bmp DESCRIPTION")
  44
  45 @comment TROFF INPUT: .B unihex2bmp
  46 @b{unihex2bmp}
  47 reads a GNU Unifont .hex file Unicode page of 256 code points
  48 and converts the page into a Microsoft Windows Bitmap (.bmp) or
  49 Wireless Bitmap (.wbmp) file.  The bitmap file displays the glyphs
  50 of a Unicode block of 256 code points in a 32 by 32 pixel grid.
  51 The glyphs themselves must be 16 rows high, and either 8 columns or
  52 16 columns wide. The default page is 0; that is, the range
  53 U+0000 through U+00FF.
  54 @comment TROFF INPUT: .PP
  55
  56 The bitmap can be printed.  It can also be edited with a bitmap editor.
  57 An edited bitmap can then be re-converted into a GNU Unifont .hex file
  58 with the
  59 @comment TROFF INPUT: .B unibmp2hex
  60 @b{unibmp2hex}
  61 command.
  62 @comment TROFF INPUT: .SH OPTIONS
  63
  64 @node unihex2bmp OPTIONS
  65 @subsection unihex2bmp OPTIONS
  66 @c DEBUG: print_menu("unihex2bmp OPTIONS")
  67
  68 @comment TROFF INPUT: .TP 12
  69
  70 @c ---------------------------------------------------------------------
  71 @table @code
  72 @item -ppagenum
  73 Extract page
  74 @comment TROFF INPUT: .I pagenum
  75 @i{pagenum}
  76 from the .hex file.  The default is Page 0 (Unicode range
  77 U+0000 through U+00FF).  Note that "page" is not a standard
  78 Unicode term.  It refers to an output bitmap graphics page of
  79 16 by 16 code points.
  80 @comment TROFF INPUT: .TP
  81
  82 @item -i
  83 Specify the input file. The default is STDIN.
  84 @comment TROFF INPUT: .TP
  85
  86 @item -o
  87 Specify the output file. The default is STDOUT.
  88 @comment TROFF INPUT: .TP
  89
  90 @item -f
  91 "Flip" (transpose) the grid so it matches the Unicode standard order.
  92 @comment TROFF INPUT: .TP
  93
  94 @item -w
  95 Produce a Wireless Bitmap format file instead of a Microsoft Windows
  96 Bitmap file.
  97 @comment TROFF INPUT: .PP
  98
  99 Sample usage:
 100 @comment TROFF INPUT: .PP
 101
 102 @comment TROFF INPUT: .RS
 103
 104 @c ---------------------------------------------------------------------
 105 @quotation
 106 unihex2bmp -imy@t{_}input@t{_}file.hex -omy@t{_}output@t{_}file.bmp
 107 @comment TROFF INPUT: .RE
 108
 109 @end quotation
 110
 111 @c ---------------------------------------------------------------------
 112 @comment TROFF INPUT: .SH FILES
 113
 114 @end table
 115
 116 @c ---------------------------------------------------------------------
 117
 118 @node unihex2bmp FILES
 119 @subsection unihex2bmp FILES
 120 @c DEBUG: print_menu("unihex2bmp FILES")
 121
 122 *.hex GNU Unifont font files
 123 @comment TROFF INPUT: .SH SEE ALSO
 124
 125 @node unihex2bmp SEE ALSO
 126 @subsection unihex2bmp SEE ALSO
 127 @c DEBUG: print_menu("unihex2bmp SEE ALSO")
 128
 129 @comment TROFF INPUT: .BR bdfimplode(1),
 130 @b{bdfimplode(1),}
 131 @comment TROFF INPUT: .BR hex2bdf(1),
 132 @b{hex2bdf(1),}
 133 @comment TROFF INPUT: .BR hex2sfd(1),
 134 @b{hex2sfd(1),}
 135 @comment TROFF INPUT: .BR hexbraille(1),
 136 @b{hexbraille(1),}
 137 @comment TROFF INPUT: .BR hexdraw(1),
 138 @b{hexdraw(1),}
 139 @comment TROFF INPUT: .BR hexkinya(1),
 140 @b{hexkinya(1),}
 141 @comment TROFF INPUT: .BR hexmerge(1),
 142 @b{hexmerge(1),}
 143 @comment TROFF INPUT: .BR johab2ucs2(1),
 144 @b{johab2ucs2(1),}
 145 @comment TROFF INPUT: .BR unibdf2hex(1),
 146 @b{unibdf2hex(1),}
 147 @comment TROFF INPUT: .BR unibmp2hex(1),
 148 @b{unibmp2hex(1),}
 149 @comment TROFF INPUT: .BR unicoverage(1),
 150 @b{unicoverage(1),}
 151 @comment TROFF INPUT: .BR unidup(1),
 152 @b{unidup(1),}
 153 @comment TROFF INPUT: .BR unifont(5),
 154 @b{unifont(5),}
 155 @comment TROFF INPUT: .BR unifont-viewer(1),
 156 @b{unifont-viewer(1),}
 157 @comment TROFF INPUT: .BR unifontchojung(1),
 158 @b{unifontchojung(1),}
 159 @comment TROFF INPUT: .BR unifontksx(1),
 160 @b{unifontksx(1),}
 161 @comment TROFF INPUT: .BR unifontpic(1),
 162 @b{unifontpic(1),}
 163 @comment TROFF INPUT: .BR unigencircles(1),
 164 @b{unigencircles(1),}
 165 @comment TROFF INPUT: .BR unigenwidth(1),
 166 @b{unigenwidth(1),}
 167 @comment TROFF INPUT: .BR unihex2png(1),
 168 @b{unihex2png(1),}
 169 @comment TROFF INPUT: .BR unihexfill(1),
 170 @b{unihexfill(1),}
 171 @comment TROFF INPUT: .BR unihexgen(1),
 172 @b{unihexgen(1),}
 173 @comment TROFF INPUT: .BR unipagecount(1),
 174 @b{unipagecount(1),}
 175 @comment TROFF INPUT: .BR unipng2hex(1)
 176 @b{unipng2hex(1)}
 177 @comment TROFF INPUT: .SH AUTHOR
 178
 179 @node unihex2bmp AUTHOR
 180 @subsection unihex2bmp AUTHOR
 181 @c DEBUG: print_menu("unihex2bmp AUTHOR")
 182
 183 @comment TROFF INPUT: .B unihex2bmp
 184 @b{unihex2bmp}
 185 was written by Paul Hardy.
 186 @comment TROFF INPUT: .SH LICENSE
 187
 188 @node unihex2bmp LICENSE
 189 @subsection unihex2bmp LICENSE
 190 @c DEBUG: print_menu("unihex2bmp LICENSE")
 191
 192 @comment TROFF INPUT: .B unihex2bmp
 193 @b{unihex2bmp}
 194 is Copyright @copyright{} 2007 Paul Hardy.
 195 @comment TROFF INPUT: .PP
 196
 197 This program is free software; you can redistribute it and/or modify
 198 it under the terms of the GNU General Public License as published by
 199 the Free Software Foundation; either version 2 of the License, or
 200 (at your option) any later version.
 201 @comment TROFF INPUT: .SH BUGS
 202
 203 @node unihex2bmp BUGS
 204 @subsection unihex2bmp BUGS
 205 @c DEBUG: print_menu("unihex2bmp BUGS")
 206
 207 No known real bugs exist, except that this software does not perform
 208 extensive error checking on its input files.  If they're not in the
 209 format of the original GNU Unifont .hex file, all bets are off.
 210 Lines can be terminated either with line feed, or
 211 carriage return plus line feed.