home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume20 / hp2pk / part02 / hp2pk.lpt < prev    next >
Text File  |  1991-06-02  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      HP2PK(1L)                                               HP2PK(1L)
  5.  
  6.  
  7.  
  8.      NAME
  9.           hp2pk - convert Hewlett-Packard soft fonts into TeX fonts
  10.  
  11.      SYNOPSIS
  12.           hp2pk [-b density] [-d size] [-h] [-l pl-file[.pl]]
  13.                 [-m magnification] [-p pk-file[.pk]] [-r {l|u}]
  14.                 [-s space-width] [-t tfm-file[.tfm]] [-v] sfp-file[.sfp]
  15.  
  16.      DESCRIPTION
  17.           HP2PK converts Hewlett-Packard Soft Font/Portrait (SFP) files
  18.           into the TFM and PK files needed by TeX.  (Okay, okay, so TeX
  19.           itself doesn't need PK files--the DVI driver programs associated
  20.           with TeX generally do!)  Only bitmap fonts, either Class 1 bitmap
  21.           or Class 2 compressed bitmap, are handled by HP2PK.  The program
  22.           cannot process Intellifont Scalable Fonts.
  23.  
  24.           For all files read or written by HP2PK, an appropriate filename
  25.           extension is automatically appended to the filename if one is not
  26.           specified explicitly.
  27.  
  28.      OPTIONS
  29.           The command line options are described below.
  30.  
  31.           -b density
  32.                The -b option specifies the pixel density of the font in
  33.                dots per inch.  If this is not given on the command line,
  34.                HP2PK assumes a value of 300 dpi.
  35.  
  36.           -d size
  37.                The -d option specifies the design size of the font in
  38.                points.  If this is not given on the command line, HP2PK
  39.                calculates a value from the information given in the input
  40.                font header, writing the computed value to the standard
  41.                output.
  42.  
  43.           -h   The -h option causes a brief description of the command line
  44.                options to be written to the standard error output (normally
  45.                the screen).  No other action is performed when this option
  46.                is used.
  47.  
  48.           -m magnification
  49.                The -m option specifies the magnification of the font.  The
  50.                default value is 1000, which indicates no magnification.
  51.  
  52.           -l pl-file
  53.                The -l option specifies a Property List (PL) font metric
  54.                output file.  This is a human-readable form of a TeX font
  55.                metric file.
  56.  
  57.           -p pk-file
  58.                The -p option specifies the font PacKed bitmap (PK) output
  59.                file.  If it is not given on the command line, HP2PK
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/12/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      HP2PK(1L)                                               HP2PK(1L)
  71.  
  72.  
  73.  
  74.                produces a PK file with the same basic name as the input
  75.                file, but with a ".pk" filetype extension.
  76.  
  77.           -r {l|u}
  78.                The -rl option specifies that only the lower 128 character
  79.                codes be converted and written to the output files.  The -ru
  80.                option specifies that only the upper 128 character codes be
  81.                converted, with the codes translated from the range 128-255
  82.                to the range 0-127.  This allows font files to be prepared
  83.                for antiquated DVI drivers that cannot handle 8-bit fonts.
  84.  
  85.           -s space-width
  86.                The -s option specifies the basic width of a space character
  87.                in points, if none exists in the soft font.  Character code
  88.                32 (octal 040) is assumed to be a space character if it
  89.                exists.  If the space character is not defined in the font,
  90.                and the -s option is not used, then the width of the x
  91.                character (decimal code 120, octal code 170) is used.
  92.  
  93.           -t tfm-file
  94.                The -t option specifies the TeX Font Metric (TFM) output
  95.                file.  If neither a TFM (-t) nor a PL (-l) file is given on
  96.                the command line, HP2PK produces a TFM file with the same
  97.                basic name as the input file, but with a ".tfm" filetype
  98.                extension.
  99.  
  100.           -v   The -v option tells HP2PK to be more talkative as it works.
  101.  
  102.      SEE ALSO
  103.           TFtoPL(1), PLtoTF(1), GFtoPK(1)
  104.  
  105.      BUGS
  106.           The Hewlett-Packard Soft Font file provides neither kerning
  107.           nor ligature information.  It also does not supply the slant
  108.           information for italic fonts.  If needed, these values must
  109.           be supplied by editing the PL file and then running PLtoTF to
  110.           produce the TFM file.
  111.  
  112.           The font's pixel density must be a integral number of dots per
  113.           inch.
  114.  
  115.           Bitmaps larger than 32767 bytes are not (yet) handled.  (Such
  116.           a bitmap would be larger than 510 dots square!)
  117.  
  118.      AUTHOR
  119.           Stephen McConnel (steve@txsil.sil.org)
  120.           Summer Institute of Linguistics
  121.           7500 W. Camp Wisdom Road
  122.           Dallas, TX 75236, U.S.A.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/12/91)
  130.  
  131.  
  132.  
  133.