1 .TH MFTRACE 1 "April 5, 2004"
2 .\" Copyright (c) 1999--2006 by the authors
4 .\" Permission is granted to copy, distribute and/or modify this document
5 .\" under the terms of the GNU General Public License.
7 .\" You should have received a copy of the GNU General Public License
8 .\" along with this program; if not, write to the Free Software
10 .\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
15 mftrace \- convert METAFONT format fonts into Type1 outline fonts
20 .RI [ options ] " fontname"
25 is a program that can convert a METAFONT font into a Type1 font. It
26 is simply called with the name of the font (without a .mf suffix) and
27 produces a Type1 font file called either
31 depending on the command line options.
33 For tracing the bitmap,
39 (the former preferred) if available; this can be overridden with the
47 This program follows the usual GNU command line syntax, with long
48 options starting with two dashes (`-').
52 Keep all output in directory `mftrace.dir'.
55 .BI \-\-magnification= MAG
56 The magnification to use for the PFA file. The default is 1000. The
57 larger the magnification, the more precise the PFA file will
58 be. However, when the magnification is too large METAFONT can crash
61 Sadly, many MF fonts contain resolution checks
64 if dots_per_inch * design_size > 1500:
67 This check is susceptible to overflow errors. Such code should be
68 reported as a bug, and changed to
71 if dots_per_inch > (1500 / design_size):
76 .BI \-\-formats= FMT1,FMT2,...
77 Specify which formats to generate (default is pfa). Choices are: afm,
78 pfa, pfb, ttf, svg. Note that
82 must be installed to generate any format except pfa or pfb. For generating
90 This will pass the created Type1 font through
94 to simplify and autohint it.
100 instead of running Metafont.
103 .BR \-I " " \fIDIR\fP ", " \-\-include= \fIDIR\fP
106 to the current path for searching files.
110 Process only these glyphs.
112 is a comma separated list of decimal numbers or ranges, for example
116 .BI \-\-tfmfile= FILE
119 for the TFM file. (The default is to use
120 .IR \%fontname .tfm).
123 .BR \-e " " \fIENC\fP ", " \-\-encoding=\fIENC\fP
126 Encoding files used by
128 are basically in the GhostScript/dvips format, but you may use a
131 glyph name in order to tell mftrace not to process a specific glyph.
132 If this option is not specified,
134 will try to determine the encoding file automatically, from the
135 encoding specified in the TFM file, the default being tex256.enc.
139 Try to continue if external programs called by mftrace fail. If METAFONT
140 crashes with overflow errors, but nevertheless outputs a GF file, try to
141 process its output as is (useful for some buggy fonts, see above). If
142 potrace/autotrace fails to trace a specific character, first try it with
143 a less smoothed curve, and if that fails, skip the character. By default
145 leaves a file `trace-bug-\fIfont\fP-\fIchar\fP.pbm' and stops the process
146 with a request to file a bugreport.
150 Try to use MikTeX's version of
157 for tracing bitmaps. The default is to use
159 if it is found, otherwise to use
170 Don't read the AFM file to find font information.
174 Do not round coordinates of control points to integer values (use with
180 Set reciprocal grid size in em units multiplied by ratio
181 magnification/1000. For example, \fB\-\-grid\fP 10
182 \fB\-\-magnification\fP 1000 will round coordinates of control points
183 to 1/10 of em unit. Useful simultaneously with the \fB\-\-noround\fP
184 option. Default \fIGRID\fP value is 1, i.e., round to integer. This
185 option is only used with
189 .BI \-D,\-\-define= SYMBOL=VALUE
190 Set the font info \fISYMBOL\fP to the given \fIVALUE\fP. For example
191 \fB-D\fPFamilyName=Foo sets the font family name to \fIFoo\fP. Mftrace tries
192 to fill in sensible default values for the FontName, FamilyName, FullName
201 Show summary of options.
205 Show version of program.
209 Show warranty and copyright.
213 You may redistribute copies of mftrace under the terms of
214 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
215 There is NO WARRANTY, to the extent permitted by law.
217 This manual page is copyright \(co 2005,2006 Julian Gilbey and is
218 distributed under the GNU General Public License too.
230 was written by Han-Wen Nienhuys <hanwen@xs4all.nl>.
231 This manual page was originally written by Julian Gilbey <jdg@debian.org>
232 and has been revised by Werner Lemberg <wl@gnu.org>.