DLI Implementation and Reference Guide - Datalogics

DLI Reference Guide A.91
Technical Notes
1 Initialization of DLI is now required; support for using DLI without initialization
has been removed. If you intend to use DLI methods in your application, you must
intialize DLI via dlpdfinit. DLI users should initialize the Adobe PDF Library
through the DLI initialization call; PDFLInit and PDFLTerm should never be
directly called from a DLI application.
2 In a multi-threaded application, each thread must do its own initialization and
termination of the Library.
3 This procedure, along with dlpdfterm, replaces the need for calls to PDFLInit
and PDFLTerm. DLI should be initialized, or the Adobe PDF Library, but not
both.
4 You can accidentally call dlpdfinit (the DLI command) multiple times without
problems, as it contains internal code that prevents actual initialization from
occurring more than once, but you cannot call PDFLInit (the Adobe PDF
Library command) more than once as a fatal error will occur.
5 dlpdfinit and dlpdfterm are the only methods which must not be enclosed in
exception handlers (i.e. DURING/HANDLER/END_HANDLER statements), because
they are not set up before initialization, and are freed during termination.
6 As of DLI v3.0.11, the DLI graphics cache has been enhanced to use the default
ASFileSys implementation provided to dlpdfinit for caching graphics. By
default, the graphics cache file size is limited to 1.5GB. Customers who wish to use
larger graphics cache files are advised to supply a filesystem to dlpdfinit which
is capable of reliably handling files of the larger size.
NOTE: The cache size limit is checked every time a document is destroyed; the
cache may therefore temporarily exceed the cache size limit. When setting the
cache size limit, please note that to resize the graphics cache, free space equal to
the sum of the cache limit and the "low water" mark is required. Files In Memory
users with large graphics workloads are advised to lower the cache size limit to a
number appropriate for their target environment.