Настройка шрифтов PowerPoint в Python

Обзор

Aspose.Slides for Python позволяет предоставлять пользовательские шрифты во время выполнения, чтобы презентации отображались корректно, даже если требуемые шрифты не установлены в системе. При экспорте в PDF или изображения вы можете указать папки со шрифтами или данные шрифтов в памяти, чтобы сохранить расположение текста, метрики глифов и типографику. Это делает серверный рендеринг предсказуемым в разных окружениях, устраняет зависимости от шрифтов операционной системы и предотвращает непреднамеренные подстановки или переломы текста. В статье показано, как зарегистрировать источники шрифтов.

Aspose.Slides позволяет загружать следующие шрифты с помощью методов load_external_font и load_external_fonts класса FontsLoader:

TrueType (.ttf) и TrueType Collection (.ttc) шрифты. См. TrueType.
OpenType (.otf) шрифты. См. OpenType.

Загрузка пользовательских шрифтов

Aspose.Slides позволяет загружать шрифты, используемые в презентации, без их установки в системе. Это влияет на вывод при экспорте — такие форматы, как PDF, изображения и другие поддерживаемые форматы — так что получающиеся документы выглядят одинаково в разных окружениях. Шрифты загружаются из пользовательских каталогов.

Укажите одну или несколько папок, содержащих файлы шрифтов.
Вызовите статический метод FontsLoader.load_external_fonts для загрузки шрифтов из этих папок.
Загрузите и отрендерите/экспортируйте презентацию.
Вызовите FontsLoader.clear_cache для очистки кеша шрифтов.

import aspose.slides as slides

# Определите папки, содержащие пользовательские файлы шрифтов.
font_folders = [ external_font_folder1, external_font_folder2 ]

# Загрузите пользовательские шрифты из указанных папок.
slides.FontsLoader.load_external_fonts(font_folders)

with slides.Presentation("sample.pptx") as presentation:
    # Отрендерите/экспортируйте презентацию (например, в PDF, изображения или другие форматы), используя загруженные шрифты.
    presentation.save("output.pdf", slides.export.SaveFormat.PDF)

# Очистите кеш шрифтов после завершения работы.
slides.FontsLoader.clear_cache()

Note

FontsLoader.load_external_fonts добавляет дополнительные папки в пути поиска шрифтов, но не изменяет порядок инициализации шрифтов. Шрифты инициализируются в следующем порядке:

Путь шрифтов по умолчанию операционной системы.
Пути, загруженные через FontsLoader.

Получить папку пользовательских шрифтов

Aspose.Slides предоставляет метод get_font_folders для получения папок шрифтов. Он возвращает как папки, добавленные через load_external_fonts, так и системные папки шрифтов.

Этот пример кода на Python показывает, как использовать get_font_folders:

import aspose.slides as slides

# Этот вызов возвращает папки, проверяемые на наличие файлов шрифтов.
# Они включают папки, добавленные через метод load_external_fonts, и системные папки шрифтов.
font_folders = slides.FontsLoader.get_font_folders()

Указание пользовательских шрифтов для презентации

Aspose.Slides предоставляет свойство document_level_font_sources, которое позволяет указывать внешние шрифты для использования в презентации.

Следующий пример кода на Python демонстрирует, как использовать document_level_font_sources:

import aspose.slides as slides

with open("CustomFont1.ttf", "br") as font1_stream:
    font1_data = font1_stream.read()
    
with open("CustomFont2.ttf", "br") as font2_stream:
    font2_data = font2_stream.read()

load_options = slides.LoadOptions()
load_options.document_level_font_sources.font_folders = ["assets\\fonts", "global\\fonts"] 
load_options.document_level_font_sources.memory_fonts = [font1_data, font2_data]

with slides.Presentation("Fonts.pptx", load_options) as presentation:
    # ...
    # Работа с презентацией.
    # CustomFont1, CustomFont2 и шрифты из папок assets\fonts и global\fonts (а также их подпапок) доступны для презентации.
    # ...
    print(len(presentation.slides))

Загрузка внешних шрифтов из бинарных данных

Aspose.Slides предоставляет метод load_external_font для загрузки внешних шрифтов из бинарных данных.

Следующий пример кода на Python демонстрирует загрузку шрифта из массива байтов:

import aspose.slides as slides

def read_all_bytes(file_path):
    with open(file_path, "rb") as file_stream:
        file_data = file_stream.read()
    return file_data

# Загрузить внешние шрифты из массивов байтов.
slides.FontsLoader.load_external_font(read_all_bytes("ARIALN.TTF"))
slides.FontsLoader.load_external_font(read_all_bytes("ARIALNBI.TTF"))
slides.FontsLoader.load_external_font(read_all_bytes("ARIALNI.TTF"))

try:
    with slides.Presentation() as presentation:
        # Внешние шрифты доступны в течение срока жизни этого экземпляра презентации.
        print("processing")
finally:
    slides.FontsLoader.clear_cache()

FAQ

Влияют ли пользовательские шрифты на экспорт во все форматы (PDF, PNG, SVG, HTML)?

Да. Подключённые шрифты используются рендерером во всех форматах экспорта.

Встраиваются ли пользовательские шрифты автоматически в получающийся PPTX?

Нет. Регистрация шрифта для рендеринга не равна его встраиванию в PPTX. Если вам нужен шрифт, включённый в файл презентации, необходимо использовать явные возможности встраивания.

Могу ли я контролировать поведение резервного шрифта, когда пользовательский шрифт не содержит некоторых глифов?

Да. Настройте замена шрифтов, правила замены, и наборы резервных шрифтов, чтобы точно определить, какой шрифт использовать, когда запрашиваемый глиф отсутствует.

Могу ли я использовать шрифты в контейнерах Linux/Docker без их системной установки?

Да. Указывайте свои собственные папки со шрифтами или загружайте шрифты из массивов байтов. Это устраняет любую зависимость от системных каталогов шрифтов в образе контейнера.

А как насчёт лицензирования — могу ли я встраивать любой пользовательский шрифт без ограничений?

Вы несёте ответственность за соблюдение лицензий шрифтов. Условия различаются; некоторые лицензии запрещают встраивание или коммерческое использование. Всегда проверяйте лицензионное соглашение (EULA) шрифта перед распространением результатов.

Настройка шрифтов по умолчанию в презентациях с помощью Python