Укажите расположение шрифтов TrueType
В этом разделе описывается поведение Aspose.Words по умолчанию при поиске шрифтов TrueType, включая различия в операционной системе, и демонстрируется, как указать пользовательские источники шрифтов.
Класс FontSourceBase используется для указания различных источников шрифтов. Существует несколько реализаций класса FontSourceBase:
Подробности реализации для некоторых классов описаны ниже.
Загрузка шрифтов из системы
Существует специальный класс SystemFontSource, который всегда используется по умолчанию. Он представляет все шрифты TrueType, установленные в системе. Таким образом, можно создать список источников с SystemFontSource и любыми другими необходимыми источниками:
По умолчанию в FontSettings определен один экземпляр класса SystemFontSource. В разных операционных системах шрифты могут располагаться в разных местах. Однако использование экземпляра FontSettings для каждого документа не является оптимальным решением. В большинстве случаев использования default_instance должно быть достаточно.
Отдельные экземпляры для каждого документа нужны только в том случае, если требуется использовать разные источники шрифтов для разных документов, что является редким случаем. Использование нескольких экземпляров FontSettings снижает производительность, поскольку они не используют общий кэш.
Где Aspose.Words Ищет TrueType Шрифты в Windows
В большинстве случаев Windows пользователи не сталкиваются с серьезными проблемами, связанными с пропущенными шрифтами или неправильным расположением. Как правило, Aspose.Words просматривает документ и, обнаружив ссылку на шрифт, успешно извлекает данные о шрифте из системной папки.
В Windows, Aspose.Words сначала используются все доступные шрифты из папки _%windir%\Fonts. Эта настройка будет работать для вас большую часть времени. Вы можете указать свои собственные папки шрифтов только в том случае, если это необходимо. Aspose.Words для .NET также выполняется поиск дополнительных шрифтов, зарегистрированных в разделе реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts. Кроме того, Windows 10 позволяет установить шрифты для текущего пользователя. Шрифты помещаются в папку %userprofile%\AppData\Local\Microsoft\Windows\Fonts и также указываются в реестре HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Fonts, где Aspose.Words будет искать эти шрифты.
Если документ содержит встроенные шрифты, Aspose.Words может считывать соответствующие данные о шрифтах из документа и использовать их для создания макета документа. Документы также могут содержать ссылки на шрифты, которых нет в системных папках, и в этом случае могут сработать следующие сценарии:
- Пользователи могут настраивать новые источники шрифтов с помощью класса FontSettings
- Aspose.Words можно попробовать заменить пропущенный шрифт на аналогичный
Шрифты в системах, отличных отWindows
Aspose.Words будет искать шрифты в системных папках шрифтов. Список этих папок можно просмотреть с помощью метода SystemFontSource.get_system_font_folders. Если поддерживаемые шрифты не найдены, Aspose.Words будет использовать встроенный шрифт по умолчанию Fanwood.ttf.
Поскольку параметры шрифта Windows и шрифта, отличного от Windows OS, различны, Aspose.Words делает все возможное, чтобы найти похожий шрифт и создать макет, аналогичный оригиналу. Однако это не всегда возможно. В этих случаях класс FontSettings следует использовать для добавления пользовательских шрифтов или правил подстановки.
Где Aspose.Words Ищет TrueType Шрифты в Linux
В разных дистрибутивах Linux шрифты могут храниться в разных папках. Aspose.Words поиск шрифтов осуществляется в нескольких местах. По умолчанию Aspose.Words выполняет поиск шрифтов во всех следующих местах: /usr/share/fonts /usr/local/share/fonts /usr/X11R6/lib/X11/fonts. Это поведение по умолчанию будет работать для большинства дистрибутивов Linux, но не гарантируется, что оно будет работать постоянно, и в этом случае вам может потребоваться явно указать расположение шрифтов true type. Для этого вам необходимо знать, где установлены шрифты TrueType в вашем дистрибутиве Linux.
Где Aspose.Words Ищет TrueType Шрифты в Mac OS X
Aspose.Words выполняет поиск шрифтов в папке /Library/Fonts, которая является стандартным расположением для TrueType шрифтов в Mac OS X. Хотя эта настройка будет работать для вас большую часть времени, в случае необходимости вам может потребоваться указать свои собственные папки со шрифтами.
Загрузка шрифтов из папки
Если обрабатываемый документ содержит ссылки на шрифты, которых нет в системе, или вы не хотите добавлять их в системную папку, или у вас нет прав доступа, то лучшим решением будет добавить папку с вашими собственными шрифтами, используя метод FontSettings.set_fonts_sources. Это позволит заменить системный источник на пользовательский. Aspose.Words больше не будет искать шрифты в реестре или в папке Windows\Font, а вместо этого будет сканировать шрифты только в указанных папках. Метод FontSettings.get_font_sources вернет соответствующие значения.
Указание одной или нескольких папок шрифтов
Методы FontSettings.set_fonts_folder и FontSettings.set_fonts_folders являются сокращениями к методу FontSettings.set_font_sources с одним или несколькими экземплярами FolderFontSource. Эти методы используются для указания того, где Aspose.Words следует искать шрифты. Если папка не существует или недоступна, Aspose.Words просто игнорирует эту папку. Если все папки, включая исходные тексты для замены шрифта, были проигнорированы, Aspose.Words будет использовать шрифт Fanwood по умолчанию.
В следующем примере показано, как задать папку или источник, которые Aspose.Words впоследствии будет использовать для поиска шрифтов TrueType во время рендеринга или встраивания шрифтов:
Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.
Дополнительный логический параметр определяет, будут ли шрифты проверяться рекурсивно по всем папкам, следовательно, будут проверяться все дочерние папки указанной папки. В следующем примере показано, как задать Aspose.Words для поиска шрифтов TrueType в нескольких папках при рендеринге или внедрении шрифтов:
Обратите внимание на приоритеты. Если в разных источниках шрифтов есть шрифты с одинаковым названием семейства и стилем, то Aspose.Words выберет шрифт из источника с более высоким приоритетом. Смотрите описание поля “приоритет” ниже.
Если вы вообще не хотите использовать системные шрифты, Aspose.Words позволяет вам игнорировать их и использовать только свои собственные шрифты:
Приоритетное свойство
Свойство priority используется, когда в разных источниках шрифтов есть шрифты с одинаковым названием семейства и стилем. В этом случае Aspose.Words выбирает шрифт из источника с более высоким значением приоритета. Например, в системной папке есть старая версия шрифта, а клиент добавил новую версию того же шрифта в пользовательскую папку.
Получение списка доступных шрифтов
Если вы хотите получить список доступных шрифтов, которые, например, могут быть использованы для рендеринга документа PDF, вы можете использовать метод get_available_fonts, как показано в следующем примере кода. Класс PhysicalFontInfo определяет информацию о физическом шрифте, доступном для движка шрифтов Aspose.Words: