Provided by: texlive-binaries_2009-11ubuntu2_i386 bug

NAME

       ps2pk - creates a TeX pkfont from a type1 PostScript font

SYNOPSIS

       ps2pk  [  -v  ]  [  -eenc  ]  [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [
       -Ppointsize ] [ -Rbaseres ] [ -raspectratio  ] [ -Yyres ] [ -aAFMfile ]
       [ -mmodename ] type1 [pkfont]

DESCRIPTION

       This program renders a given type1 PostScript font at a given pointsize
       (default 10.0 points)  and  resolution  (default  300dpi)  into  a  TeX
       pkfont.

       To generate the pkfont ps2pk needs a valid type1 font file (for example
       Utopia-Regular,  Utopia-Regula.pfb  or   Utopia-Regula.pfa)   and   its
       corresponding AFM-file (Utopia-Regular.afm) with the font metrics.  The
       program accepts both the binary type1  format  (Utopia-Regula.pfb)  and
       its  ASCII equivalent (Utopia-Regular or Utopia-Regula.pfa).  To locate
       the files, ps2pk uses the  kpathsea  library  (see  the  info  page  on
       kpathsea).  Additionally,  pfb  and  pfa  files are searched for in the
       directory specified in the environment variable T1INPUTS, and afm files
       are  searched  in  AFMFONTS,  if  they are set (the -v flag will report
       which filenames are looked for).

       The program will make a pkfont in which the character codes are derived
       from  their  AFM  (Adobe  Font  Metrics)  defined  values.  This can be
       overruled by specifying an explicit encoding file via  the  -e  option.
       The  encoding  file  enc  should  contain  a  valid PostScript encoding
       containing PostScript  names  like  /hyphen.   Here  is  an  incomplete
       example (see afm2tfm for complete syntax):

              % This is the EC encoding.
              /ECEncoding [          % now 256 chars follow
              % 0x00
                /grave /acute /circumflex /tilde /dieresis /hungarumlaut
                /ring /caron /breve /macron /dotaccent /cedilla
                /ogonek /quotesinglbase /guilsinglleft /guilsinglright

                (Rest of lines omitted.)

              % 0xF0
                /eth /ntilde /ograve /oacute /ocircumflex /otilde
                /odieresis /oe /oslash /ugrave /uacute /ucircumflex
                /udieresis /yacute /thorn /germandbls ] def

       Options and arguments:

       -aAFMfile   Overrules the name that is used to locate the AFM file.

       -eenc       Name of a file containing an encoding scheme (default - the
                   encoding named  in  the  AFM-file  is  used).   The  actual
                   PostScript  name  of  the  encoding  scheme is written as a
                   "special" at the end of the pkfont.

       -Eextension The extension factor (real value, default 1.0).

       -mmodename  A modename such as  would  be  used  by  METAFONT  (default
                   "Unknown mode").

       -Ppointsize The desired pointsize (real value, default 10.0 points).

       -Rbaseres   The  desired  base  resolution  (integer value, default 300
                   dpi).   If  this  differs  from  the  value  of  xres,  the
                   appropriate  magnification  will be shown in the "specials"
                   at the end  of  the  pkfont.  If  possible,  this  will  be
                   expressed  as  a  magstep,  otherwise as a real number. For
                   example, a pkfont with an xres of 329,  using  the  default
                   base  resolution  of  300,  will include the "special" text
                   "mag=magstep(0.5)" at the end of the font.

       -raspectratio
                   The desired aspect  ratio  (expression,  integerY/integerX,
                   default  300/300).  This will be shown in the "specials" at
                   the end of the pkfont.  Setting the aspect ratio creates  a
                   value  for  yres  but  an  explicit  yres  value  will take
                   precedence.  Argument must be in  ""  if  spaces  are  left
                   around `/'.

       -Sslant     The slant (real value, default 0.0).

       -Xxres      The  resolution  in the X direction (integer value, default
                   300 dpi).

       -Yyres      The resolution in the Y direction (integer  value,  default
                   the  value of xres). If yres differs from xres, a "special"
                   text giving the aspect ratio will be written at the end  of
                   the pkfont.

       -v          Verbose flag. (Tells what the program is doing.)

       type1       The  name  of  the  PostScript type1 font.  The name of the
                   AFM-file will be constructed from this name by removing the
                   extension  (if  suplied) and adding ".afm".  The PostScript
                   "FontName" is extracted from the AFM-file and written  into
                   a "special" at the end of the pkfont.

       [pkfont]    The name of the resulting pkfont can be overruled with this
                   name.  The default name  of  pkfont  is  derived  from  the
                   basename  of  the  type1 font, the pointsize and xres.  For
                   example  `ps2pk  -P17.28  Utopia-Regular'  will  result  in
                   `Utopia-Regular17.300pk'.   An  explicit value for the name
                   of the pkfont is necessary when the type1 font name already
                   shows  the  point  size,  otherwise  the pointsize value is
                   catenated on to the pkfont basename which  is  usually  not
                   what is wanted.

       The   following   PK  "specials"  provide  an  internal  check  on  the
       characteristics of the pkfont, in accordance with  the  recommendations
       of the TeX Working Group on the TeX Directory Standard (TWG-TDS):
       "fontid=FontName",   "codingscheme=Encoding",   "fontfacebyte",  "mag",
       "mode=(ps2pk)modename", "pixels-per-inch", and "aspect-ratio" if it  is
       other than unity.

ACKNOWLEDGEMENT

       This  program  uses  the  type1  hinting and rendering software IBM has
       donated to the X-consortium.

SEE ALSO

       `METAFONT: The Program', Donald Knuth.
       `The GFtoPK processor', belonging to the METAFONTware.
       `Adobe Font Metric Files', Version 3.0, PostScript Developer
       Support Group.
       afm2tfm(1)
       pk2bm(1)
       kpsewhich(1)
       info kpathsea

VERSION

       1.4 (January 1994)

AUTHOR

       Piet Tutelaers <rcpt@urc.tue.nl>.  Modified for  ps2pkm  by  Pierre  A.
       Mackay <mackay@cs.washington.edu>, This manpage was adapted to teTeX by
       Frank Kuester <frank@kuesterei.ch>.

                                      TeX                             PS2PK(1)