NAME
ttf2pk - convert a TrueType font into TeX's PK formatSYNOPSIS
ttf2pk [-q] [-n] font-name resolutionDESCRIPTION
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.
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 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 tottf2tfm 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
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 <[email protected]>04-May-2011 | FreeType2 version |