PDFlib 8 Windows COM/.NET Tutorial

TrueType and OpenType fonts. The font name must be connected
to the name of the desired font file via the FontOutline resource:
p.set_parameter("FontOutline", "Arial=/usr/fonts/Arial.ttf");
font = p.load_font("Arial", "unicode", "embedding");
The alias font name to the left of the equal sign can be chosen arbitrarily:
p.set_parameter("FontOutline", "f1=/usr/fonts/Arial.ttf");
font = p.load_font("f1", "unicode", "embedding");
As an alternative to runtime configuration via set_parameter( ), the FontOutline resource
can be configured in a UPR file (see Section 3.1.3, »Resource Configuration and File
Search«, page 62). In order to avoid absolute file names you can use the SearchPath resource
category (again, the SearchPath resource category can alternatively be configured
in a UPR file), for example:
p.set_parameter("SearchPath", "/usr/fonts");
p.set_parameter("FontOutline", "f1=Arial.ttf");
font = p.load_font("f1", "unicode", "");
TrueType Collections. In order to select a font which is contained in a True-
Type Collection (TTC, see Section 6.5.2, »Custom CJK Fonts«, page 174) file you
directly specify the name of the font:
p.set_parameter("FontOutline", "MS-Gothic=msgothic.ttc");
font = p.load_font("MS-Gothic", "unicode", "embedding");
The font name will be matched against the names of all fonts in the TTC file. Alternatively,
to select the n-th font in a TTC file you can specify the number n with a colon after
the font name. In this case the alias font name to the left of the equal sign can be
chosen arbitrarily:
p.set_parameter("FontOutline", "f1=msgothic.ttc");
font = p.load_font("f1:0", "unicode", "");
PostScript Type 1 fonts. The font name must be connected to the name of
the desired font metrics file via one of the FontAFM or FontPFM resource categories
according to the type of the metrics file:
p.set_parameter("FontPFM", "lucidux=LuciduxSans.pfm");
font = p.load_font("lucidux", "unicode", "");
If embedding is requested for a PostScript font, its name must be connected to the corresponding
font outline file (PFA or PFB) via the FontOutline resource category:
p.set_parameter("FontPFM", "lucidux=LuciduxSans.pfm");
p.set_parameter("FontOutline", "lucidux=LuciduxSans.pfa");
font = p.load_font("lucidux", "unicode", "embedding");
Keep in mind that for PostScript Type 1 fonts the FontOutline resource alone is not sufficient.
Since a metrics file is always required an AFM or PFM file must be available in order
to load the font.
The directories which will be searched for font metrics and outline files can be specified
via the SearchPath resource category.
5.4 Loading Fonts 133