PDFlib 8 Windows COM/.NET Tutorial

myencoding=myencoding.enc
.
ICCProfile
highspeedprinter=cmykhighspeed.icc
.
Searching for the UPR resource file. If only the built-in resources (e.g., PDF core font,
built-in encodings, sRGB ICC profile) or system resources (host fonts) are to be used, a
UPR configuration file is not required since PDFlib will find all necessary resources without
any additional configuration.
If other resources are to be used you can specify such resources via calls to set_
parameter( ) (see below) or in a UPR resource file. PDFlib reads this file automatically
when the first resource is requested. The detailed process is as follows:
> If the environment variable PDFLIBRESOURCE is defined PDFlib takes its value as the
name of the UPR file to be read. If this file cannot be read an exception will be
thrown.
> If the environment variable PDFLIBRESOURCE is not defined PDFlib tries to open a file
with the following name:
pdflib.upr
If this file cannot be read no exception will be thrown.
> On Windows PDFlib will additionally try to read the following registry entries which
will be searched in the order provided below:
HKLM\Software\PDFlib\PDFlib8\8.0.6\resourcefile
HKLM\Software\PDFlib\PDFlib8\resourcefile
HKLM\Software\PDFlib\resourcefile
The values of these entries will be taken as the name of the resource file to be used. If
this file cannot be read an exception will be thrown.
Be careful when manually accessing the registry on 64-bit Windows systems: as usual,
64-bit PDFlib binaries will work with the 64-bit view of the Windows registry,
while 32-bit PDFlib binaries running on a 64-bit system will work with the 32-bit view
of the registry. If you must add registry keys for a 32-bit product manually, make
sure to use the 32-bit version of the regedit tool. It can be invoked as follows from the
Start, Run... dialog:
%systemroot%\syswow64\regedit
> The client can force PDFlib to read a resource file at runtime by explicitly setting the
resourcefile parameter:
p.set_parameter("resourcefile", "/path/to/pdflib.upr");
This call can be repeated arbitrarily often; the resource entries will be accumulated.
Configuring resources at runtime. In addition to using a UPR file for the configuration,
it is also possible to directly configure individual resources within the source code via
the set_parameter( ) function. This function takes a category name and a corresponding
resource entry as it would appear in the respective section of this category in a UPR resource
file, for example:
p.set_parameter("FontAFM", "Foobar-Bold=foobb___.afm");
p.set_parameter("FontOutline", "Foobar-Bold=foobb___.pfa");
3.1 General PDFlib Programming Aspects 65