DLI Implementation and Reference Guide - Datalogics

Multibyte Text Work 5.3
Loading and Creating Fonts
To use the enhanced DLI text functionality, fonts must first be loaded into a
DLPDFINSTANCE, then created using the dlpdffontcreate calls.
dlpdfttload
Loading the font is done using the dlpdfttload function. This call accepts
TrueType, OpenType and TrueType collection files.
NOTE: Adobe CFF OpenType font files are not properly subset at this time. The
sample “WideText” on page 17.21 shows the recommended usage for these fonts,
using the DLPDFCONTENT multibyte text handling.
int dlpdfttload (DLPDFINSTANCE, ASFile, ASAtom[], int)
• The first argument provides a DLPDFINSTANCE into which the font is loaded; once
that is done, any document using the instance may create the font.
• The second argument is a font file, supplied as an ASFile for the second
parameter; please see the sample “WideText” on page 17.21 for an example of
creating an ASFile from a file on disk.
• The third argument is an array of ASAtoms. Because a font file may contain more
than one font, the caller must supply an array of ASAtoms as the third parameter.
• The fourth argument is the number of array entries. The dlpdfttload function
will fill the array with ASAtoms of the fonts loaded, up to the size of the ASAtom
array. If the array is too small to hold all the font names, the additional fonts will
still be loaded, but the names will not be returned. Datalogics recommends that this