Programming PHP

Table 10-3. Standard PDF fonts
Courier Courier-Bold Courier-BoldOblique Courier-Oblique
Helvetica Helvetica-Bold Helvetica-BoldOblique Helvetica-Oblique
Times-Bold Times-BoldItalic Times-Italic Times-Roman
Symbol ZapfDingbats
You can select a font with the pdf_findfont( ) function:
$font = pdf_findfont(pdf, fontname, encoding, embed);
The encoding parameter indicates how the internal numeric codes for characters map
onto the font’s characters. The built-in encodings are "winansi" (Windows, a superset
of ISO 8859-1, which is itself a superset of ASCII), "macroman" (Macintosh),
"ebcdic" (IBM mainframe), "builtin" (for symbol fonts), and "host" ("macroman" on
the Mac, "ebcdic" on EBCDIC-based systems, and "winansi" on everything else).
When using built-in fonts, stick to "host".
You can load nonstandard fonts if you have the PostScript font metrics or TrueType
files. If you want to embed the nonstandard fonts in the PDF file, rather than using
whatever fonts on the viewer’s system most resemble them, set the embed parameter
to 1. You do not need to embed the standard fonts.
Using nonstandard fonts without embedding them makes your documents much less
portable, while embedding them makes your generated PDF files much larger. You
also need to be careful of not violating any font license terms, because some fonts are
not supposed to be embedded. TrueType font files have an indicator that is set if the
font should not be embedded. This is honored by pdflib, which produces an error if
you try to embed such a font.
Embedding Fonts
To use nonstandard fonts, you must tell pdflib where they are with the FontAFM,
FontPFM, orFontOutline parameters. For example, to use a TrueType font, you can
do this:
pdf_set_parameter($p,"FontOutline", "CANDY==/usr/fonts/candy.ttf");
$font = pdf_findfont($p, "CANDY", "host", 1);
The double equals sign in this code tells pdflib that you are specifying an absolute
path. A single equals sign would indicate a path relative to the default font directory.
Instead of using explicit pdf_set_parameter( ) calls each time you want to use a nonstandard
font, you can tell your pdflib installation about these extra fonts by adding
the FontAFM, FontPFM, and FontOutline settings to pdflib’s pdflib.upr file.
Here’s a sample set of additions to the FontAFM and FontOutline sections of the
pdflib.upr file. The line that starts with two slashes (//) indicates the default directory
for font files. The format for the other lines is simply fontname=filename:
244 | Chapter 10: PDF
This is the Title of the Book, eMatter Edition
Copyright © 2002 O’Reilly & Associates, Inc. All rights reserved.