Man Linux: Main Page and Category List

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 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 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>
       Frederic LOYER <loyer@ensta.fr>