Úvodní článek

Aspose.Slides FOSS for Python gives you full control over the PowerPoint presentation životní cyklus vytváření balíčků od nuly, přidávání a přeskupení snímků, jejich doplňování s tvary, tabulkami a formátovaným textem a ukládáním výsledku do PPTX, ODP nebo PDF; nebo Vše se děje v čistém Pythonu bez závislosti na Python. Microsoft Office nebo jakýkoliv externí binární systém.

Knihovna je k dispozici na PyPI jako: aspose-slides-foss Pod licencí MIT. s ní pip, importovat a začít vytvářet prezentace v několika řádcích kódu. automatizujete generování zpráv, budujete slide-deck pipeline nebo vkládáte výstup prezentace v webové aplikaci, API pokrývá celou plochu: slide kolekce, hlavní/layoutové snímky, sbírky tvarů, textové rámy, formáty vyplnění a možnosti vývozu.

Tento příspěvek prochází základními funkcemi správy prezentace třídami a metodami, které nejčastěji použijete při práci s diapozitivy v Pythonu.

Co se v ní nachází?

Představení Životní cyklus

Úřad pro bezpečnost a ochranu zdraví Presentation Vytvořte novou balíček, zmanipulujte jeho obsah., a ukládání do jakéhokoli podporovaného formátu. Představení podporují protokol context-manager, Takže zdroje jsou automaticky uvolněny.

import io
from aspose.slides_foss import Presentation
from aspose.slides_foss.export import SaveFormat

with Presentation() as pres:
    # A new presentation starts with one blank slide
    print("Slides:", len(pres.slides))  # 1

    # Save to a file
    pres.save("output.pptx", SaveFormat.PPTX)

    # Or save to a stream
    buf = io.BytesIO()
    pres.save(buf, SaveFormat.PPTX)

Sběrka snímků

SlideCollection umožňuje přidat, vložit, klonovat, odstranit a znovu uspořádat snímky. Každý operace aktualizuje vnitřní index tak, aby len(pres.slides) vždy odráží současný počet.

from aspose.slides_foss import Presentation, ShapeType

with Presentation() as pres:
    layout = pres.layout_slides[0]

    # Add a blank slide using the first layout
    pres.slides.add_empty_slide(layout)

    # Insert at a specific position
    pres.slides.insert_empty_slide(1, layout)

    # Clone an existing slide (shapes are copied)
    pres.slides[0].shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 200, 100)
    pres.slides.add_clone(pres.slides[0])

    print("Total slides:", len(pres.slides))  # 4

    # Remove by index
    pres.slides.remove_at(3)

Tvary a automatické tvary

Přidejte obdélníky, elipsy, trojúhelníky a další geometrické tvary na jakýkoli snímek prostřednictvím ShapeCollection.add_auto_shape().Každý tvar odhaluje polohu, velikost a rotaci., a vlastnosti vyplnění, které přetrvávají po celém cyklu uložení/přeložení.

from aspose.slides_foss import Presentation, ShapeType

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 150)
    rect.rotation = 15

    ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 200)

    # Reorder z-index
    slide.shapes.reorder(0, ellipse)
    print("Front shape:", slide.shapes[0].shape_type)  # ELLIPSE

Tabulky

Vytvořit datové tabulky s: ShapeCollection.add_table(), nastavit text v buňce prostřednictvím TextFrame, spojit buňky a použít formátování hranic. Výška řádku a sloupce Šírky odpovídající hodnotám, které předáváte konstruktoru.

from aspose.slides_foss import Presentation, FillType
from aspose.slides_foss.drawing import Color

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    table = slide.shapes.add_table(50, 50, [150, 150, 150], [40, 40, 40])
    table.rows[0][0].text_frame.text = "Name"
    table.rows[0][1].text_frame.text = "Role"
    table.rows[0][2].text_frame.text = "Team"

    # Merge two cells in the second row
    table.merge_cells(table.rows[1][0], table.rows[1][1], False)

    # Style the header row borders
    for col_idx in range(len(table.columns)):
        fmt = table.rows[0][col_idx].cell_format
        fmt.border_bottom.fill_format.fill_type = FillType.SOLID
        fmt.border_bottom.fill_format.solid_fill_color.color = Color.black
        fmt.border_bottom.width = 2

Slide s hlavním a rozvrženým výkladem

Každá prezentace má hierarchii hlavních diapozitiv a rozvrhových diazítek. přes Presentation.masters a) Presentation.layout_slides uplatňovat konzistentně formátování přes palubu.

from aspose.slides_foss import Presentation

with Presentation() as pres:
    master = pres.masters[0]
    print("Master layouts:", len(master.layout_slides))

    # Pick a layout by type
    from aspose.slides_foss import SlideLayoutType
    title_layout = pres.layout_slides.get_by_type(SlideLayoutType.TITLE)
    if title_layout:
        pres.slides.add_empty_slide(title_layout)

Vlastnosti dokumentu

Číst a psát vestavěné metadata, jako je název, autor a předmět prostřednictvím DocumentProperties Objekt. Vlastnosti přetrvávají ve uloženém souboru.

from aspose.slides_foss import Presentation
from aspose.slides_foss.export import SaveFormat

with Presentation() as pres:
    props = pres.document_properties
    props.title = "Quarterly Report"
    props.author = "Engineering"
    props.subject = "Q1 2026 Results"

    pres.save("report.pptx", SaveFormat.PPTX)

Rychlý start

pip install aspose-slides-foss

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

with Presentation() as pres:
    slide = pres.slides[0]
    slide.shapes.clear()

    # Add a title shape
    title = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 30, 860, 80)
    tf = title.add_text_frame("Quarterly Report")
    tf.paragraphs[0].portions[0].portion_format.font_bold = NullableBool.TRUE
    tf.paragraphs[0].portions[0].portion_format.font_height = 28

    # Add a data table
    table = slide.shapes.add_table(50, 150, [200, 200, 200], [40, 40, 40])
    headers = ["Region", "Revenue", "Growth"]
    for i, h in enumerate(headers):
        table.rows[0][i].text_frame.text = h

    # Fill the title shape background
    title.fill_format.fill_type = FillType.SOLID
    title.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 51, 102)

    # Save as PPTX
    pres.save("report.pptx", SaveFormat.PPTX)

Podporované formáty

FormátRozšířeníČtěte.Píšeš.
PPTX.pptx✓✓
PPT.ppt—Plánované
PPSX.ppsx—Plánované
PPTM.pptm—Plánované
POTX.potx—Plánované
ODP.odp—Plánované
PDF.pdf—Plánované
HTML.html—Plánované
HTML5.html—Plánované
TIFF.- TIFF. - Cože?—Plánované
GIF.gif—Plánované
XPS.xps—Plánované
FODP.fodp—Plánované
MD.md—Plánované

Poznámka: V současné době je implementován pouze export PPTX. SaveFormat V současné době se na ně používá pro budoucí kompatibilitu, ale ještě nejsou funkční. save() metoda vždy vyprodukuje výstup PPTX bez ohledu na parametr formátu.

Open Source & Licence

Aspose.Slides FOSS for Python is released under the MIT license. You can use it in osobní, akademické a komerční projekty bez omezení. Zdrojový kód je k dispozici na: GitHub a balíček je zveřejněn dne 1. prosince. PyPI.

Jak začít?