UNIBMP2HEX(1)

NAME
unibmp2hex - Bitmap graphics file to GNU Unifont .hex file converter

SYNOPSIS
unibmp2hex [-phexpage] [-iinput_file] [-ooutput_file]

DESCRIPTION
unibmp2hex reads a bitmap produced by unihex2bmp before or after editing, and converts it back into a Unifont .hex format file. The graphics file contains a block of 256 Unicode code points arranged in a 16 by 16 grid. Each code point appears in a 32 by 32 pixel grid. Characters are either 16 rows by 8 columns, or 16 rows by 16 columns.

OPTIONS

-ppagenum
    Specify that the code points will be assigned to the 256 block space pagenum in the .hex file. If not specified, unibmp2hex will determine the appropriate block by reading the row and column headers. Note that "page" is not a standard Unicode term. It refers to an output bitmap graphics page of 16 by 16 code points. If pagenum is greater than FF, the block resides above the Unicode Basic Multilingual Plane. In that event, the .hex file will contain eight digit hexadecimal code points rather than the Unifont standard of four hexadecimal code points.

-i  Specify the input file. The default is stdin.

-o  Specify the output file. The default is stdout.

FILES

*.bmp or *.wbmp graphics files

SEE ALSO
unihex2bmp(1), unipagecount(1), unidup(1), unihex2bdf(1), uniunmask(1)

AUTHOR
unibmp2hex is Copyright (C) 2007 Paul Hardy, and is released under version 3 of the GNU General Public License.

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 bitmapped output from unihex2bmp, all bets are off.

Note that this program hard-codes 0x0020 and 0x00A0 as a hex entry of 32 zeroes. In other words, the space character is always converted this way, whether or not there is a glyph in the respective cell for the range U+0000 through U+00FF. This is a feature, not a bug.