1UNIBMP2HEX(1)               General Commands Manual              UNIBMP2HEX(1)
2
3
4

NAME

6       unibmp2hex - Bitmap graphics file to GNU Unifont .hex file converter
7

SYNOPSIS

9       unibmp2hex [-phexpage] [-iinput_file.bmp] [-ooutput_file.hex] [-w]
10

DESCRIPTION

12       unibmp2hex  reads a bitmap produced by unihex2bmp before or after edit‐
13       ing, and converts it back into a Unifont .hex format file.  The  graph‐
14       ics  file  contains a block of 256 Unicode code points arranged in a 16
15       by 16 grid.  Each code point appears in a 32 by 32 pixel grid.  Charac‐
16       ters are 16 rows high, and 8, 16, or 31 (treated as 32) columns wide.
17

OPTIONS

19       -ppagenum   Specify  that  the  code points will be assigned to the 256
20                   block space pagenum in the .hex file.   If  not  specified,
21                   unibmp2hex  will determine the appropriate block by reading
22                   the row and column headers.  Note  that  "page"  is  not  a
23                   standard  Unicode  term.   It  refers  to  an output bitmap
24                   graphics page of 16 by  16  code  points.   If  pagenum  is
25                   greater  than FF, the block resides above the Unicode Basic
26                   Multilingual Plane. In that event, the .hex file will  con‐
27                   tain  eight  digit  hexadecimal code points rather than the
28                   Unifont standard of four hexadecimal code points.
29
30       -i          Specify the input file. The default is STDIN.
31
32       -o          Specify the output file. The default is STDOUT.
33
34       -w          Force all output .hex glyphs to be 16  pixels  wide  rather
35                   than dual width (8 or 16 pixels).
36
37       Sample usage:
38
39              unibmp2hex -imy_input_file.bmp -omy_output_file.hex
40

FILES

42       *.bmp or *.wbmp graphics files
43

SEE ALSO

45       bdfimplode(1),   hex2bdf(1),   hex2sfd(1),  hexbraille(1),  hexdraw(1),
46       hexkinya(1), hexmerge(1), johab2ucs2(1), unibdf2hex(1), unicoverage(1),
47       unidup(1),  unifont(5),  unifont-viewer(1), unifont1per(1), unifontcho‐
48       jung(1),  unifontksx(1),   unifontpic(1),   unigencircles(1),   unigen‐
49       width(1),  unihex2bmp(1),  unihex2png(1),  unihexfill(1), unihexgen(1),
50       unipagecount(1), unipng2hex(1)
51

AUTHOR

53       unibmp2hex was written by Paul Hardy.
54

LICENSE

56       unibmp2hex is Copyright © 2007, 2008 Paul Hardy.
57
58       This program is free software; you can redistribute it and/or modify it
59       under  the  terms of the GNU General Public License as published by the
60       Free Software Foundation; either version 2 of the License, or (at  your
61       option) any later version.
62

BUGS

64       No  known  real  bugs exist, except that this software does not perform
65       extensive error checking on its input files.  If  they're  not  in  the
66       format  of  the original bitmapped output from unihex2bmp, all bets are
67       off.
68
69       If the output file is for a "page" containing space code points and the
70       bitmap  file  squares  for  those code points are not empty, unibmp2hex
71       preserves the graphics as they are drawn.
72
73
74
75                                  2007 Dec 31                    UNIBMP2HEX(1)