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

> Встраивание пользовательских шрифтов в слайды PowerPoint с помощью Aspose.Slides for Python через .NET, чтобы ваши презентации оставались чёткими и одинаковыми на любом устройстве.

Source: https://docs.aspose.com/slides/ru/python-net/custom-font/
Updated: 2025-12-30


## **Обзор**

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

Aspose.Slides позволяет загружать следующие шрифты с помощью методов `load_external_font` и `load_external_fonts` класса [FontsLoader](https://reference.aspose.com/slides/python-net/aspose.slides/fontsloader/):

- TrueType (.ttf) и TrueType Collection (.ttc) шрифты. См. [TrueType](https://en.wikipedia.org/wiki/TrueType).
- OpenType (.otf) шрифты. См. [OpenType](https://en.wikipedia.org/wiki/OpenType).

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

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

1. Укажите одну или несколько папок, содержащих файлы шрифтов.
2. Вызовите статический метод [FontsLoader.load_external_fonts](https://reference.aspose.com/slides/python-net/aspose.slides/fontsloader/load_external_fonts/) для загрузки шрифтов из этих папок.
3. Загрузите и отрендерите/экспортируйте презентацию.
4. Вызовите [FontsLoader.clear_cache](https://reference.aspose.com/slides/python-net/aspose.slides/fontsloader/clear_cache/) для очистки кеша шрифтов.

```py
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()
```


{{% alert color="info" title="Note" %}}
[FontsLoader.load_external_fonts](https://reference.aspose.com/slides/python-net/aspose.slides/fontsloader/load_external_fonts/) добавляет дополнительные папки в пути поиска шрифтов, но не изменяет порядок инициализации шрифтов.
Шрифты инициализируются в следующем порядке:

1. Путь шрифтов по умолчанию операционной системы.
1. Пути, загруженные через [FontsLoader](https://reference.aspose.com/slides/python-net/aspose.slides/fontsloader/).
{{%/alert %}}

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

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

Этот пример кода на Python показывает, как использовать `get_font_folders`:
```python
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`:
```python
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 демонстрирует загрузку шрифта из массива байтов:
```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. Если вам нужен шрифт, включённый в файл презентации, необходимо использовать явные [возможности встраивания](/slides/ru/python-net/embedded-font/).

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

Да. Настройте [замена шрифтов](/slides/ru/python-net/font-substitution/), [правила замены](/slides/ru/python-net/font-replacement/), и [наборы резервных шрифтов](/slides/ru/python-net/fallback-font/), чтобы точно определить, какой шрифт использовать, когда запрашиваемый глиф отсутствует.

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

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

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

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