@comment TROFF INPUT: .TH UNIHEX2BMP 1 "2007 Dec 31"

@node unihex2bmp
@section unihex2bmp
@c DEBUG: print_menu("@section")

@menu
* unihex2bmp NAME::
* unihex2bmp SYNOPSIS::
* unihex2bmp DESCRIPTION::
* unihex2bmp OPTIONS::
* unihex2bmp EXAMPLE::
* unihex2bmp FILES::
* unihex2bmp SEE ALSO::
* unihex2bmp AUTHOR::
* unihex2bmp LICENSE::
* unihex2bmp BUGS::

@end menu


@comment TROFF INPUT: .SH NAME

@node unihex2bmp NAME
@subsection unihex2bmp NAME
@c DEBUG: print_menu("unihex2bmp NAME")

unihex2bmp @minus{} GNU Unifont .hex file to bitmap graphics file converter
@comment TROFF INPUT: .SH SYNOPSIS

@node unihex2bmp SYNOPSIS
@subsection unihex2bmp SYNOPSIS
@c DEBUG: print_menu("unihex2bmp SYNOPSIS")

@b{unihex2bmp }[@minus{}p@i{hexpage}] [@minus{}i@i{input@t{_}file.hex}] [@minus{}o@i{output@t{_}file.bmp}] [@minus{}f] [@minus{}w]
@comment TROFF INPUT: .SH DESCRIPTION

@node unihex2bmp DESCRIPTION
@subsection unihex2bmp DESCRIPTION
@c DEBUG: print_menu("unihex2bmp DESCRIPTION")

@comment TROFF INPUT: .B unihex2bmp
@b{unihex2bmp}
reads a GNU Unifont .hex file Unicode page of 256 code points
and converts the page into a Microsoft Windows Bitmap (.bmp) or
Wireless Bitmap (.wbmp) file.  The bitmap file displays the glyphs
of a Unicode block of 256 code points in a 32 by 32 pixel grid.
The glyphs themselves must be 16 rows high, and 8, 16, 24, or 31
(encoded as 32) columns wide. The default page is 0; that is, the
range U+0000 through U+00FF.
@comment TROFF INPUT: .PP

The bitmap can be printed.  It can also be edited with a bitmap editor.
An edited bitmap can then be re-converted into a GNU Unifont .hex file
with the
@comment TROFF INPUT: .B unibmp2hex
@b{unibmp2hex}
command.
@comment TROFF INPUT: .SH OPTIONS

@node unihex2bmp OPTIONS
@subsection unihex2bmp OPTIONS
@c DEBUG: print_menu("unihex2bmp OPTIONS")

@comment TROFF INPUT: .TP 6
@comment TROFF INPUT: .BR \-p

@c ---------------------------------------------------------------------
@table @code
@item @b{@minus{}p}
Extract page
@comment TROFF INPUT: .I hexpage
@i{hexpage}
from the .hex file.  The default is Page 0 (Unicode range
U+0000 through U+00FF).  Note that "page" is not a standard
Unicode term.  It refers to an output bitmap graphics page of
16 by 16 code points.
@comment TROFF INPUT: .TP
@comment TROFF INPUT: .BR \-i

@item @b{@minus{}i}
Specify the input file. The default is STDIN.
@comment TROFF INPUT: .TP
@comment TROFF INPUT: .BR \-o

@item @b{@minus{}o}
Specify the output file. The default is STDOUT.
@comment TROFF INPUT: .TP
@comment TROFF INPUT: .BR \-f

@item @b{@minus{}f}
"Flip" (transpose) the grid, swapping rows and columns
from the Unicode standard orientation.
@comment TROFF INPUT: .TP
@comment TROFF INPUT: .BR \-w

@item @b{@minus{}w}
Produce a Wireless Bitmap format file instead of a Microsoft Windows
Bitmap file.
@comment TROFF INPUT: .SH EXAMPLE

@end table

@c ---------------------------------------------------------------------

@node unihex2bmp EXAMPLE
@subsection unihex2bmp EXAMPLE
@c DEBUG: print_menu("unihex2bmp EXAMPLE")

Sample usage:
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
unihex2bmp @minus{}imy@t{_}input@t{_}file.hex @minus{}omy@t{_}output@t{_}file.bmp
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .SH FILES

@node unihex2bmp FILES
@subsection unihex2bmp FILES
@c DEBUG: print_menu("unihex2bmp FILES")

*.hex GNU Unifont font files
@comment TROFF INPUT: .SH SEE ALSO

@node unihex2bmp SEE ALSO
@subsection unihex2bmp SEE ALSO
@c DEBUG: print_menu("unihex2bmp SEE ALSO")

