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.8 <strong>DLI</strong> <strong>Implementation</strong> <strong>and</strong> <strong>Reference</strong> <strong>Guide</strong><br />

defaults to 3 (PDF v1.3, for Adobe Acrobat v4 compatibility). If higher-level functions<br />

are used within the output PDF document, the pdfMinorVer will be incremented as<br />

appropriate to 4 or 5 (PDF v1.4 or PDF v1.5 respectively). You can force the declared<br />

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

Compliance Level by assigning the value you desire to pdfMinorVer within your<br />

application.<br />

Files In Memory Activation<br />

To increase the throughput of PDF generation, memory-mapped files may be used for<br />

temporary storage <strong>and</strong> for final output of the PDF content. Output of a PDF file to<br />

both memory <strong>and</strong> disk is also supported for environments where this feature is<br />

desired.<br />

In order to utilize Files In Memory (FIM), <strong>DLI</strong> must be initialized through the<br />

dlpdfinit function call, <strong>and</strong> the <strong>Datalogics</strong> memory file system must be passed to<br />

this function call. The memory file system may be obtained by calling the<br />

dlpdfmemfilesys function, detailed below (see “dlpdfmemfilesys” on page<br />

2.11). This may be called before <strong>DLI</strong> (<strong>and</strong>, hence, the Adobe PDF Library) is<br />

initialized. Once set, storage of temporary files in memory is automatic.<br />

The <strong>DLI</strong> sample applications accompanying this release demonstrate the coding <strong>and</strong><br />

use of Files In Memory. It can be invoked by adding the comm<strong>and</strong>-line argument<br />

MEMORY when calling the sample applications.<br />

Initializing <strong>and</strong> Terminating via <strong>DLI</strong><br />

The following comm<strong>and</strong>s should be used to initialize <strong>and</strong> terminate the Adobe PDF<br />

Library <strong>and</strong> <strong>DLI</strong>. In a single-threaded application, the initialization <strong>and</strong> termination<br />

processes must be called only once during the life of the application. Attempting to<br />

initialize the Adobe PDF Library <strong>and</strong> <strong>DLI</strong> more than once in the application may<br />

cause errors or unpredictable behavior, <strong>and</strong> is not supported. (You are free to create<br />

multiple documents <strong>and</strong>/or multiple files within the run, but the initialization <strong>and</strong>

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

Saved successfully!

Ooh no, something went wrong!