Aspose.Slides FOSS
Python
Jak tworzyć prezentacje w Pythonie

Jak tworzyć prezentacje w Pythonie

Aspose.Slides FOSS for Python pozwala tworzyć prezentacje PowerPoint w całości w języku Python, bez zależności od Microsoft Office. Ten przewodnik pokazuje, jak utworzyć nową prezentację, dodać slajdy i kształty, sformatować tekst oraz zapisać wynik.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

Zainstaluj Aspose.Slides FOSS z PyPI. Wymagany jest Python 3.10 lub nowszy.

pip install aspose-slides-foss

Sprawdź instalację:

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

Zależność lxml jest instalowana automatycznie. Żadne inne pakiety systemowe nie są wymagane.

Krok 2: Importuj wymagane moduły

Zaimportuj pakiet i wyliczenie SaveFormat potrzebne do zapisu.

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

Wszystkie stałe typu kształtu znajdują się w aspose.slides_foss.ShapeType. Wszystkie typy formatowania (FillType, NullableBool) znajdują się również w aspose.slides_foss.

Krok 3: Utwórz prezentację

Użyj slides.Presentation() jako menedżera kontekstu. Nowa prezentacja zaczyna się od jednego pustego slajdu.

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)

Ważne: Zawsze otwieraj i używaj Presentation wewnątrz bloku with. Nie przechowuj referencji poza instrukcją with; zasoby nie zostaną zwolnione prawidłowo.

Krok 4: Uzyskaj dostęp do slajdu

Pierwszy slajd ma indeks 0. Pusta prezentacja ma dokładnie jeden slajd.

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)

Krok 5: Dodaj kształt

Użyj slide.shapes.add_auto_shape(), aby dodać AutoShape. Parametry to (shape_type, x, y, width, height), wszystkie w punktach (1 punkt = 1/72 cala; standardowy slajd ma 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)

Krok 6: Zapisz prezentację

Wywołaj prs.save(path, SaveFormat.PPTX) przed wyjściem z bloku with. PPTX jest jedynym obsługiwanym formatem wyjściowym.

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

Plik jest zapisywany atomowo; jeśli wystąpi błąd przed tym wywołaniem, nie zostanie utworzony plik wyjściowy.

Kompletny działający przykład

Poniższy skrypt tworzy prezentację składającą się z dwóch slajdów, z kształtem tytułu na pierwszym slajdzie i tabelą na drugim.

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")

Typowe problemy i rozwiązania

ResourceWarning: unclosed Presentation

Tworzysz instancję Presentation bez bloku with. Zawsze używaj:

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

AttributeError: __enter__

Jeśli widzisz ten błąd, sprawdź, czy zaimportowałeś aspose.slides_foss (nie aspose.slides). Nazwa pakietu w PyPI to aspose-slides-foss, a import w czasie wykonywania to aspose.slides_foss.

TypeError: SaveFormat.PPTX is not callable

SaveFormat.PPTX jest członkiem wyliczenia, a nie funkcją. Użyj go jako prs.save("file.pptx", SaveFormat.PPTX).

Najczęściej zadawane pytania

Jaki jest domyślny rozmiar slajdu?

Nowy Presentation() tworzy slajdy w standardowym rozmiarze 10 × 7,5 cala (720 × 540 punktów). Zmiana rozmiaru slajdu nie jest jeszcze obsługiwana w tej edycji.

Czy mogę dodać więcej niż jeden slajd?

Tak. Wywołaj prs.slides.add_empty_slide(prs.layout_slides[0]), aby dodać pusty slajd i uzyskać do niego dostęp po indeksie:

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

Czy mogę otworzyć istniejący plik i dodać slajdy?

Tak:

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

Jakie formaty mogę zapisać?

Obsługiwany jest tylko SaveFormat.PPTX. Eksport do PDF, HTML, SVG lub obrazów nie jest dostępny w tej edycji.

Zobacz także

 Polski