Введение

Aspose.Slides FOSS for Python теперь доступен на PyPI: бесплатная библиотека с лицензией MIT для создания, чтения и редактирования файлов PowerPoint .pptx полностью на Python, без зависимости от Microsoft Office или какого‑либо проприетарного runtime.

Библиотека предназначена для разработчиков, которым необходимо программно генерировать или манипулировать файлами презентаций: автоматизировать наборы слайдов из данных, извлекать текст и метаданные из загруженных файлов PPTX, строить конвейеры отчетности на основе презентаций или встраивать создание презентаций в веб‑приложения. Поскольку aspose-slides-foss написана полностью на Python и имеет только lxml в качестве зависимости, она развертывается одинаково на Windows, macOS, Linux и в Docker‑контейнерах.

Ключевые особенности

  • Полная поддержка обратного цикла PPTX: Откройте любой файл .pptx, измените его содержимое и сохраните обратно, не теряя неизвестные XML‑части, которые библиотека пока не понимает.
  • Управление слайдами: Добавляйте, удаляйте и перебирайте слайды с помощью prs.slides; презентация начинается с одного пустого слайда после slides.Presentation().
  • AutoShape, таблицы и соединители: Вставляйте фигуры через slide.shapes.add_auto_shape(), табличные данные через slide.shapes.add_table() и визуальные соединители между фигурами через slide.shapes.add_connector().
  • Форматирование текста с богатым набором: Форматируйте текст на уровне символов с помощью PortionFormat: размер шрифта, полужирный, курсив, подчеркивание и цвет ARGB через FillType.SOLID и Color.from_argb().
  • Типы заливки: Применяйте заливки FillType.SOLID, GRADIENT, PATTERN или PICTURE к любой фигуре.
  • Визуальные эффекты: Внешняя тень, сияние, мягкий край, размытие, отражение и внутренняя тень через shape.effect_format.
  • 3D‑форматирование: Фаска, камера, система освещения, материал и глубина выдавливания через shape.three_d_format.
  • Заметки докладчика: Прикрепляйте текст заметок к каждому слайду через notes_slide_manager.add_notes_slide().
  • Ветвящиеся комментарии: Добавляйте комментарии с метаданными автора и позицией на слайде.
  • Встроенные изображения: Встраивайте из пути к файлу, байтов или потока io.BytesIO.
  • Свойства документа: Читайте и записывайте основные, приложенческие и пользовательские свойства.

Начало работы

Установите из PyPI. Требуется Python 3.10 или новее; lxml устанавливается автоматически.

pip install aspose-slides-foss

Создайте свою первую презентацию с фигурой и сохраните её:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")
    prs.save("hello.pptx", SaveFormat.PPTX)

Всегда используйте Presentation внутри блока with; это гарантирует освобождение всех внутренних ресурсов при выходе из блока.

Пример форматирования текста

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    shape = prs.slides[0].shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold heading in corporate blue")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 28
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)
    prs.save("formatted.pptx", SaveFormat.PPTX)

Текущие ограничения

В следующих областях возникает NotImplementedError в этом выпуске:

  • Диаграммы, SmartArt и OLE‑объекты
  • Анимации и переходы слайдов
  • Экспорт в PDF, HTML, SVG или графические форматы
  • Гиперссылки, настройки действий, макросы VBA и цифровые подписи

Неизвестные XML‑части, обнаруженные при загрузке, сохраняются дословно при сохранении, поэтому PPTX‑файлы, созданные другими инструментами, безопасно проходят цикл загрузки‑сохранения.

См. также