SYNOPSIS

[-options] ttffont.ttf [Fontname]

or

[-options] ttffont.ttf -

DESCRIPTION

Ttf2ufm is a font converter from the True Type format (and some other formats supported by the FreeType library as well) to the Adobe Type1 format.

The versions 3.0 and later got rather extensive post-processing algorithm that brings the converted fonts to the requirements of the Type1 standard, tries to correct the rounding errors introduced during conversions and some simple kinds of bugs that are typical for the public domain fonts. It also generates the hints that enable much better rendering of fonts in small sizes that are typical for the computer displays. But everything has its price, and some of the optimizations may not work well for certain fonts. That's why the options were added to the converter, to control the performed optimizations.

OPTIONS

The first variant creates the file (or if the option '-b' was used) with the converted font and with the font metrics, the second one prints the font or another file (if the option '-G' was used) on the standard output from where it can be immediately piped through some filter. If no is specified for the first variant, the name is generated from by replacing the filename suffix.

Most of the time no options are neccessary (with a possible exception of '-e'). But if there are some troubles with the resulting font, they may be used to control the conversion. The options are:

• -a - Include all the glyphs from the source file into the converted file. If this option is not specified then only the glyphs that have been assigned some encoding are included, because the rest of glyphs would be inaccessible anyway and would only consume the disk space. But some applications are clever enough to change the encoding on the fly and thus use the other glyphs, in this case they could benefit from using this option. But there is a catch: the X11 library has rather low limit for the font size. Including more glyphs increases the file size and thus increases the chance of hitting this limit. See for the description of a patch to X11 which fixes this problem.
• -b - Encode the resulting font to produce a ready file.
• -d suboptions - Debugging options. The suboptions are:

  a - Print out the absolute coordinates of dots in outlines. Such a font can not be used by any program (that's why this option is incompatible with '-e') but it has proven to be a valuable debuging information.

  r - Do not reverse the direction of outlines. The fonts have the standard direction of outlines opposite to the Type1 fonts. So they should be reversed during proper conversion. This option may be used for debugging or to handle a font with wrong direction of outlines (possibly, converted in a broken way from a Type1 font). The first signs of the wrong direction are the letters like ``P'' or ``B'' without the unpainted ``holes'' inside.

• -e - Assemble the resulting font to produce a ready file.

  [ S.B.: Personally I don't think that this option is particularly useful. The same result may be achieved by piping the unassembled data through t1asm, the Type 1 assembler. And, anyways, it's good to have the t1utils package handy. But Mark and many users think that this functionality is good and it took not much time to add this option. ]

• -F - Force the Unicode encoding: any type of encoding specified in the font is ignored and the font is treated like it has Unicode encoding. this option is intended for buggy fonts which actually are in Unicode but are marked as something else. The effect on the other fonts is unpredictable.
• -G suboptions - File generation options. The suboptions may be lowercase or uppercase, the lowercase ones disable the generation of particular files, the corresponding uppercase suboptions enable the generation of the same kind of files. If the result of ttf2ufm is requested to be printed on the standard output, the last enabling suboption of -G determines which file will be written to the standard output and the rest of files will be discarded. For example, -G A will request the file. The suboptions to disable/enable the generation of the files are:

  f/F - The font file. Depending on the other options this file will have one of the suffixes , or . If the conversion result is requested on the standard output ('' is used as the output file name) then the font file will also be written there by default, if not overwritten by another suboption of -G. Default: enabled

  a/A - The Adobe font metrics file (). Default: enabled

  e/E - The dvips encoding file (). Default: disabled

• -l language[+argument] - Extract the fonts for the specified language from a multi-language Unicode font. If this option is not used the converter tries to guess the language by the values of the shell variable If it is not able to guess the language by it tries all the languages in the order they are listed.

  After the plus sign an optional argument for the language extractor may be specified. The format of the argument is absolutely up to the particular language converter. The primary purpose of the argument is to support selection of planes for the multi-plane Eastern encodings but it can also be used in any other way. The language extractor may decide to add the plane name in some form to the name of the resulting font. None of the currently supported languages make any use of the argument yet.

  As of now the following languages are supported:

     - for all the languages using the Latin-1 encoding

     - for the Central European languages

     - for the Baltic languages

     - for the Turkish language

     - for the languages with Cyrillic alphabet

     - historic synonym for cyrillic

     - historic synonym for cyrillic

     - for the AdobeStandard encoding used by TeX

    argument - to select one plane from a multi-byte encoding

  The argument of the "" language may be in one of three forms:

    pid=