1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
\input texinfo @c -*-texinfo-*-
@setfilename README.info
@settitle pktrace - Scalable PostScript (Type1) Fonts for MetaFont
@node Top, , ,
@top
@chapter pktrace - Scalable PostScript Fonts for MetaFont
@section Introduction
@code{pktrace} is a small Python program that lets you trace a @TeX{}
bitmap font into a PFA or PFB font (A PostScript Type1 Scalable Font).
It is licensed under the GNU GPL.
Type1 fonts offer many advantages over bitmaps, as they allow PostScript
files to render correctly on printers with many resolutions. Moreover,
Ghostscript can generate much better PDF, if given scalable fonts.
@section Download
@itemize @bullet
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-1.0.3.tar.gz}
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-0.5.tar.gz}
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-0.4.tar.gz}
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-0.3.tar.gz}
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-0.2.tar.gz}
@item @uref{http://www.cs.uu.nl/~hanwen/pktrace/pktrace-0.1.tar.gz}
@end itemize
@section Required
@file{pktrace} is a thin Python wrapper around some other programs that
do the real work: Autotrace and t1asm. To run pktrace you need:
@itemize @bullet
@item Autotrace -- see @uref{http://autotrace.sourceforge.net}.
Version 0.29 still has a couple of bugs. Upgrade to the CVS version if
you encounter problems..
@item Python--1.5 or later. See @uref{http://www.python.org/}
@item t1utils. See @uref{http://www.lcdf.org/~eddietwo/type/}
@item TeX--your tex installation should include
@itemize @bullet
@item kpsewhich,
@item MetaFont
@end itemize
@end itemize
@section Recommended
A recent version (020215 or newer) of
@uref{http://pfaedit.sourceforge.net,pfaedit} is recommended. If it is
present, then pktrace will run the font through pfaedit to simplify and
autohint it.
@section Red Hat
A RPM may be built by issuing
@example
rpm -tb pktrace-@var{version}.tar.gz
@end example
@section Debian GNU/Linux
Users of Debian unstable (and Debian 3.0 when it is released) can
install all requirements by running (as root):
@example
apt-get install pktrace
@end example
If you wish to also install the pfaedit package to simplify and
autohint the font, then run the command
@example
apt-get install pfaedit
@end example
@section Install
Install the prerequite packages. Then run
@example
./configure
make install
@end example
in the pktrace directory. Run as follows:
@example
pktrace cmr10
@end example
@section Invoking pktrace.
Command line options:
@table @code
@item -a,--pfa
Generate PFA file (Default)
@item -b, --pfb
Generate a PFB file
@item -e,--encoding=ENC
Use encoding file ENC
@item --glyphs=LIST
Only process glyphs in LIST, which is a comma-delimited list of
decimal numbers.
@item -h,--help
help
@item -k,--keep
keep all output in directory
@file{pktrace.dir}
@item --keep-trying
Try to continue if autotrace fails: first try it with a less smoothed
curve, and if that fails, skip the character.
By default pktrace outputs @file{autotrace-bug-FONTNAME-NUMBER.pbm} and
stops the process with a request to file a bugreport.
@item -o,--output-base=FILE
Output to FILE.pfa or FILE.pfb.
@item --simplify
Pass the font through PfaEdit for automatic simplification and hinting.
@item --tfmfile=FILE
Use @var{file} for the TFM file
@item -V,--verbose
Be verbose
@item -v,--version
Print version number
@item -w,--warranty
show warranty and copyright
@end table
@section Discussion
Why use @code{pktrace} over
@uref{http://textrace.sourceforge.net,textrace}? Textrace and pktrace
are functionally similar. However, pktrace is quicker, more cleanly
written and can be installed using standard methods. Additionally,
textrace requires perl, ghostscript and dvips.
How about @uref{http://www.truetex.com,MetaFog}? MetaFog operates
directly on the curves that generate the bitmap font, its outlines will
probably be smaller and better. However, MetaFog is a proprietary
product: its source code is not available, and it will only run on a
limited number of platforms.
How about @uref{ftp://bop.eps.gda.pl/pub/metatype1/,MetaType1}?
MetaType1 is a very simplistic approach that puts severe constraints on
what may be done in a font program. It does not work for fonts
containing overlaps and shaped pens.
How about @uref{http://metatype.sourceforge.net/,MetaType}? MetaType is
similar in design to pktrace. However, metatype aims at producing
TrueType fonts, not Type1 fonts. Operating MetaType requires more
additional packages. (Note: Yours Truly did not look further into
MetaType)
@section Todo
@itemize
@item Inverse mapping: convert cmr10 to Computer-Modern-Roman-10
@item Submit @file{tfm.py} to www.python.org. @file{tfm.py} is a python
module to parse Tex Font Metric file.
@end itemize
@section Author
@email{hanwen@@cs.uu.nl,Han-Wen Nienhuys}
@section Credits
The biggest credits go out to Martin Weber, who wrote AutoTrace and
@email{gww@@silcom.com,George Williams}, who wrote pfaedit.
The package also contains gf2pbm, a utility to convert a MetaFont GF
file to a PBM file. Its source code was based on Paul Vojta's Xdvi
program. The license notice is reproduced here:
@quotation
Copyright (c) 1990-1999 Paul Vojta
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
PAUL VOJTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@end quotation
Thanks to @uref{http://www.maths.qmul.ac.uk/~jdg/,Julian Gilbey} for
finding many bugs.
@section See also
@itemize @bullet
@item @uref{http://partners.adobe.com/asn/developer/pdfs/tn/T1Format.pdf,Type1
font specification}
@item @uref{http://partners.adobe.com/asn/developer/pdfs/tn/5015.Type1_Supp.pdf,Supplement
to the Type1 specification}.
@end itemize
@bye
|
