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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

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

dlpdftextdestroy<br />

After placing the DLPDFTEXT area, or after finishing with any DLPDFTEXT area,<br />

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

destroy the text area with the dlpdftextdestroy function call:<br />

void dlpdftextdestroy (DLPDFTEXT *)<br />

After destroying a DLPDFTEXT area, the memory for the text <strong>and</strong> other information is<br />

released, <strong>and</strong> the text area may no longer be used by an application.<br />

Performance Considerations<br />

The Unicode <strong>and</strong> multibyte functions in <strong>DLI</strong> described above represent an order of<br />

magnitude of performance improvements <strong>and</strong> run-time memory usage. In addition,<br />

<strong>Datalogics</strong> can offer some notes <strong>and</strong> tips on performance <strong>and</strong> other considerations:<br />

• Do not create separate DLPDFCONTENT areas for each DLPDFTEXT string. In<br />

general, each DLPDFCONTENT area created represents additional overhead during<br />

both creation <strong>and</strong> processing of a PDF file, increased file size, <strong>and</strong> slower rendering<br />

of a PDF page. Best performance is usually obtained by using one DLPDFCONTENT<br />

area per page, <strong>and</strong> pasting all content into this content area.<br />

• Avoid using both single-byte <strong>and</strong> multibyte versions of fonts. This results in<br />

increased creation time to subset two different fonts, as well as slower rendering<br />

<strong>and</strong> processing of PDF files.<br />

• If you are typesetting in Chinese, Japanese or Korean, <strong>and</strong> are certain that readers<br />

of a PDF file will have the appropriate Acrobat language pack installed for their<br />

reader, consider using the Adobe OpenType fonts (subtype 0 CID fonts), <strong>and</strong> not<br />

embedding or subsetting. Though you will not be able to use the functionality<br />

described in this chapter, this could prove to generate faster <strong>and</strong> smaller PDF files.<br />

See the WideText sample application included beginning with the <strong>DLI</strong> v3.0.4<br />

release for a demonstration of how to set Unicode text using these fonts.

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

Saved successfully!

Ooh no, something went wrong!