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 unihexgen(1),
 170 @b{unihexgen(1),}
 171 @comment TROFF INPUT: .BR unipagecount(1),
 172 @b{unipagecount(1),}
 173 @comment TROFF INPUT: .BR unipng2hex(1)
 174 @b{unipng2hex(1)}
 175 @comment TROFF INPUT: .SH AUTHOR
 176
 177 @node unihex2bmp AUTHOR
 178 @subsection unihex2bmp AUTHOR
 179 @c DEBUG: print_menu("unihex2bmp AUTHOR")
 180
 181 @comment TROFF INPUT: .B unihex2bmp
 182 @b{unihex2bmp}
 183 was written by Paul Hardy.
 184 @comment TROFF INPUT: .SH LICENSE
 185
 186 @node unihex2bmp LICENSE
 187 @subsection unihex2bmp LICENSE
 188 @c DEBUG: print_menu("unihex2bmp LICENSE")
 189
 190 @comment TROFF INPUT: .B unihex2bmp
 191 @b{unihex2bmp}
 192 is Copyright @copyright{} 2007 Paul Hardy.
 193 @comment TROFF INPUT: .PP
 194
 195 This program is free software; you can redistribute it and/or modify
 196 it under the terms of the GNU General Public License as published by
 197 the Free Software Foundation; either version 2 of the License, or
 198 (at your option) any later version.
 199 @comment TROFF INPUT: .SH BUGS
 200
 201 @node unihex2bmp BUGS
 202 @subsection unihex2bmp BUGS
 203 @c DEBUG: print_menu("unihex2bmp BUGS")
 204
 205 No known real bugs exist, except that this software does not perform
 206 extensive error checking on its input files.  If they're not in the
 207 format of the original GNU Unifont .hex file, all bets are off.
 208 Lines can be terminated either with line feed, or
 209 carriage return plus line feed.