22.03.2015 Views

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

2.10 <strong>DLI</strong> <strong>Implementation</strong> <strong>and</strong> <strong>Reference</strong> <strong>Guide</strong><br />

this occurs, neither <strong>DLI</strong> nor the Adobe PDF Library should be used, <strong>and</strong> if possible,<br />

the calling program should cease execution as soon as is feasible.<br />

Concepts <strong>and</strong> Facilities: <strong>Guide</strong> to the DL Pager Composition System<br />

Specifying an Alternate File System<br />

The ASFileSys passed to dlpdfinit as its second argument will typically be either<br />

NULL (specifying that the user has no preference for how <strong>DLI</strong> manages file input <strong>and</strong><br />

output) or the dlpdfmemfilesys call. Calling dlpdfmemfilesys will return the<br />

ASFileSys record to the <strong>Datalogics</strong> memory file system for the Adobe PDF Library.<br />

This file system keeps temporary files in memory, instead of on disk, resulting in<br />

significantly improved processing speeds on some systems. You can create your own<br />

ASFileSys <strong>and</strong> pass it in, if you wish more control over how files are manipulated.<br />

NOTE: The included fonts must still be read from disk, <strong>and</strong> the PDF document<br />

which is created will be written to a disk file, unless the steps described in<br />

"Writing PDF Output to Memory" are taken. If the user has the means to specify<br />

an alternative file system, that too may be passed into dlpdfinit.<br />

Using a Graphics Cache<br />

As of <strong>DLI</strong> v3.0.11, the <strong>DLI</strong> graphics cache has been enhanced to use the default<br />

ASFileSys implementation provided to dlpdfinit for caching graphics. By<br />

default, the graphics cache file size is limited to 1.5GB. Customers who wish to use<br />

larger graphics cache files are advised to supply a filesystem to dlpdfinit which is<br />

capable of reliably h<strong>and</strong>ling files of the larger size.<br />

NOTE: The cache size limit is checked every time a document is destroyed; the<br />

cache may therefore temporarily exceed the cache size limit. When setting the<br />

cache size limit, please note that to resize the graphics cache, free space equal to<br />

the sum of the cache limit <strong>and</strong> the "low water" mark is required. Files In Memory<br />

users with large graphics workloads are advised to lower the cache size limit to a<br />

number appropriate for their target environment.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!