DLI Implementation and Reference Guide - Datalogics

4.6 DLI Implementation and Reference Guide
for Type 1 fonts first, then TrueType fonts, and finally CID fonts. If no match occurs, the next test in the
sequence below is attempted.
1 The current DLPDFDOC is searched for fonts with the same name and type as requested. If one was
already created, it is returned.
2 If a Base 14 font is requested and is not to be embedded, it is created and returned.
3 If the name is matched in the DLPDFINSTANCE font cache, the font is copied to the current
DLPDFDOC and returned. (This is where fonts loaded via dlpdfttload are processed.)
4 The system is searched for a font of explicit name and type requested by the user. If found, it is created
and returned.
5 The system is searched for a font of explicit name (without regard to type) requested by the user. If
found, it is created and returned.
6 If any font of the same family and typeface style is found, it is created and returned.
If a font using a one-byte encoding is found for this name, its width table in the document’s encoding will
be loaded into the DLPDFFONT->WidthTable. If the document indicates that all fonts are to be
embedded, this font will be embedded and subset if possible. The font structure created will carry all of
the metrics of this font, so that if it is not embedded and is not present on the imaging platform, a
Multiple Master (or "multi-master") font can be used to provide imaging of the document.
The encoding used in this font will be the encoding specified in dlpdfdocsetencoding, if that call has
been used; otherwise it will default depending on the system in use: WinAnsiEncoding will be used on
Windows systems and Adobe standard encoding will be used on UNIX, OS/390 and AS/400 systems.
If dlpdffontcreate is called without a font name, it will raise a genErrBadParm exception ("Bad
Parameters") and exit.
dlpdffontcreateembedded
This method behaves like dlpdffontcreate, except that:
• The font will be embedded (if possible) regardless of the overall document settings.
• If the subset flag is TRUE, the embedded font will be subset.
• If the subset flag is FALSE, the embedded font will not be subset.
NOTE: Type0 fonts must be subset if they are embedded.