mmafm (1)

Leading comments

-*-nroff-*-

(The comments found at the beginning of the groff file "man1/mmafm.1".)

NAME

mmafm - creates AFM font metrics for multiple master fonts

SYNOPSIS

mmafm [OPTIONS...] font

DESCRIPTION

Mmafm creates AFM font metrics for PostScript multiple master fonts by interpolation. You pass it an AMFM file (multiple master font metrics) and options specifying the design point you want, and it writes the resulting AFM file to the standard output.

Each font argument is either the filename of an AFM or AMFM font metrics file, or a PostScript font name. If you give a font name, mmafm will look up the actual font metrics file using the PSRESOURCEPATH environment variable. This colon-separated path is searched for `PSres.upr' files, an Adobe method for indexing PostScript resources.

You can also give the name of a multiple master font instance, like `MinionMM_367_400_12_'. Mmafm will parse the font name and create that instance for you. `PSres.upr' files must be set up for this to work.

Any multiple master font should be distributed with a single AMFM file and several AFM files (one for each master). For Myriad, for example, the AMFM file is MyriadMM.amfm and the AFM files are MyriadMM-LightCn.afm, MyriadMM-LightSemiEx.afm, MyriadMM-BlackCn.afm, and MyriadMM-BlackSemiEx.afm. Mmafm needs to find all these files to function. For fonts in the Adobe type library, you can download the necessary files from <www.lcdf.org/type>; look for the mm-metrics package.

You must always supply the AMFM file (or its font name) on the command line, but mmafm will look for any required AFM files you don't supply yourself. It tries the PSRESOURCEPATH environment variable, and also looks for files named `FontName.afm' or `FontName.AFM' in the directory that contained the AMFM file. (The Myriad filenames given above fit this pattern.)

Mmafm supports fonts with intermediate masters, like Adobe Jenson and Kepler. If your PSRESOURCEPATH environment variable is set up, it will handle these fonts automatically. Otherwise, you must first run `mmpfb --amcp-info' on the font outline files to create auxiliary AMCP files for these fonts. Each AMCP file should be in the same directory as its corresponding AMFM file and should have the same root filename, but with a `.amcp' extension instead of `.amfm'. See for more information.

EXAMPLE

% mmafm --weight=400 --width=600 MyriadMM.amfm > MyriadMM_400_600_.afm

OPTIONS

Long options may be abbreviated to their unique prefixes.

--output=file, -o file

Send output to file instead of standard output.

--weight=N, -w N

Set the weight axis to N.

--width=N, -W N

Set the width axis to N.

--optical-size=N, -O N

Set the optical size axis to N.

--style=N

Set the style axis to N.

--1=N (--2=N, --3=N, --4=N)

Set the first (second, third, fourth) axis to N.

--precision=N, -p N

Round output numbers so they have at most N digits after the decimal point. Smaller numbers are less precise; `-p 0' rounds all numbers to integers. The default precision is 3.

--min-kern=N, -k N

Only output kerning pairs whose absolute value is N or larger. Smaller minimum kerns make kerning more precise and the output AFM file bigger. The default minimum kern is 2.0.

TROUBLESHOOTING

Some programs, such as TeX's fontinst, can choke on AFM files that include fractional numbers. Therefore, if you have trouble with an AFM file, try rerunning mmafm with the [--precision=0] option.

SEE ALSO

DIAGNOSTICS

Font requires intermediate master conversion programs

You haven't yet created an AMCP file for Font.

AUTHOR

Eddie Kohler, ekohler@gmail.com

The latest version is available from:
www.lcdf.org/type
AMFM and AFM files for Adobe Type Library fonts are also available at that URL.

Thanks to Melissa O'Neill for suggestions and patient debugging.