1PS2PK(1) General Commands Manual PS2PK(1)
2
3
4
6 ps2pk - creates a TeX pkfont from a type1 PostScript font
7
9 ps2pk [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant ] [
10 -Ppointsize ] [ -Rbaseres ] [ -raspectratio ] [ -Yyres ] [ -aAFMfile ]
11 [ -mmodename ] type1 [pkfont]
12
14 This program renders a given type1 PostScript font at a given pointsize
15 (default 10.0 points) and resolution (default 300dpi) into a TeX
16 pkfont.
17
18 To generate the pkfont ps2pk needs a valid type1 font file (for example
19 Utopia-Regular, Utopia-Regula.pfb or Utopia-Regula.pfa) and its corre‐
20 sponding AFM-file (Utopia-Regular.afm) with the font metrics. The pro‐
21 gram accepts both the binary type1 format (Utopia-Regula.pfb) and its
22 ASCII equivalent (Utopia-Regular or Utopia-Regula.pfa). To locate the
23 files, ps2pk uses the kpathsea library (see the info page on kpathsea).
24 Additionally, pfb and pfa files are searched for in the directory spec‐
25 ified in the environment variable T1INPUTS, and afm files are searched
26 in AFMFONTS, if they are set (the -v flag will report which filenames
27 are looked for).
28
29 The program will make a pkfont in which the character codes are derived
30 from their AFM (Adobe Font Metrics) defined values. This can be over‐
31 ruled by specifying an explicit encoding file via the -e option. The
32 encoding file enc should contain a valid PostScript encoding containing
33 PostScript names like /hyphen. Here is an incomplete example (see
34 afm2tfm for complete syntax):
35
36 % This is the EC encoding.
37 /ECEncoding [ % now 256 chars follow
38 % 0x00
39 /grave /acute /circumflex /tilde /dieresis /hungarumlaut
40 /ring /caron /breve /macron /dotaccent /cedilla
41 /ogonek /quotesinglbase /guilsinglleft /guilsinglright
42
43 (Rest of lines omitted.)
44
45 % 0xF0
46 /eth /ntilde /ograve /oacute /ocircumflex /otilde
47 /odieresis /oe /oslash /ugrave /uacute /ucircumflex
48 /udieresis /yacute /thorn /germandbls ] def
49
50 Options and arguments:
51
52 -aAFMfile Overrules the name that is used to locate the AFM file.
53
54
55 -eenc Name of a file containing an encoding scheme (default - the
56 encoding named in the AFM-file is used). The actual Post‐
57 Script name of the encoding scheme is written as a "spe‐
58 cial" at the end of the pkfont.
59
60
61 -Eextension The extension factor (real value, default 1.0).
62
63
64 -mmodename A modename such as would be used by METAFONT (default
65 "Unknown mode").
66
67
68 -Ppointsize The desired pointsize (real value, default 10.0 points).
69
70
71 -Rbaseres The desired base resolution (integer value, default 300
72 dpi). If this differs from the value of xres, the appro‐
73 priate magnification will be shown in the "specials" at the
74 end of the pkfont. If possible, this will be expressed as a
75 magstep, otherwise as a real number. For example, a pkfont
76 with an xres of 329, using the default base resolution of
77 300, will include the "special" text "mag=magstep(0.5)" at
78 the end of the font.
79
80
81 -raspectratio
82 The desired aspect ratio (expression, integerY/integerX,
83 default 300/300). This will be shown in the "specials" at
84 the end of the pkfont. Setting the aspect ratio creates a
85 value for yres but an explicit yres value will take prece‐
86 dence. Argument must be in "" if spaces are left around
87 `/'.
88
89
90 -Sslant The slant (real value, default 0.0).
91
92
93 -Xxres The resolution in the X direction (integer value, default
94 300 dpi).
95
96
97 -Yyres The resolution in the Y direction (integer value, default
98 the value of xres). If yres differs from xres, a "special"
99 text giving the aspect ratio will be written at the end of
100 the pkfont.
101
102
103 -v Verbose flag. (Tells what the program is doing.)
104
105
106 type1 The name of the PostScript type1 font. The name of the
107 AFM-file will be constructed from this name by removing the
108 extension (if suplied) and adding ".afm". The PostScript
109 "FontName" is extracted from the AFM-file and written into
110 a "special" at the end of the pkfont.
111
112
113 [pkfont] The name of the resulting pkfont can be overruled with this
114 name. The default name of pkfont is derived from the base‐
115 name of the type1 font, the pointsize and xres. For exam‐
116 ple `ps2pk -P17.28 Utopia-Regular' will result in `Utopia-
117 Regular17.300pk'. An explicit value for the name of the
118 pkfont is necessary when the type1 font name already shows
119 the point size, otherwise the pointsize value is catenated
120 on to the pkfont basename which is usually not what is
121 wanted.
122
123
124 The following PK "specials" provide an internal check on the character‐
125 istics of the pkfont, in accordance with the recommendations of the TeX
126 Working Group on the TeX Directory Standard (TWG-TDS):
127 "fontid=FontName", "codingscheme=Encoding", "fontfacebyte", "mag",
128 "mode=(ps2pk)modename", "pixels-per-inch", and "aspect-ratio" if it is
129 other than unity.
130
131
133 This program uses the Type1 hinting and rendering software IBM has
134 donated to the X Consortium.
135
136
138 `METAFONT: The Program', Donald Knuth.
139 `The GFtoPK processor', belonging to the METAFONTware.
140 `Adobe Font Metric Files', Version 3.0, PostScript Developer
141 Support Group.
142 afm2tfm(1)
143 pk2bm(1)
144 kpsewhich(1)
145 info kpathsea
146
147
149 1.4 (January 1994)
150
151
153 Piet Tutelaers, modified for ps2pkm by Pierre A. Mackay. This manpage
154 was adapted to teTeX by Frank Kuester.
155
156 Maintained in TeX Live; please send bug reports or other correspondence
157 to tex-k@tug.org (http://lists.tug.org/tex-k).
158
159
160
161 1 Feb 2016 PS2PK(1)