1PS2PK(1)                    General Commands Manual                   PS2PK(1)
2
3
4

NAME

6       ps2pk - creates a TeX pkfont from a type1 PostScript font
7

SYNOPSIS

9       ps2pk  [  -v  ]  [  -eenc  ]  [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [
10       -Ppointsize ] [ -Rbaseres ] [ -raspectratio  ] [ -Yyres ] [ -aAFMfile ]
11       [ -mmodename ] type1 [pkfont]
12

DESCRIPTION

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

ACKNOWLEDGEMENT

133       This  program  uses  the  type1  hinting and rendering software IBM has
134       donated to the X-consortium.
135
136

SEE ALSO

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

VERSION

149       1.4 (January 1994)
150
151

AUTHOR

153       Piet Tutelaers <rcpt@urc.tue.nl>.  Modified for  ps2pkm  by  Pierre  A.
154       Mackay <mackay@cs.washington.edu>, This manpage was adapted to teTeX by
155       Frank Kuester <frank@kuesterei.ch>.
156
157
158
159                                      TeX                             PS2PK(1)
Impressum