man/unifontpic.1

   1 .TH UNIFONTPIC 1 "2013 Sep 07"
   2 .SH NAME
   3 unifontpic \- Convert GNU Unifont .hex input to a bitmap image of the whole font
   4 .SH SYNOPSIS
   5 .br
   6 .B unifontpic
   7 [-dnnn][-l][-t] <
   8 .I input-font.hex
   9 >
  10 .I output-font.bmp
  11 .SH DESCRIPTION
  12 .B unifontpic
  13 reads a GNU Unifont .hex file from STDIN and writes a two dimensional
  14 rendering for each glyph to STDOUT.
  15 The output displays the entire Unicode Basic Multilingual Plane (BMP)
  16 as one large graphic image, showing a grid of 256 glyphs by 256 glyphs
  17 as the default, or (at your option) 16 glyphs across by 4,096 glyphs down.
  18 .PP
  19 Input can be one or more files in Unifont .hex format.  They don't
  20 have to be sorted, as
  21 .B unifontpic
  22 will populate the entire glyph array of 65,536 code points before
  23 writing its output.  The input glyph code points should all be
  24 unique, as feeding in duplicate code points will produce unpredictable
  25 results.  Use
  26 .B unidup (1)
  27 on a sorted input of .hex files to guarantee no code point
  28 duplication.
  29 .SH OPTIONS
  30 .TP 12
  31 -dnnn
  32 Specify a Dots per Inch (DPI) resolution of
  33 .I nnn.
  34 For example, specifying -d120 will encode the bitmap graphics file
  35 output as having a resolution of 120 DPI.
  36 .TP
  37 -l
  38 Produce a long chart, 16 glyphs wide by 4,096 glyphs tall.
  39 The default is a wide chart, 256 glyphs wide by 256 glyphs tall.
  40 .TP
  41 -t
  42 Use tiny numbers for the row and column code point labels.  Tiny
  43 numbers are on a 4 by 5 pixel grid.  Only tiny code point labels
  44 appear on the long chart variant; this option only has effect
  45 for wide charts (the default, of 256 by 256 glyphs).  If this option
  46 is not specified for the default 256-by-256 grid, row and column
  47 code point labels are taken from Unifont's glyphs for `0' to `9'
  48 and `A' to `F'.
  49 .SH EXAMPLES
  50 Sample usage:
  51 .PP
  52 .RS
  53 cat *.hex | unifontpic -d120 > unifontpic.bmp
  54 .RE
  55 .PP
  56 To generate a bitmap that shows combining circles, from the
  57 .B font/
  58 subdirectory:
  59 .PP
  60 .RS
  61 sort hexsrc/*.hex | unigencircles ttfsrc/combining.txt |
  62 unifontpic -d120 >unifontpic.bmp
  63 .RE
  64 .SH FILES
  65 *.hex GNU Unifont font files
  66 .SH SEE ALSO
  67 .BR bdfimplode(1),
  68 .BR hex2bdf(1),
  69 .BR hex2sfd(1),
  70 .BR hexbraille(1),
  71 .BR hexdraw(1),
  72 .BR hexkinya(1),
  73 .BR hexmerge(1),
  74 .BR johab2ucs2(1),
  75 .BR unibdf2hex(1),
  76 .BR unibmp2hex(1),
  77 .BR unicoverage(1),
  78 .BR unidup(1),
  79 .BR unifont(5),
  80 .BR unifontchojung(1),
  81 .BR unifontksx(1),
  82 .BR unigencircles(1),
  83 .BR unigenwidth(1),
  84 .BR unihex2bmp(1),
  85 .BR unihex2png(1),
  86 .BR unihexgen(1),
  87 .BR unipagecount(1),
  88 .BR unipng2hex(1)
  89 .SH AUTHOR
  90 .B unifontpic
  91 was written by Paul Hardy.
  92 .SH LICENSE
  93 .B unifontpic
  94 is Copyright \(co 2013 Paul Hardy.
  95 .PP
  96 This program is free software; you can redistribute it and/or modify
  97 it under the terms of the GNU General Public License as published by
  98 the Free Software Foundation; either version 2 of the License, or
  99 (at your option) any later version.
 100 .SH BUGS
 101 No known bugs exist.