


TTF2PK(1)                                               TTF2PK(1)


NNAAMMEE
       ttf2pk - convert a TrueType font into TeX's PK format

SSYYNNOOPPSSIISS
       ttttff22ppkk [--qq] [--nn] _f_o_n_t_-_n_a_m_e _r_e_s_o_l_u_t_i_o_n
       ttttff22ppkk --tt [--qq] _f_o_n_t_-_n_a_m_e
       ttttff22ppkk ----vveerrssiioonn | ----hheellpp

DDEESSCCRRIIPPTTIIOONN
       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 ttttff22ttffmm are also supported.

       ttttff22ppkk always assumes 10pt as  the  design  size  for  the
       written TeX font.

PPAARRAAMMEETTEERRSS
       --qq     This  optional  switch makes ttttff22ppkk quiet.  It sup-
              presses any informational output except warning and
              error messages.

       --nn     Use   only   `.pk'  as  the  extension  instead  of
              `.<_r_e_s_o_l_u_t_i_o_n>pk'.

       --tt     Test for the existence of _f_o_n_t_-_n_a_m_e.  Returns 0  on
              success  and  prints  out the corresponding line in
              ttfonts.map (provided the --qq switch isn't set).

       _f_o_n_t_-_n_a_m_e
              The TeX name of the font.  ttttff22ppkk looks  this  name
              up  in  a configuration file called ttfonts.map for
              further information how to process the font.

       _r_e_s_o_l_u_t_i_o_n
              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.

       ----vveerrssiioonn
              Shows  the  current  version of ttttff22ppkk and the used
              file search library (e.g. kkppaatthhsseeaa).

       ----hheellpp Shows usage information.

       Environment variables for file searching are described  in
       the manual page of ttttff22ttffmm.

TTHHEE CCOONNFFIIGGUURRAATTIIOONN FFIILLEE
       ttttff22ppkk  uses,  similar  to  ddvviippss,  a font definition file



FreeType version 1.3       15-Aug-1999                          1





TTF2PK(1)                                               TTF2PK(1)


       called ttfonts.map.  The parameters specified  to  ttttff22ttffmm
       are here preserved--ttttff22ttffmm 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  ttttff22ttffmm(1)  and aaffmm22ttffmm(1) of the ddvviippss package for a
       detailed description of encoding files.

       Here a table listing the various  ttttff22ttffmm  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  ttttff22ttffmm with
       `--rr _o_l_d_-_g_l_y_p_h_n_a_m_e _n_e_w_-_g_l_y_p_h_n_a_m_e'  are  directly  specified
       with  `_o_l_d_-_g_l_y_p_h_n_a_m_e=_n_e_w_-_g_l_y_p_h_n_a_m_e'.  They will be ignored
       if in subfont mode or if no encoding file is given.

       One additional  parameter  in  ttfonts.map  is  unique  to
       ttttff22ppkk:  `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
       `_<_n_a_m_e_s_t_e_m_>@_<_s_f_d_-_f_i_l_e_n_a_m_e_>@')  please refer to ttttff22ttffmm(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.   ttttff22ppkk  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.

       ttttff22ppkk  will  abort  if it can't find or read the TeX font
       metrics file of the given TeX font name.

RREETTUURRNN VVAALLUUEE
       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 ttttff22ppkk into scripts like mmkktteexxppkk
       for automatic font generation.

SSEEEE AALLSSOO
       ttttff22ttffmm(1), aaffmm22ttffmm(1)

AAVVAAIILLAABBIILLIITTYY
       ttttff22ppkk is part of the FreeType  package,  a  high  quality
       TrueType rendering library.

AAUUTTHHOORRSS
       Werner LEMBERG <wl@gnu.org>
       Frdric LOYER <loyer@ensta.fr>






























FreeType version 1.3       15-Aug-1999                          3


