DLI Implementation and Reference Guide - Datalogics

4.4 DLI Implementation and Reference Guide
glyph identifiers in the embedded font stream. Text is input using the DLPDFCONTENT
text calls as if using a single-byte font.
Concepts and Facilities: Guide to the DL Pager Composition System
Most TrueType and OpenType font files can be used to create either TrueType (singlebyte)
or CIDType2 PDF fonts. In all cases, TrueType and CIDType2 fonts should be
both embedded and subset to ensure reliable results when viewing and printing. In this
chapter, the term "TrueType font" means a PDF TrueType font using a one-byte
encoding, and the term "CIDType2 font" means a TrueType or OpenType font using
GID values to access characters in the PDF file.
Structure of a DLI Font
A font is reflected in the structure DLPDFFONT. These structures are created by the
font creation calls on a per-document basis. They may be used only within the
document they were created with. Fonts are tracked within the document, and
destroyed when the document is destroyed. Pointers to fonts are invalid after the
destruction of their document. All DLPDFFONT structures for a given document will
be released when that document is destroyed. Therefore, methods that use
DLPDFFONT as a parameter (i.e. dlpdfcontenttext, dlpdfcontentwidetext,
dlpdfcontenttextwidth, dlpdfcontentwidetextwidth) must be called
before the document is destroyed
Font Embedding Status
The field DLPDFFONT->NotEmbedded will be TRUE only if a request was made to
subset the font but the request procedure failed. If the font could not embed due to
license restrictions (i.e. the request procedure functioned correctly, but the font itself is
not licensed for embedding), an exception will be raised instead.
Font Subsetting Status
The field DLPDFFONT->SubSetMap will be NULL if a font is not subset. The field
will be not NULL if a font is (or will be) subset.