Руководство разработчика

Это руководство охватывает основные возможности Aspose.Slides FOSS для Python с исполняемыми примерами кода для каждой области функций.

В этом разделе

СтраницаОписание
Возможности и функцииПолный список поддерживаемых функций: slides, shapes, text, fill, effects, 3D formatting, notes, comments, images и document properties.
Работа с изображениямиВстраивание изображений в slides в виде picture frames из файла или байтов; управление fill mode (stretch, tile).
Работа с ConnectorsДобавление изогнутых, угловых и прямых соединителей между shapes; установка connection sites и line style.
Работа с 3D-эффектамиПрименяйте внешнюю тень, свечение, размытие, фаску, предустановки камеры, световые установки и материалы к формам.
Работа с комментариямиДобавляйте ветвящиеся комментарии к обзору и заметки докладчика; управляйте авторами комментариев; читайте аннотации.

Точка входа API

Каждая операция начинается с Presentation объекта. Всегда используйте его как менеджер контекста:

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

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

Менеджер контекста гарантирует, что внутренние ресурсы COM/XML освобождаются при выходе из блока. Не храните Presentation ссылку за пределами the with блок.

Поддерживаемый формат вывода

Единственный поддерживаемый формат сохранения — PPTX (SaveFormat.PPTX). Экспорт в PDF, HTML, SVG или форматы изображений недоступен в этой версии.

Ключевые классы

Класс / ПеречислениеПуть импортаОписание
Presentationaspose.slides_fossКорневой контейнер; используйте как менеджер контекста
ShapeTypeaspose.slides_fossПеречисление типов фигур (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossПеречисление типов заливки (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossТрёхсостояний булево значение для форматирования (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportПеречисление форматов вывода (поддерживается только PPTX)
Coloraspose.slides_foss.drawingКонструктор цвета ARGB
PointFaspose.slides_foss.drawingДвумерная точка с плавающей запятой (используется для позиций комментариев)

Известные ограничения

Следующие области вызывают NotImplementedError в этом издании:

  • Диаграммы: создание и изменение диаграмм недоступно
  • SmartArt: не поддерживается
  • Анимации и переходы: переходы слайдов и анимацию объектов нельзя установить
  • Форматы экспорта: поддерживается только сохранение в PPTX; экспорт в PDF, HTML, SVG или изображения не поддерживается
  • Гиперссылки и настройки действий: объекты ссылок нельзя изменять
  • Макросы VBA и цифровые подписи: недоступно

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

См. также

 Русский