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

NAME

6       unihex2png  -  GNU  Unifont .hex file to Portable Network Graphics con‐
7       verter
8

SYNOPSIS

10       unihex2png [-i input_file.hex]  -o  output_file.png  [-p  pagenum]  [-r
11       rows]
12

DESCRIPTION

14       unihex2png  reads  a page of 256 Unicode code points from a GNU Unifont
15       .hex file and converts the page into a Portable Network Graphics  (PNG)
16       file.   The graphics file displays the glyphs of a Unicode block of 256
17       code points in a 32 by 32 pixel grid, or in a 40 by 40  pixel  grid  if
18       "-r  32"  is specified.  The glyphs themselves can be either 16, 24, or
19       32 pixels tall depending on the "-r" parameter.  They can be 8, 16, 24,
20       or 32 pixels wide (widths of 32 are only supported if "-r 32" is speci‐
21       fied).  The default page is  0;  that  is,  the  range  U+0000  through
22       U+00FF, inclusive.
23
24       The PNG file can be printed.  It can also be edited with a graphics ed‐
25       itor.  An edited PNG file can then be re-converted into a  GNU  Unifont
26       .hex file with the unipng2hex command.
27

OPTIONS

29       -i    Specify  the  input file.  If not omitted, a Unifont .hex file is
30             read from STDIN.
31
32       -o    Specify the output file.
33
34       -p    Extract page pagenum from the .hex file.  The default is  Page  0
35             (Unicode range U+0000 through U+00FF).  Note that "page" is not a
36             standard Unicode term.  It refers to an  output  bitmap  graphics
37             page of 16 by 16 code points.
38
39       -r    Specify  the  rows  of pixels in the output glyphs.  Valid values
40             are 16, 24, and 32.  The default is 16 pixel rows tall.
41
42       -h    Print a help message of options and exit.
43

EXAMPLE

45       Sample usage:
46
47              unihex2png -i my_input_file.hex -o my_output_file.png
48

FILES

50       *.hex GNU Unifont font files
51

SEE ALSO

53       bdfimplode(1), hex2bdf(1), hex2otf(1), hex2sfd(1), hexbraille(1),  hex‐
54       draw(1),   hexkinya(1),   hexmerge(1),   johab2ucs2(1),  unibdf2hex(1),
55       unibmp2hex(1), unibmpbump(1),  unicoverage(1),  unidup(1),  unifont(5),
56       unifont-viewer(1),  unifont1per(1),  unifontchojung(1),  unifontksx(1),
57       unifontpic(1), unigencircles(1), unigenwidth(1), unihex2bmp(1), unihex‐
58       fill(1), unihexgen(1), unihexrotate(1), unipagecount(1), unipng2hex(1)
59

AUTHOR

61       unihex2png  was  written  by Andrew Miller, starting by converting Paul
62       Hardy's unihex2bmp C program to Perl.
63

LICENSE

65       unihex2png is Copyright © 2007 Paul Hardy, © 2013 Andrew Miller.
66
67       This program is free software; you can redistribute it and/or modify it
68       under  the  terms of the GNU General Public License as published by the
69       Free Software Foundation; either version 2 of the License, or (at  your
70       option) any later version.
71

BUGS

73       No  known real bugs exist, but the optional pixel rows parameter is not
74       yet supported by all other Unifont utilities.   Use  of  glyphs  taller
75       than  the  default  of 16 pixels is considered experimental.  Currently
76       unihex2png, unipng2hex, hexdraw, and hex2bdf tentatively support glyphs
77       that are 16, 24, and 32 pixels tall.
78
79       Also,  there is no extensive error checking on input files.  If they're
80       not in the format of the original GNU Unifont .hex file, all  bets  are
81       off.  Lines can be terminated either with line feed, or carriage return
82       plus line feed.
83
84
85
86                                  2013 Nov 09                    UNIHEX2PNG(1)
Impressum