Debian Codegraph @

texmf-dist/doc/man/man1/ps2pk.1

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