Úvod

Aspose.Slides FOSS for Python is now available on PyPI: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx súbory úplne v Python, bez závislosti na Microsoft Office ani na žiadnom proprietárnom runtime.

Knižnica je určená pre vývojárov, ktorí potrebujú programovo generovať alebo manipulovať s prezentačnými súbormi: automatizovať sady snímok z dát, extrahovať text a metadáta z nahratých PPTX súborov, budovať reportovacie pipeline založené na prezentáciách alebo vkladať tvorbu prezentácií do webových aplikácií. Preto aspose-slides-foss je čistý Python s iba lxml ako závislosť, nasadzuje sa rovnako na Windows, macOS, Linux a Docker kontajnery.

Kľúčové funkcie

  • Plná podpora round-trip PPTX: Otvorte akýkoľvek .pptx súbor, upravte jeho obsah a uložte ho späť bez straty neznámych XML častí, ktoré knižnica zatiaľ nepozná.
  • Správa snímok: Pridávajte, odstraňujte a prechádzajte snímky pomocou prs.slides; prezentácia začína jednou prázdnou snímkou po slides.Presentation().
  • AutoShapes, Tabuľky a Konektory: Vkladajte tvary cez slide.shapes.add_auto_shape(), tabuľkové dáta cez slide.shapes.add_table(), a vizuálne konektory medzi tvarmi cez slide.shapes.add_connector().
  • Formátovanie bohatého textu: Formátujte text na úrovni znaku pomocou PortionFormat: veľkosť písma, tučné, kurzíva, podčiarknutie a farba ARGB cez FillType.SOLID a Color.from_argb().
  • Typy výplní: Použiť FillType.SOLID, GRADIENT, PATTERN, alebo PICTURE vyplní do ľubovoľného tvaru.
  • Vizuálne efekty: Vonkajší tieň, žiarenie, mäkký okraj, rozostrenie, odraz a vnútorný tieň cez shape.effect_format.
  • 3D formatting: Skosenie, kamera, osvetľovacia súprava, materiál a hĺbka extrúzie cez shape.three_d_format.
  • Poznámky prednášajúceho: Pripojte text poznámok k jednotlivým snímkam cez notes_slide_manager.add_notes_slide().
  • Vlákna komentárov: Pridajte komentáre s metadátami autora a pozíciou snímky.
  • Vložené obrázky: Vložte z cesty k súboru, bajtov alebo io.BytesIO prúdu.
  • Vlastnosti dokumentu: Čítajte a zapisujte základné, aplikačné a vlastné vlastnosti.

Začíname

Inštalujte z PyPI. Python 3.10 alebo novší je vyžadovaný; lxml sa nainštaluje automaticky.

pip install aspose-slides-foss

Vytvorte svoju prvú prezentáciu s tvarom a uložte ju:

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

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")
    prs.save("hello.pptx", SaveFormat.PPTX)

Vždy používajte Presentation vo vnútri with blok; to zabezpečuje, že všetky interné zdroje sú uvoľnené, keď blok skončí.

Príklad formátovania textu

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:
    shape = prs.slides[0].shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold heading in corporate blue")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 28
    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)
    prs.save("formatted.pptx", SaveFormat.PPTX)

Aktuálne obmedzenia

Nasledujúce oblasti vyvolávajú NotImplementedError v tomto vydaní:

  • Grafy, SmartArt a OLE objekty
  • Animácie a prechody snímok
  • Export do PDF, HTML, SVG alebo obrazových formátov
  • Hyperlinky, nastavenia akcií, VBA makrá a digitálne podpisy

Neznáme XML časti, ktoré sa objavia počas načítania, sa pri ukladaní zachovajú doslovne, takže PPTX súbory vytvorené inými nástrojmi prechádzajú bezpečným round‑tripom.

Pozri tiež