@comment TROFF INPUT: .BR bdfimplode (1),
@b{bdfimplode}@r{(1),}
@comment TROFF INPUT: .BR hex2bdf (1),
@b{hex2bdf}@r{(1),}
@comment TROFF INPUT: .BR hex2otf (1),
@b{hex2otf}@r{(1),}
@comment TROFF INPUT: .BR hex2sfd (1),
@b{hex2sfd}@r{(1),}
@comment TROFF INPUT: .BR hexbraille (1),
@b{hexbraille}@r{(1),}
@comment TROFF INPUT: .BR hexdraw (1),
@b{hexdraw}@r{(1),}
@comment TROFF INPUT: .BR hexkinya (1),
@b{hexkinya}@r{(1),}
@comment TROFF INPUT: .BR hexmerge (1),
@b{hexmerge}@r{(1),}
@comment TROFF INPUT: .BR johab2syllables (1),
@b{johab2syllables}@r{(1),}
@comment TROFF INPUT: .BR johab2ucs2 (1),
@b{johab2ucs2}@r{(1),}
@comment TROFF INPUT: .BR unibdf2hex (1),
@b{unibdf2hex}@r{(1),}
@comment TROFF INPUT: .BR unibmp2hex (1),
@b{unibmp2hex}@r{(1),}
@comment TROFF INPUT: .BR unibmpbump (1),
@b{unibmpbump}@r{(1),}
@comment TROFF INPUT: .BR unicoverage (1),
@b{unicoverage}@r{(1),}
@comment TROFF INPUT: .BR unidup (1),
@b{unidup}@r{(1),}
@comment TROFF INPUT: .BR unifont (5),
@b{unifont}@r{(5),}
@comment TROFF INPUT: .BR unifont-viewer (1),
@b{unifont-viewer}@r{(1),}
@comment TROFF INPUT: .BR unifont1per (1),
@b{unifont1per}@r{(1),}
@comment TROFF INPUT: .BR unifontchojung (1),
@b{unifontchojung}@r{(1),}
@comment TROFF INPUT: .BR unifontksx (1),
@b{unifontksx}@r{(1),}
@comment TROFF INPUT: .BR unifontpic (1),
@b{unifontpic}@r{(1),}
@comment TROFF INPUT: .BR unigen-hangul (1),
@b{unigen-hangul}@r{(1),}
@comment TROFF INPUT: .BR unigencircles (1),
@b{unigencircles}@r{(1),}
@comment TROFF INPUT: .BR unigenwidth (1),
@b{unigenwidth}@r{(1),}
@comment TROFF INPUT: .BR unihex2png (1),
@b{unihex2png}@r{(1),}
@comment TROFF INPUT: .BR unihexfill (1),
@b{unihexfill}@r{(1),}
@comment TROFF INPUT: .BR unihexgen (1),
@b{unihexgen}@r{(1),}
@comment TROFF INPUT: .BR unihexpose (1),
@b{unihexpose}@r{(1),}
@comment TROFF INPUT: .BR unihexrotate (1),
@b{unihexrotate}@r{(1),}
@comment TROFF INPUT: .BR unijohab2html (1),
@b{unijohab2html}@r{(1),}
@comment TROFF INPUT: .BR unipagecount (1),
@b{unipagecount}@r{(1),}
@comment TROFF INPUT: .BR unipng2hex (1)
@b{unipng2hex}@r{(1)}
@comment TROFF INPUT: .SH AUTHOR

@node unihex2bmp AUTHOR
@subsection unihex2bmp AUTHOR
@c DEBUG: print_menu("unihex2bmp AUTHOR")

@comment TROFF INPUT: .B unihex2bmp
@b{unihex2bmp}
was written by Paul Hardy.
@comment TROFF INPUT: .SH LICENSE

@node unihex2bmp LICENSE
@subsection unihex2bmp LICENSE
@c DEBUG: print_menu("unihex2bmp LICENSE")

@comment TROFF INPUT: .B unihex2bmp
@b{unihex2bmp}
is Copyright @copyright{} 2007 Paul Hardy.
@comment TROFF INPUT: .PP

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
@comment TROFF INPUT: .SH BUGS

@node unihex2bmp BUGS
@subsection unihex2bmp BUGS
@c DEBUG: print_menu("unihex2bmp BUGS")

No known real bugs exist, except that this software does not perform
extensive error checking on its input files.  If they're not in the
format of the original GNU Unifont .hex file, all bets are off.
Lines can be terminated either with line feed, or
carriage return plus line feed.
