phpman > man > ttf2pk(1)

TTF2PK(1)                              General Commands Manual                             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.

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

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

PARAMETERS
       -q     This  optional  switch makes ttf2pk quiet.  It suppresses any informational output ex‐
              cept 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  corre‐
              sponding 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 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 di‐
       rectly 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 incorrect‐
       ly 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  signifi‐
       cant  (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 in‐
       clusion 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 AT gnu.org>
       Frédéric LOYER <loyer AT ensta.fr>



FreeType2 version                            04-May-2011                                   TTF2PK(1)