| 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). |