man/unibmp2hex.1

   1 .TH UNIBMP2HEX 1 "2007 Dec 31"
   2 .SH NAME
   3 unibmp2hex \- Bitmap graphics file to GNU Unifont .hex file converter
   4 .SH SYNOPSIS
   5 .br
   6 .B unibmp2hex
   7 [-phexpage] [-iinput_file.bmp] [-ooutput_file.hex] [-w]
   8 .SH DESCRIPTION
   9 .B unibmp2hex
  10 reads a bitmap produced by
  11 .B unihex2bmp
  12 before or after editing, and converts it back into a Unifont .hex format
  13 file.  The graphics file contains a block of 256 Unicode code points
  14 arranged in a 16 by 16 grid.  Each code point appears in a 32 by 32
  15 pixel grid.  Characters are either 16 rows high by 8 columns, or 16 rows by
  16 16 columns.
  17 .PP
  18 .SH OPTIONS
  19 .TP 12
  20 -ppagenum
  21 Specify that the code points will be assigned to the 256 block space
  22 .I pagenum
  23 in the .hex file.  If not specified,
  24 .B unibmp2hex
  25 will determine the appropriate block by reading the row and column
  26 headers.  Note that "page" is not a standard
  27 Unicode term.  It refers to an output bitmap graphics page of
  28 16 by 16 code points.
  29 If
  30 .I pagenum
  31 is greater than FF, the block resides above the Unicode Basic
  32 Multilingual Plane. In that event, the .hex file will contain
  33 eight digit hexadecimal code points rather than the Unifont
  34 standard of four hexadecimal code points.
  35 .TP
  36 -i
  37 Specify the input file. The default is STDIN.
  38 .TP
  39 -o
  40 Specify the output file. The default is STDOUT.
  41 .TP
  42 -w
  43 Force all output .hex glyphs to be 16 pixels wide rather than dual
  44 width (8 or 16 pixels).
  45 .PP
  46 Sample usage:
  47 .PP
  48 .RS
  49 unibmp2hex -imy_input_file.bmp -omy_output_file.hex
  50 .RE
  51 .SH FILES
  52 *.bmp or *.wbmp graphics files
  53 .SH SEE ALSO
  54 .BR bdfimplode(1),
  55 .BR hex2bdf(1),
  56 .BR hex2sfd(1),
  57 .BR hexbraille(1),
  58 .BR hexdraw(1),
  59 .BR hexkinya(1),
  60 .BR hexmerge(1),
  61 .BR johab2ucs2(1),
  62 .BR unibdf2hex(1),
  63 .BR unicoverage(1),
  64 .BR unidup(1),
  65 .BR unifont(5),
  66 .BR unifont-viewer(1),
  67 .BR unifontchojung(1),
  68 .BR unifontksx(1),
  69 .BR unifontpic(1),
  70 .BR unigencircles(1),
  71 .BR unigenwidth(1),
  72 .BR unihex2bmp(1),
  73 .BR unihex2png(1),
  74 .BR unihexfill(1),
  75 .BR unihexgen(1),
  76 .BR unipagecount(1),
  77 .BR unipng2hex(1)
  78 .SH AUTHOR
  79 .B unibmp2hex
  80 was written by Paul Hardy.
  81 .SH LICENSE
  82 .B unibmp2hex
  83 is Copyright \(co 2007, 2008 Paul Hardy.
  84 .PP
  85 This program is free software; you can redistribute it and/or modify
  86 it under the terms of the GNU General Public License as published by
  87 the Free Software Foundation; either version 2 of the License, or
  88 (at your option) any later version.
  89 .SH BUGS
  90 No known real bugs exist, except that this software does not perform
  91 extensive error checking on its input files.  If they're not in the
  92 format of the original bitmapped output from
  93 .B unihex2bmp,
  94 all bets are off.
  95 .PP
  96 If the output file is for a "page" containing space code points and the
  97 bitmap file squares for those code points are not empty,
  98 .B unibmp2hex
  99 preserves the graphics as they are drawn.