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 configuration
file called ttfonts.map; it specifies how to handle each font. 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 in‐
formational 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 con‐
figuration file called ttfonts.map for further information how
to process the font.
resolution
The resolution, given in dots per inch. Currently the horizon‐
tal 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 li‐
brary (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 called
ttfonts.map. The parameters specified to ttf2tfm are here preserved—
ttf2tfm writes out to standard output, as the last line, a proper con‐
figuration 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 de‐
scription of encoding files.
Here a table listing the various ttf2tfm parameters and the correspond‐
ing 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-glyph‐
name 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. De‐
fault 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 parameters 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 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 ttfonts.map,
2 is returned. This simplifies the inclusion of ttf2pk into scripts
like mktexpk for automatic font generation.
SEE ALSOttf2tfm(1), afm2tfm(1)AVAILABILITY
ttf2pk is part of the FreeType package, a high quality TrueType render‐
ing library.
AUTHORS
Werner LEMBERG <wl@gnu.org>
Frédéric LOYER <loyer@ensta.fr>
FreeType version 1.3 15-Aug-1999 TTF2PK(1)