NAME

       ttf2pk - convert a TrueType font into TeX's PK format

SYNOPSIS

       ttf2pk [-q] [-n] font-name resolution
       ttf2pk -t [-q] font-name
       ttf2pk --version | --help

DESCRIPTION

       This  program  converts  a TrueType font into a PK file; the created font can then be used
       with TeX or LaTeX.

       CJKV (Chinese/Japanese/Korean/old Vietnamese) subfonts as  created  by  ttf2tfm  are  also
       supported.

       ttf2pk always assumes 10 points (10pt) as the design size for the written TeX font.

PARAMETERS

       -q     This  optional  switch  makes ttf2pk quiet.  It suppresses any informational output
              except warning and error messages.

       -n     Use only `.pk' as the extension instead of `.<resolution>pk'.

       -t     Test for the existence of font-name.  Returns 0  on  success  and  prints  out  the
              corresponding  line  of  a  map file (default: ttfonts.map), provided the -q switch
              isn't set.

       font-name
              The TeX name of the font.  ttf2pk looks this name up in a map file (see below)  for
              further information how to process the font.

       resolution
              The  resolution,  given  in  dots per inch.  Currently the horizontal resolution is
              equal to the vertical  resolution.   The  design  size  is  always  assumed  to  be
              10 points (10pt).

       --version
              Shows   the   current   version   of  ttf2pk  and  the  used  file  search  library
              (e.g. kpathsea).

       --help Shows usage information.

       Environment variables for file searching are described in the manual page of ttf2tfm.

THE CONFIGURATION FILE

       ttf2pk uses a small configuration file called ttf2pk.cfg;  in  each  line  it  contains  a
       keyword  with its value, separated by whitespace.  Comment lines can start with any of the
       following characters: `*', `#', `;', and `%'.  Leading whitespace is ignored.

       Currently, only one keyword, `map', is recognized in this file; it takes a map  file  name
       as  a  parameter.   If  no  extension is given to the map file name, .map is appended.  No
       whitespace is allowed in the map file name.  The `map' keyword can be given more than once
       to  specify  multiple  map  files; if the map file name is prepended by a plus sign, it is
       added to the list of map files to be used.  Example:

         map  foo
         map +bar

       This makes ttf2pk to first read foo.map, then bar.map.

       If the configuration file is not found, ttf2pk tries to use ttfonts.map instead.

MAP FILES

       Parameters specified to ttf2tfm are preserved for ttf2pk in map files—ttf2tfm  writes  out
       to standard output, as the last line, a proper entry for a map file.

       As an example, a call to

         ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials

       will produce the following line:

         arials   arial Slant=0.25 Pid=1 Eid=0 Encoding=T1.enc

       See  ttf2tfm(1) and afm2tfm(1) of the dvips package for a detailed description of encoding
       files.

       Here a table listing the various ttf2tfm parameters and the corresponding entries in a map
       file:

           -s                  Slant
           -e                  Extend
           -p                  Encoding
           -f                  Fontindex
           -P                  Pid
           -E                  Eid
           -n                  PS=Yes
           -N                  PS=Only
           -R                  Replacement
           -x                  Rotate=Yes
           -y                  Y-Offset

       Single  replacement glyph names given to ttf2tfm with `-r old-glyphname new-glyphname' are
       directly specified with `old-glyphname=new-glyphname'.  They will be ignored if in subfont
       mode or if no encoding file is given.

       One  additional parameter in a map file is unique to ttf2pk: `Hinting', which can take the
       values `On' or `Off'.  Some fonts (e.g.,  the  CJK  part  of  cyberbit.ttf)  are  rendered
       incorrectly  if hinting is activated.  Default is `On' (you can also use `Yes', `No', `1',
       and `0').

       For a description of subfonts (i.e., entries  of  the  form  `<namestem>@<sfd-filename>@')
       please refer to ttf2tfm(1).

       The  format  of  a map file is simple.  Each line defines a font; first comes the TeX font
       name, then its TrueType font file name, followed by the parameters in any order.  Case  is
       significant (even for parameter names); the parameters are separated from its values by an
       equal sign, with whitespace possibly surrounding it.  ttf2pk reads in all map  files  line
       by  line  in  the  order  given  in  the configuration file, continuing until the TeX font
       specified on the command line is found, otherwise the programs exits  with  error  code 2.
       Thus you can use any character invalid in a TeX font name to start a comment line.

       You  can  use `\' as the final character of a line to indicate that the input is continued
       on the next line.  The backslash and the following newline character will be removed.

       ttf2pk will abort if it can't find or read the TeX font metrics file of the given TeX font
       name.

RETURN VALUE

       If  the call was successful, 0 will be returned.  In case of error, the return value is 1.
       Finally, if the font can't be found in the map files, 2 is returned.  This simplifies  the
       inclusion of ttf2pk into scripts like mktexpk for automatic font generation.

SEE ALSO

       ttf2tfm(1), afm2tfm(1)

AVAILABILITY

       ttf2pk is part of the FreeType 1 package, a high quality TrueType rendering library.

AUTHORS

       Werner LEMBERG <wl@gnu.org>
       Frédéric LOYER <loyer@ensta.fr>