Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 11.1 11.2 11.3 11.4 11.5 12.0 12.1 12.2 12.3 12.4 Statistic FMM Blog
Fills an alternate font list created by DynaPDF.CreateAltFontList with data.
|DynaPDF||12.0||✅ Yes||✅ Yes||✅ Yes||✅ Yes||✅ Yes|
|The PDF reference returned from DynaPDF.New.|
|ListHandle||The handle for the list.
Returned by DynaPDF.DeleteAltFontList function.
|FontNames||The list of font names.||"Helvetica¶Times"|
Returns OK or error.
DescriptionFills an alternate font list created by DynaPDF.CreateAltFontList with data.
Alternate font list are tested if one more glyphs were not found in the current font. Since the fonts in the list are used as fallback they should be compatible to the active font in regard to properties like serif, sans serif, proportional or fixed pitch, and so on.
A list should be sorted by priority and not by name. That means index 0 should contain a font name that is most probably the best match. If this one was not available or incompatible then the next font in the list will be tested until the end of the list was reached. If no suitable font was found then system fonts are tested.
The fonts in the list should support the language that must be output. Otherwise, the fonts can never be selected. An alternate font list can be arbitrary large but it is usually best to restrict the number fonts in a list to speed up processing.
A list can contain font names which are not available on the system. This causes no error. Non existing fonts are simply ignored. This makes it possible to define suitable alternate font lists statically. Such lists can then be loaded on demand.
After a list was filled with data it can be activated with DynaPDF.ActivateAltFontList. If a list is no longer needed delete it with DynaPDF.DeleteAltFontList.
Please note that alternate font lists are used only, if complex text layout was enabled. This can be done by setting the flag ComplexText with DynaPDF.SetGStateFlags.
See also SetAltFonts function in DynaPDF manual.
- Version 12.0
Created 23th December 2021, last changed 17th July 2022
Feedback: Report problem or ask question.