Firebird Documentation IndexUsing non-Western fonts → 3: Create metrics files
Firebird Home Firebird Home Prev: 2: Override stylesheet fontsFirebird Documentation IndexUp: Using non-Western fontsNext: 4: Create FOP userconfig file

Step 3: Create metrics files

Font collections

For every non-standard font you use, a file with font metrics information must be generated. Apache FOP needs this information while performing the XSL-FO -> PDF conversion. You can create the metrics files with the t1metrics and ttfmetrics targets in our build system. At the command prompt in manual/src/build, type (on one line!):

build ttfmetrics
  -Dff=D:\Path\To\fontfile.ttf -Dmf=filename.xml -Dsfx=xx

to build a TTF metrics file, or

build t1metrics
  -Dff=D:\Path\To\fontfile.pfm -Dmf=filename.xml -Dsfx=xx

for a Type 1 metrics file.

Please note:

Remember that you must repeat this step for every font you add. If the bold and/or italic variations reside in different files, you must also create a separate metrics file for each variation.

Important

Metrics files created with FOP 0.20.5 (which was part of our build tools until April 2007) are not usable with our current FOP version (0.93 or higher). If you have such files in your tree, regenerate them with the latest tool set. Notice however that performing a cvs update may already bring you the current metrics files.

Font collections

Some TrueType fonts are packed together in .ttc files (TrueType collections). The ttcmetrics target allows you to build metrics files for such fonts:

build ttcmetrics -Dcf=D:\Path\To\collection.ttc 
                   -Dfn=fontname -Dmf=filename.xml -Dsfx=xx

The ff (font file) parameter has been replaced with cf (collection file), and there's an additional fn (font name) parameter. To find out which fonts are in a collection, call the ttcmetrics target with only the first parameter, like this:

build ttcmetrics -Dcf=D:\Path\To\collection.ttc

This will result in an exception and a 20-line Java stack trace, but just before that you'll find a list of all the fonts contained in the collection.

Prev: 2: Override stylesheet fontsFirebird Documentation IndexUp: Using non-Western fontsNext: 4: Create FOP userconfig file
Firebird Documentation IndexUsing non-Western fonts → 3: Create metrics files