10.6 General Functions 149
(Keyword; not required on Windows) Target encoding for file names. On Windows this option will be ap-
plied to supplied file names, but not to the names of generated files (default: unicode on OS X, auto on
i5/iSeries, otherwise honorlang):
basicebcdic Basic EBCDIC according to code page 1047, but only Unicode values <= U+007E
Basic EBCDIC according to code page 0037, but only Unicode values <= U+007E
honorlang (Not supported on i5/iSeries) The environment variables LC_ALL, LC_CTYPE and LANG will be
interpreted and applied to file names if it specifies utf8, UTF-8, cpXXXX, CPXXXX, iso8859-x, or
Use auto encoding (i.e. the current system encoding) to interpret the file name and interpret
the LANG variable if the honorlang parameter is set.
Unicode encoding in (EBCDIC-) UTF-8 format
all names of 8-bit and CJK encodings
Encoding name according to Section 10.5, »Encoding Names«, page 147
File names supplied in non-Unicode aware language bindings without a UTF-8 BOM and with length=0
are interpreted according to the filenamehandling option.
(List of name strings) A list of string pairs, where each pair contains the name and value of a FontOutline
resource (see Section 5.2, »Resource Configuration and File Searching«, page 61).
(List of name strings) A list of string pairs, where each pair contains the name and value of a glyphlist re-
source (see Section 5.2, »Resource Configuration and File Searching«, page 61).
(List of name strings) A list of string pairs, where each pair contains a PDF font name and the UTF-8 en-
coded name of a host font to be used for an unembedded font.
(String) Set the license key. It must be set before the first call to TET_open_document*( ).
(String) Set the name of a file containing the license key(s). The license file can be set only once before the
first call to TET_open_document*( ). Alternatively, the name of the license file can be supplied in an
environment variable called PDFLIBLICENSEFILE or (on Windows) via the registry.
(Option list; unsupported) An option list specifying logging output according to Table 10.7. Alternatively,
logging options can be supplied in an environment variable called TETLOGGING or on Windows via the
registry. An empty option list will enable logging with the options set in previous calls. If the environment
variable is set logging will start immediately after the first call to TET_new( ).
(Name string; unsupported) Arbitrary string which will be written to the log file if logging is enabled.
(Keyword; only for the C, Ruby, Perl, Python, and PHP language bindings) Specifies the format of the text
returned by TET_get_text( ):
Strings are returned in (in C: null-terminated) UTF-8 format .
Strings are returned in UTF-16 format in the machine’s native byte ordering.
Strings are returned in UTF-32 format in the machine’s native byte ordering.
ebcdicutf8 (Only available on EBCDIC-based systems) Strings are returned in null-terminated EBCDIC-
encoded UTF-8 format. Code page 37 is used on i5/iSeries, code page 1047 on zSeries.
Default: utf8 for C, Ruby, Perl, Python, PHP, and ebcdicutf8 for C on i5/iSeries and zSeries
(Name string) Relative or absolute file name of the UPR resource file. The resource file will be loaded
immediately. Existing resources will be kept; their values will be overridden by new ones if they are set
again. Explicit resource options will be evaluated after entries in the resource file.
The resource file name can also be supplied in the environment variable TETRESOURCEFILE or with a
Windows registry key (see Section 5.2, »Resource Configuration and File Searching«, page 61). Default:
tet.upr (on MVS: upr)
Table 10.2 Global options for TET_set_option( )