Hoe te beginnen met Aspose.Slides FOSS for Python

aspose-slides-foss voor Python is een gratis, MIT-gelicentieerde bibliotheek voor het maken en bewerken van PowerPoint .pptx-bestanden — geen Microsoft Office nodig, pure Python van PyPI.

Stapsgewijze gids

Stap 1: Installeer het pakket

Installeer van PyPI met pip:

pip install aspose-slides-foss

Controleer of de installatie correct geladen is:

from aspose.slides_foss import Presentation
print("aspose-slides-foss is ready.")

Stap 2: Vereiste klassen importeren

Importeer de modules die je nodig hebt voor het laden van presentaties en het opslaan:

from aspose.slides_foss import Presentation, SaveFormat, ShapeType, FillType

Stap 3: Maak een presentatie

Construeer een Presentation zonder argumenten om te beginnen met één lege dia:

from aspose.slides_foss import Presentation, SaveFormat

prs = Presentation()
slide = prs.slides[0]
print(f"Slides: {len(prs.slides)}")
prs.save("new_presentation.pptx", SaveFormat.PPTX)

Stap 4: Voeg een vorm met tekst toe

Gebruik slide.shapes.add_auto_shape() om een rechthoek in te voegen, roep vervolgens add_text_frame() aan om tekstinhoud toe te voegen:

from aspose.slides_foss import Presentation, SaveFormat, ShapeType

prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
tf = shape.add_text_frame("Hello from Aspose.Slides FOSS!")
tf.paragraphs[0].portions[0].portion_format.font_height = 24
prs.save("with_shape.pptx", SaveFormat.PPTX)

Stap 5: Pas een vulling toe en sla op

Stel een effen vulkleur in op de vorm voordat je opslaat:

from aspose.slides_foss import (
    Presentation, SaveFormat, ShapeType, FillType, Color
)

prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 100, 100, 400, 200)
shape.fill_format.fill_type = FillType.SOLID
shape.fill_format.solid_fill_color.color = Color.from_argb(255, 70, 130, 180)
shape.add_text_frame("Styled shape")
prs.save("styled.pptx", SaveFormat.PPTX)

Veelvoorkomende problemen en oplossingen

ModuleNotFoundError: No module named 'aspose' Het pakket is niet geïnstalleerd in de actieve Python omgeving. Installeer het (zie de Installatiehandleiding) in dezelfde virtuele omgeving die je gebruikt om je script uit te voeren. Bevestig met pip show aspose-slides-foss.

FileNotFoundError bij het aanroepen van Presentation("path") Het pad dat je hebt opgegeven bestaat niet of gebruikt de verkeerde scheidingsteken. Gebruik pathlib.Path om paden draagbaar te construeren:

from pathlib import Path
from aspose.slides_foss import Presentation

prs = Presentation(str(Path("folder") / "existing.pptx"))

SaveFormat importfout Import SaveFormat direct uit de aspose.slides_foss pakket: from aspose.slides_foss import Presentation, SaveFormat

Vorm toegevoegd maar niet zichtbaar in de output Zorg ervoor dat coördinaten en afmetingen binnen de slidegrenzen vallen. Standaard slide-afmetingen zijn 9144000 EMU’s × 6858000 EMU’s (ongeveer 12 × 9 inch). Gebruik redelijke waarden in EMU of gebruik de x, y, width, height parameters in punten (1 pt ≈ 12700 EMU).

Veelgestelde vragen

Vereist aspose-slides-foss Microsoft Office?

Nee. De bibliotheek maakt en leest .pptx-bestanden native in pure Python zonder afhankelijkheid van Microsoft Office, COM-automatisering of Windows-API’s.

Welke Python-versies worden ondersteund?

Python 3.10 of hoger. Het pakket draait op Windows, macOS, Linux, Docker-containers en serverloze functies.

Is de bibliotheek gratis voor commercieel gebruik?

Ja. Het is uitgebracht onder de MIT-licentie. U mag het gebruiken, wijzigen en herdistribueren voor elk doel, inclusief commerciële toepassingen.

Kan ik een bestaand PPTX-bestand laden?

Ja. Geef het bestandspad door aan Presentation:

from aspose.slides_foss import Presentation, SaveFormat

prs = Presentation("existing.pptx")
print(f"Loaded {len(prs.slides)} slides")
prs.save("copy.pptx", SaveFormat.PPTX)

Kan ik meerdere dia’s toevoegen?

Ja. Gebruik prs.slides.add_empty_slide(layout) nadat je een layout hebt verkregen van prs.masters[0].layout_slides[0].