Aspose.Slides FOSS
Python
Как создавать презентации в Python

Как создавать презентации в Python

Aspose.Slides FOSS for Python lets you create PowerPoint presentations entirely in Python with no dependency on Microsoft Office. This guide shows how to create a new presentation, add slides and shapes, format text, and save the result.

Пошаговое руководство

Шаг 1: Установите пакет

Установите Aspose.Slides FOSS из PyPI. Требуется Python 3.10 или новее.

pip install aspose-slides-foss

Проверьте установку:

import aspose.slides_foss as slides
print("Aspose.Slides FOSS ready")

Эта lxml зависимость устанавливается автоматически. Другие системные пакеты не требуются.

Шаг 2: Импортировать необходимые модули

Импортируйте пакет и SaveFormat перечисление, необходимое для сохранения.

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

Все константы типов фигур находятся в aspose.slides_foss.ShapeType. Все типы форматирования (FillType, NullableBool) также находятся в aspose.slides_foss.

Шаг 3: Создайте презентацию

Используйте slides.Presentation() в качестве менеджера контекста. Новая презентация начинается с одного пустого слайда.

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

with slides.Presentation() as prs:
    print(f"Slides in new presentation: {len(prs.slides)}")
    # work with prs inside this block
    prs.save("output.pptx", SaveFormat.PPTX)

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

Шаг 4: Получите доступ к слайду

Первый слайд имеет индекс 0. Пустая презентация содержит ровно один слайд.

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

with slides.Presentation() as prs:
    slide = prs.slides[0]  # zero-based index
    print(f"Slide at index 0: {slide}")
    prs.save("output.pptx", SaveFormat.PPTX)

Шаг 5: Добавьте фигуру

Используйте slide.shapes.add_auto_shape() для добавления AutoShape. Параметры: (shape_type, x, y, width, height) все в пунктах (1 пункт = 1/72 дюйма; стандартный слайд — 720 × 540 pt).

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

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Rectangle at (50, 50) with 400 wide and 120 tall
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)

    # Attach a text frame
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

    prs.save("with-shape.pptx", SaveFormat.PPTX)

Шаг 6: Сохраните презентацию

Вызов prs.save(path, SaveFormat.PPTX) перед with выходом из блока. PPTX — единственный поддерживаемый формат вывода.

prs.save("result.pptx", SaveFormat.PPTX)

Файл записывается атомарно; если ошибка происходит до этого вызова, выходной файл не создаётся.

Полный рабочий пример

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

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:
    # --- Slide 1: title shape ---
    slide1 = prs.slides[0]
    title = slide1.shapes.add_auto_shape(ShapeType.RECTANGLE, 40, 40, 640, 80)
    tf = title.add_text_frame("Q1 Results: Executive Summary")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32
    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)

    # --- Slide 2: table ---
    prs.slides.add_empty_slide(prs.layout_slides[0])
    slide2 = prs.slides[1]
    table = slide2.shapes.add_table(40, 40, [200.0, 120.0, 120.0], [40.0, 40.0, 40.0])
    headers = ["Region", "Revenue", "Growth"]
    data = [
        ["North", "$1.2M", "+8%"],
        ["South", "$0.9M", "+4%"],
    ]
    for col, header in enumerate(headers):
        table.rows[0][col].text_frame.text = header
    for row_idx, row_data in enumerate(data):
        for col, cell_text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = cell_text

    prs.save("q1-results.pptx", SaveFormat.PPTX)

print("Saved q1-results.pptx")

Распространённые проблемы и их решения

ResourceWarning: unclosed Presentation

Вы создаёте экземпляр Presentation без with блок. Всегда используйте:

with slides.Presentation() as prs:
    ...

AttributeError: __enter__

Если вы видите эту ошибку, проверьте, что вы импортировали aspose.slides_foss (не aspose.slides). Имя пакета на PyPI: aspose-slides-foss и импорт во время выполнения: aspose.slides_foss.

TypeError: SaveFormat.PPTX is not callable

SaveFormat.PPTX является членом перечисления, а не функцией. Используйте его как prs.save("file.pptx", SaveFormat.PPTX).

Часто задаваемые вопросы

Каков размер слайда по умолчанию?

Новый Presentation() создает слайды стандартного размера 10 × 7.5 дюйма (720 × 540 пунктов). Изменение размера слайда пока не поддерживается в этой версии.

Могу ли я добавить более одного слайда?

Да. Вызовите prs.slides.add_empty_slide(prs.layout_slides[0]) для добавления пустого слайда и доступа к нему по индексу:

prs.slides.add_empty_slide(prs.layout_slides[0])
slide2 = prs.slides[1]

Могу ли я открыть существующий файл и добавить слайды?

Да:

with slides.Presentation("existing.pptx") as prs:
    prs.slides.add_empty_slide(prs.layout_slides[0])
    prs.save("existing.pptx", SaveFormat.PPTX)

В какие форматы я могу сохранять?

Только SaveFormat.PPTX поддерживается. Экспорт в PDF, HTML, SVG или изображения недоступен в этой версии.

См. также

 Русский