Úvod

Aspose.Slides FOSS pro Python je nyní k dispozici na PyPI: bezplatná knihovna s licencí MIT pro vytváření, čtení a úpravu souborů PowerPoint .pptx kompletně v Pythonu, bez závislosti na Microsoft Office ani na žádném proprietárním runtime.

Knihovna je navržena pro vývojáře, kteří potřebují programově generovat nebo manipulovat soubory prezentací: automatizovat sady snímků z dat, extrahovat text a metadata z nahraných souborů PPTX, vytvářet reportingové pipeline založené na prezentacích nebo vkládat tvorbu prezentací do webových aplikací. Protože aspose-slides-foss je čistý Python s jedinou závislostí lxml, nasazuje se identicky na Windows, macOS, Linux a Docker kontejnerech.

Klíčové vlastnosti

  • Plná podpora round‑trip PPTX: Otevřete libovolný soubor .pptx, upravte jeho obsah a uložte jej zpět, aniž by došlo ke ztrátě neznámých částí XML, které knihovna zatím nezná.
  • Správa snímků: Přidávejte, odstraňujte a procházejte snímky pomocí prs.slides; prezentace začíná jedním prázdným snímkem po slides.Presentation().
  • AutoShapes, Tabulky a Spojnice: Vkládejte tvary pomocí slide.shapes.add_auto_shape(), tabulková data pomocí slide.shapes.add_table() a vizuální spoje mezi tvary pomocí slide.shapes.add_connector().
  • Formátování bohatého textu: Formátujte text na úrovni znaků pomocí PortionFormat: velikost písma, tučné, kurzíva, podtržení a barvu ARGB pomocí FillType.SOLID a Color.from_argb().
  • Typy výplní: Použijte výplně FillType.SOLID, GRADIENT, PATTERN nebo PICTURE na libovolný tvar.
  • Vizuální efekty: Vnější stín, záře, měkký okraj, rozostření, odraz a vnitřní stín pomocí shape.effect_format.
  • 3D formátování: Zkosení, kamera, osvětlení, materiál a hloubka extruze pomocí shape.three_d_format.
  • Poznámky přednášejícího: Připojte text poznámek k jednotlivým snímkům pomocí notes_slide_manager.add_notes_slide().
  • Vlákna komentářů: Přidávejte komentáře s metadaty autora a pozicí na snímku.
  • Vložené obrázky: Vkládejte z cesty k souboru, bajtů nebo streamu io.BytesIO.
  • Vlastnosti dokumentu: Čtěte a zapisujte základní, aplikační a vlastní vlastnosti.

Začínáme

Instalujte z PyPI. Je vyžadován Python 3.10 nebo novější; lxml se nainstaluje automaticky.

pip install aspose-slides-foss

Vytvořte svou první prezentaci s tvarem a uložte ji:

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žívejte Presentation uvnitř bloku with; to zajišťuje uvolnění všech vnitřních zdrojů při ukončení bloku.

Příklad formátování 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ální omezení

V tomto vydání následující oblasti vyvolávají NotImplementedError:

  • Grafy, SmartArt a OLE objekty
  • Animace a přechody snímků
  • Export do PDF, HTML, SVG nebo obrazových formátů
  • Hyperlinky, nastavení akcí, VBA makra a digitální podpisy

Neznámé XML části, které byly při načítání zjištěny, jsou při ukládání zachovány doslovně, takže PPTX soubory vytvořené jinými nástroji jsou bezpečně přenášeny tam a zpět.

Viz také