


TTF2PK(1)                                               TTF2PK(1)


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.

       All TrueType fonts to be used must be registered in a con-
       figuration  file  called  ttfonts.map; it specifies how to
       handle each font.  CJKV (Chinese/Japanese/Korean/old Viet-
       namese) subfonts as created by ttf2tfm are also supported.

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

PARAMETERS
       -q     This  optional  switch makes ttf2pk quiet.  It sup-
              presses 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 in
              ttfonts.map (provided the -q switch isn't set).

       font-name
              The TeX name of the font.  ttf2pk looks  this  name
              up  in  a configuration file called ttfonts.map 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 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,  similar  to  dvips,  a font definition file



FreeType version 1.3       15-Aug-1999                          1





TTF2PK(1)                                               TTF2PK(1)


       called ttfonts.map.  The parameters specified  to  ttf2tfm
       are here preserved--ttttff22ttffmm writes out to standard output,
       as  the  last  line,  a  proper  configuration  entry  for
       ttfonts.map.

       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 ttfonts.map entries:

           -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  ttfonts.map  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 ttfonts.map 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 param-
       eters are separated from its values by an equal sign, with
       whitespace  possibly  surrounding  it.   ttf2pk  reads  in
       ttfonts.map line by line, continuing until  the  TeX  font
       specified on the command line is found, otherwise the pro-
       grams exits with error code 2.  Thus you can use any char-



FreeType version 1.3       15-Aug-1999                          2





TTF2PK(1)                                               TTF2PK(1)


       acter  invalid in a TeX font name to start a comment line.

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

       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 ttfonts.map, 2 is returned.   This  sim-
       plifies  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  package,  a  high  quality
       TrueType rendering library.

AUTHORS
       Werner LEMBERG <wl@gnu.org>
       Frdric LOYER <loyer@ensta.fr>






























FreeType version 1.3       15-Aug-1999                          3


