man/unipng2hex.1

   1 .TH UNIPNG2HEX 1 "2013 Nov 09"
   2 .SH NAME
   3 unipng2hex \- Portable Network Graphics to GNU Unifont .hex file converter
   4 .SH SYNOPSIS
   5 .br
   6 .B unipng2hex
   7 -i
   8 .I input_file.png
   9 [-o
  10 .I output_file.hex
  11 ] [-w
  12 .I width
  13 ]
  14 .SH DESCRIPTION
  15 .B unipng2hex
  16 reads a PNG file produced by
  17 .B unihex2png
  18 before or after editing, and converts it back into a Unifont .hex format
  19 file.  The PNG file contains a block of 256 Unicode code points
  20 arranged in a 16 by 16 grid.  Each code point appears in a 32 by 32 or a 40
  21 by 40 pixel grid.  Characters are either 16, 24 or 32 pixel rows high,
  22 depending on the "-r" parameter specified by
  23 .B unihex2png.
  24 They can be 8, 16, 24, or 32 pixel columns wide (widths of 32 are only
  25 supported for 32 pixel row tall characters).
  26 .SH OPTIONS
  27 .TP 12
  28 -i
  29 Specify the input file.
  30 .TP
  31 -o
  32 Specify the output file.  If omitted, a file in the Unifont .hex format
  33 is written to STDOUT.
  34 .TP
  35 -w width
  36 Specify the minimum width of the output glyphs.  Valid values are 16, 24,
  37  and 32.  The default is no minimum width.
  38 .TP
  39 -h
  40 Print a help message of options and exit.
  41 .SH EXAMPLE
  42 Sample usage:
  43 .PP
  44 .RS
  45 unipng2hex -i my_input_file.png -o my_output_file.hex
  46 .RE
  47 .SH FILES
  48 *.png graphics files
  49 .SH SEE ALSO
  50 .BR bdfimplode(1),
  51 .BR hex2bdf(1),
  52 .BR hex2sfd(1),
  53 .BR hexbraille(1),
  54 .BR hexdraw(1),
  55 .BR hexkinya(1),
  56 .BR hexmerge(1),
  57 .BR johab2ucs2(1),
  58 .BR unibdf2hex(1),
  59 .BR unibmp2hex(1),
  60 .BR unicoverage(1),
  61 .BR unidup(1),
  62 .BR unifont(5),
  63 .BR unifont-viewer(1),
  64 .BR unifontchojung(1),
  65 .BR unifontksx(1),
  66 .BR unifontpic(1),
  67 .BR unigencircles(1),
  68 .BR unigenwidth(1),
  69 .BR unihex2bmp(1),
  70 .BR unihex2png(1),
  71 .BR unihexfill(1),
  72 .BR unihexgen(1),
  73 .BR unipagecount(1)
  74 .SH AUTHOR
  75 .B unipng2hex
  76 was written by Andrew Miller, starting by converting Paul Hardy's
  77 .B unibmp2hex
  78 C program to Perl.
  79 .SH LICENSE
  80 .B unipng2hex
  81 is Copyright \(co 2007, 2008 Paul Hardy, \(co 2013 Andrew Miller.
  82 .PP
  83 This program is free software; you can redistribute it and/or modify
  84 it under the terms of the GNU General Public License as published by
  85 the Free Software Foundation; either version 2 of the License, or
  86 (at your option) any later version.
  87 .SH BUGS
  88 No known real bugs exist, but the optional pixel rows parameter is not
  89 yet supported by all other Unifont utilities.  Use of glyphs taller than
  90 the default of 16 pixels is considered experimental.  Currently
  91 .B unihex2png, unipng2hex, hexdraw,
  92 and
  93 .B hex2bdf
  94 tentatively support glyphs that are 16, 24, and 32 pixels tall.
  95 .PP
  96 Also, this software does not perform extensive error checking on its
  97 input files.  If they're not in the format of the original PNG output from
  98 .B unihex2png,
  99 all bets are off.
 100 .PP
 101 If the output file is for a "page" containing space code points and the
 102 PNG file squares for those code points are not empty,
 103 .B unipng2hex
 104 preserves the graphics as they are drawn.
 105 .PP
 106 .B unipng2hex
 107 is designed to work with black and white pixels; do not use other
 108 colors.