man/unihex2bmp.1

   1 .TH UNIHEX2BMP 1 "2007 Dec 31"
   2 .SH NAME
   3 unihex2bmp \- GNU Unifont .hex file to bitmap graphics file converter
   4 .SH SYNOPSIS
   5 .br
   6 .B unihex2bmp
   7 [-phexpage] [-iinput_file.hex] [-ooutput_file.bmp] [-f] [-w]
   8 .SH DESCRIPTION
   9 .B unihex2bmp
  10 reads a GNU Unifont .hex file Unicode page of 256 code points
  11 and converts the page into a Microsoft Windows Bitmap (.bmp) or
  12 Wireless Bitmap (.wbmp) file.  The bitmap file displays the glyphs
  13 of a Unicode block of 256 code points in a 32 by 32 pixel grid.
  14 The glyphs themselves must be 16 rows high, and either 8 columns or
  15 16 columns wide. The default page is 0; that is, the range
  16 U+0000 through U+00FF.
  17 .PP
  18 The bitmap can be printed.  It can also be edited with a bitmap editor.
  19 An edited bitmap can then be re-converted into a GNU Unifont .hex file
  20 with the
  21 .B unibmp2hex
  22 command.
  23 .SH OPTIONS
  24 .TP 12
  25 -ppagenum
  26 Extract page
  27 .I pagenum
  28 from the .hex file.  The default is Page 0 (Unicode range
  29 U+0000 through U+00FF).  Note that "page" is not a standard
  30 Unicode term.  It refers to an output bitmap graphics page of
  31 16 by 16 code points.
  32 .TP
  33 -i
  34 Specify the input file. The default is STDIN.
  35 .TP
  36 -o
  37 Specify the output file. The default is STDOUT.
  38 .TP
  39 -f
  40 "Flip" (transpose) the grid so it matches the Unicode standard order.
  41 .TP
  42 -w
  43 Produce a Wireless Bitmap format file instead of a Microsoft Windows
  44 Bitmap file.
  45 .PP
  46 Sample usage:
  47 .PP
  48 .RS
  49 unihex2bmp -imy_input_file.hex -omy_output_file.bmp
  50 .RE
  51 .SH FILES
  52 *.hex GNU Unifont font 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 unibmp2hex(1),
  64 .BR unicoverage(1),
  65 .BR unidup(1),
  66 .BR unifont(5),
  67 .BR unifont-viewer(1),
  68 .BR unifontchojung(1),
  69 .BR unifontksx(1),
  70 .BR unifontpic(1),
  71 .BR unigencircles(1),
  72 .BR unigenwidth(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 unihex2bmp
  80 was written by Paul Hardy.
  81 .SH LICENSE
  82 .B unihex2bmp
  83 is Copyright \(co 2007 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 GNU Unifont .hex file, all bets are off.
  93 Lines can be terminated either with line feed, or
  94 carriage return plus line feed.