Посібник розробника
У цьому посібнику розглядаються базові можливості Aspose.Slides FOSS для Python з придатними до виконання прикладами коду для кожної області функціоналу.
У цьому розділі
| Сторінка | Опис |
|---|---|
| Функції та можливості | Повний список підтримуваних функцій: слайди, форми, текст, заповнення, ефекти, 3D-форматування, нотатки, коментарі, зображення та властивості документа. |
| Робота з зображеннями | Вбудовуйте зображення у слайди як рамки зображень з файлу або байтів; керуйте режимом заповнення (розтягування, мозаїка). |
| Робота з з’єднувачами | Додавайте вигнуті, кутові та прямі з’єднувачі між формами; встановлюйте точки підключення та стиль лінії. |
| Робота з 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 посилання поза with блок.
Підтримуваний формат виводу
Єдиний підтримуваний формат збереження — PPTX (SaveFormat.PPTX). Експорт у PDF, HTML, SVG або формати зображень недоступний у цій версії.
Ключові класи
| Клас / Перерахування | Шлях імпорту | Опис |
|---|---|---|
Presentation | aspose.slides_foss | Кореневий контейнер; використовуйте як менеджер контексту |
ShapeType | aspose.slides_foss | Перерахування типів фігур (RECTANGLE, ELLIPSE, …) |
FillType | aspose.slides_foss | Перелічення типів заповнення (SOLID, GRADIENT, …) |
NullableBool | aspose.slides_foss | Трирозрядний bool для форматування (TRUE, FALSE, NOT_DEFINED) |
SaveFormat | aspose.slides_foss.export | Перелічення форматів виводу (only PPTX supported) |
Color | aspose.slides_foss.drawing | Конструктор кольору ARGB |
PointF | aspose.slides_foss.drawing | Float 2D точка (використовується для позицій коментарів) |
Відомі обмеження
Наступні області піднімаються NotImplementedError у цьому випуску:
- Діаграми: створення та модифікація діаграм не підтримуються
- SmartArt: не підтримується
- Анімації та переходи: переходи слайдів та анімації об’єктів не можна задати
- Формати експорту: підтримується лише збереження у форматі PPTX; експорт у PDF, HTML, SVG або зображення не підтримується
- Гіперпосилання та налаштування дій: об’єкти посилань не можна змінювати
- VBA‑макроси та цифрові підписи: недоступно
Невідомі XML‑частини, виявлені під час завантаження, зберігаються дослівно при збереженні, тому при повторному завантаженні вміст, який бібліотека ще не розуміє, ніколи не видаляється.
Див. також
- Початок роботи: Встановлення та перший скрипт
- Довідник API: Довідник класів і методів
- Посібники «Як це зробити»: Статті‑підручники, орієнтовані на завдання