Úvod

Aspose.Slides FOSS pre Python je teraz dostupný na PyPI: bezplatná, MIT‑licencovaná knižnica na vytváranie, čítanie a úpravu súborov PowerPoint .pptx úplne v Pythone, bez závislosti na Microsoft Office alebo akomkoľvek 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ť prezentácie zo 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že aspose-slides-foss je čistý Python s jedinou závislosťou lxml, nasadzuje sa identicky na Windows, macOS, Linux a Docker kontajnery.

Kľúčové vlastnosti

  • Kompletná podpora round‑trip PPTX: Otvorte akýkoľvek súbor .pptx, upravte jeho obsah a uložte ho späť bez straty neznámych XML častí, ktoré knižnica ešte 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().
  • AutoShape, tabuľky a konektory: Vkladajte tvary pomocou slide.shapes.add_auto_shape(), tabuľkové údaje pomocou slide.shapes.add_table() a vizuálne konektory medzi tvarmi pomocou 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 ARGB farbu cez FillType.SOLID a Color.from_argb().
  • Typy výplní: Použite výplne FillType.SOLID, GRADIENT, PATTERN alebo PICTURE na akýkoľvek tvar.
  • Vizuálne efekty: Vonkajší tieň, žiara, mäkký okraj, rozmazanie, odraz a vnútorný tieň cez shape.effect_format.
  • 3D formátovanie: Skosenie, kamera, osvetlenie, materiál a hĺbka extrúzie cez shape.three_d_format.
  • Poznámky prednášajúceho: Pripojte text poznámok ku každej snímke pomocou notes_slide_manager.add_notes_slide().
  • Vlákna komentárov: Pridajte komentáre s metadátami autora a pozíciou na snímke.
  • Vložené obrázky: Vkladajte z cesty k súboru, bajtov alebo streamu io.BytesIO.
  • Vlastnosti dokumentu: Čítajte a zapisujte základné, aplikačné a vlastné vlastnosti.

Začíname

Inštalovať z PyPI. Vyžaduje sa Python 3.10 alebo novší; 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 vnútri bloku with; to zabezpečuje, že všetky interné zdroje budú uvoľnené pri ukončení bloku.

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 formátov obrázkov
  • Hyperlinky, nastavenia akcií, VBA makrá a digitálne podpisy

Neznáme XML časti, ktoré sa objavia počas načítania, sú pri ukladaní zachované doslovne, takže PPTX súbory vytvorené inými nástrojmi bezpečne prechádzajú cyklom načítania a ukladania.

Pozri tiež