Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MFTRACE(1)		    General Commands Manual		    MFTRACE(1)

NAME
       mftrace - convert METAFONT format fonts into Type1 outline fonts

SYNOPSIS
       mftrace [options] fontname

DESCRIPTION
       mftrace	is  a  program	that  can convert a METAFONT font into a Type1
       font.  It is simply called with the name	of the font (without  a	 `.mf'
       suffix)	and  produces  a Type1 font file called	either fontname.pfa or
       fontname.pfb depending on the command line options.  With the  help  of
       fontforge(1) it can produce other font formats too.

       For  tracing the	bitmap,	mftrace	either uses potrace(1) or autotrace(1)
       (the former preferred) if available; this can be	 overridden  with  the
       --autotrace and --potrace command line options.

OPTIONS
       This  program  follows the usual	GNU command line syntax, with long op-
       tions starting with two dashes (`-').

       -k, --keep
	      Keep all output in directory `mftrace.dir'.

       --magnification=MAG
	      The magnification	to use for the PFA file.  The default is 1000.
	      The larger the magnification, the	more precise the PFA file will
	      be.  However, if the magnification is  too  large	 METAFONT  can
	      crash with overflow errors.

	      Sadly, many MF fonts contain resolution checks

		     if	dots_per_inch *	design_size > 1500:

	      This  check is susceptible to overflow errors.  Such code	should
	      be reported as a bug, and	changed	to

		     if	dots_per_inch >	(1500 /	design_size):

       --formats=FMT1,FMT2,...
	      Specify which formats to generate	 (default  is  pfa).   Choices
	      are:  `afm',  `pfa',  `pfb',  `ttf', `svg'.  Note	that fontforge
	      (formerly	called pfaedit)	must be	installed to generate any for-
	      mat except `pfa' or `pfb'.  For generating `afm' you need	either
	      fontforge	or ghostscript.

       --simplify
	      This passes the created Type1 font to fontforge (formerly	called
	      pfaedit) to simplify and autohint	it.

       --gffile=FILE
	      Use  generic font	file FILE instead of running Metafont.	(GF is
	      the default output format	of Metafont.)

       -I DIR, --include=DIR
	      Add DIR to the current path for searching	files.

       --glyphs=LIST
	      Process only these glyphs.  LIST is a comma  separated  list  of
	      decimal numbers or ranges, for example `1-10,50,55,90-100'.

       --tfmfile=FILE
	      Use   FILE   for	 the   TFM  file.   (The  default  is  to  use
	      fontname.tfm).

       -e ENC, --encoding=ENC
	      Use encoding file	ENC.  Encoding files used by mftrace are basi-
	      cally in the GhostScript/dvips format, but you may use a special
	      .notavail	glyph name in order to tell mftrace not	to  process  a
	      specific	glyph.	If this	option is not specified, mftrace tries
	      to determine the encoding	file automatically, from the  encoding
	      specified	in the TFM file, the default being `tex256.enc'.

       --keep-trying
	      Try to continue if external programs called by mftrace fail.  If
	      METAFONT crashes with overflow errors, but nevertheless  outputs
	      a	 GF  file,  try	 to  process its output	as is (useful for some
	      buggy fonts, see above).	If potrace or autotrace	fail to	 trace
	      a	 specific  character, first try	it with	a less smoothed	curve,
	      and if that fails, skip  the  character.	 By  default,  mftrace
	      leaves  a	 file  `trace-bug-font-char.pbm' and stops the process
	      with a request to	file a bugreport.

       --dos-kpath
	      Try to use MikTeX's version of kpsewhich.

       --potrace
	      Use potrace for tracing bitmaps.	The default is to use  potrace
	      if it is found, otherwise	to use autotrace.

       --autotrace
	      Use autotrace for	tracing	bitmaps.

       --no-afm
	      Don't read the AFM file to find font information.

       --noround
	      Do  not  round  coordinates  of control points to	integer	values
	      (use with	--grid).  Disabled by default.

       --grid=GRID
	      Set reciprocal grid size in em units multiplied by ratio	magni-
	      fication/1000.   For  example,  `--grid 10 --magnification 1000'
	      rounds coordinates of control points to 1/10th of	the  em	 unit.
	      Useful  simultaneously  with the --noround option.  Default GRID
	      value is 1, i.e.,	round to integer.  This	option	is  only  used
	      with potrace.

       -D,--define=SYMBOL=VALUE
	      Set  the	font  info  SYMBOL  to	the given VALUE.  For example,
	      -DFamilyName=Foo sets the	font  family  name  to	Foo.   mftrace
	      tries  to	 fill  in  sensible default values for the `FontName',
	      `FamilyName', `FullName' and `Weight' fields.

       -V, --verbose
	      Be verbose.

       -h, --help
	      Show summary of options.

       -v, --version
	      Show version of program.

       -w, --warranty
	      Show warranty and	copyright.

COPYRIGHT
       You may redistribute copies of mftrace under the	terms of the GNU  Gen-
       eral  Public  License <http://www.gnu.org/licenses/gpl.html>.  There is
       NO WARRANTY, to the extent permitted by law.
       This manual page	is copyright (C) 2005,2006,2007	Julian Gilbey  and  is
       distributed under the GNU General Public	License	too.

SEE ALSO
       mf(1), autotrace(1), potrace(1),	fontforge(1).

AUTHOR
       mftrace	was written by Han-Wen Nienhuys	<hanwen@xs4all.nl>.  This man-
       ual page	was originally written by Julian Gilbey	 <jdg@debian.org>  and
       has been	revised	by Werner Lemberg <wl@gnu.org>.

			       January 23, 2007			    MFTRACE(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COPYRIGHT | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mftrace&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help