DLI Implementation and Reference Guide - Datalogics

Fonts 4.7
dlpdffontcreate
This is the basic font access method. It accepts a font name and optionally a font type,
both as strings. When the font type is present, the method will attempt to find a font
which matches both that type and name. If none is found, it will attempt to match the
specified name in any type of font.
Font Searching Sequence
The specific dlpdffontcreate search procedure follows this sequence, in order,
until a font fitting the search parameters is identified. For each test below, the order of
preference when searching for a match is 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