PDFlib Text Extraction Toolkit (TET) Manual

tet/3.0/resource
/tet/3.0/resource/cmap
On MVS the searchpath feature is not supported.
Searching for the UPR resource file. If resource files are to be used you can specify
them via calls to TET_set_option( ) (see below) or in a UPR resource file. TET reads this file
automatically when the first resource is requested. The detailed process is as follows:
> If the environment variable TETRESOURCEFILE is defined TET 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 TETRESOURCEFILE is not defined, TET tries to open a file
with the following name:
upr (on MVS; a dataset is expected)
/tet/3.0/tet.upr (on iSeries)
tet.upr (Windows, Unix, and all other systems)
If this file cannot be read no exception will be thrown.
> On Windows TET will additionally try to read the following registry entry:
HKLM\SOFTWARE\PDFlib\TET\3.0\resourcefile
The value of this key (which will be created with the value /tet.upr by the
TET installer, but can also be created by other means) will be taken as the name of the
resource file to be used. If this file cannot be read an exception will be thrown.
> The client can force TET to read a resource file at runtime by explicitly setting the
resourcefile option:
TET_set_option(tet, "resourcefile=/path/to/tet.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 at runtime via TET_set_
option( ). This function takes a resource category name and pairs of corresponding resource
names and values as it would appear in the respective section of this category in
a UPR resource file, for example:
TET_set_option(tet, "glyphlist={myglyphnames=/usr/local/glyphnames.gl}");
Multiple resource names can be configured in a single option list for a resource category
option (but the same resource category option cannot be repeated in a single call to TET_
set_option( )). Alternatively, multiple calls can be used to accumulate resource settings.
Escape sequences for text files. Escape sequences are supported in all text files except
UPR files and CMap files. Special character sequences can be used to include unprintable
characters in text files. All sequences start with a backslash ’\’ character:
> \x introduces a sequence of two hexadecimal digits (0-9, A-F, a-f), e.g. \x0D
> \nnn denotes a sequence of three octal digits (0-7), e.g. \015. The sequence \000 will be
ignored.
> The sequence \\ denotes a single backslash.
> A backslash at the end of a line will cancel the end-of-line character.
5.2 Resource Configuration and File Searching 53