summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/ttf2pk/ttf2pk.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/ttf2pk/ttf2pk.txt')
-rw-r--r--Master/texmf/doc/ttf2pk/ttf2pk.txt152
1 files changed, 0 insertions, 152 deletions
diff --git a/Master/texmf/doc/ttf2pk/ttf2pk.txt b/Master/texmf/doc/ttf2pk/ttf2pk.txt
deleted file mode 100644
index 281dfb353b1..00000000000
--- a/Master/texmf/doc/ttf2pk/ttf2pk.txt
+++ /dev/null
@@ -1,152 +0,0 @@
-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.
-
- 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 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 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 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 de-
- scription of encoding files.
-
- Here a table listing the various ttf2tfm parameters and the correspond-
- ing 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-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 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. 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 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 ren-
- dering library.
-
-AUTHORS
- Werner LEMBERG <wl@gnu.org>
- Frédéric LOYER <loyer@ensta.fr>
-
-
-
-FreeType version 1.5 10-Jan-2002 TTF2PK(1)