Introduktion

Aspose.Slides FOSS for Python is now available on PyPI: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx filer helt i Python, utan beroende av Microsoft Office eller någon proprietär runtime.

Biblioteket är utformat för utvecklare som behöver generera eller manipulera presentationsfiler programatiskt: automatisera bildspel från data, extrahera text och metadata från uppladdade PPTX-filer, bygga presentationsbaserade rapporteringspipeline, eller bädda in presentationsskapande i webbapplikationer. Eftersom aspose-slides-foss är ren Python med endast lxml som ett beroende, distribueras den identiskt på Windows, macOS, Linux och Docker-containrar.

Nyckelfunktioner

  • Fullständig round‑trip PPTX‑stöd: Öppna vilken som helst .pptx fil, ändra dess innehåll och spara tillbaka utan att förlora okända XML‑delar som biblioteket ännu inte förstår.
  • Bildhantering: Lägg till, ta bort och iterera bilder med hjälp av prs.slides; presentationen startar med en tom bild efter slides.Presentation().
  • AutoShapes, Tabeller och Anslutningar: Infoga former via slide.shapes.add_auto_shape(), tabulär data via slide.shapes.add_table(), och visuella anslutningar mellan former via slide.shapes.add_connector().
  • Rich text‑formatering: Formatera text på teckennivå med PortionFormat: teckenstorlek, fetstil, kursiv, understrykning och ARGB-färg via FillType.SOLID och Color.from_argb().
  • Fylltyper: Tillämpa FillType.SOLID, GRADIENT, PATTERN, eller PICTURE fyller till vilken form som helst.
  • Visuella effekter: Yttre skugga, glöd, mjuk kant, oskärpa, reflektion och inre skugga via shape.effect_format.
  • 3D formatting: Avfasning, kamera, ljusrigg, material och extruderingsdjup via shape.three_d_format.
  • Talarnoter: Bifoga noteringstext till varje bild via notes_slide_manager.add_notes_slide().
  • Trådade kommentarer: Lägg till kommentarer med författarmetadata och bildposition.
  • Inbäddade bilder: Bädda in från filsökväg, byte eller io.BytesIO ström.
  • Dokumentegenskaper: Läs och skriv kärn-, app- och anpassade egenskaper.

Komma igång

Installera från PyPI. Python 3.10 eller senare krävs; lxml installeras automatiskt.

pip install aspose-slides-foss

Skapa din första presentation med en form och spara den:

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)

Använd alltid Presentation inuti en with block; detta säkerställer att alla interna resurser frigörs när blocket avslutas.

Exempel på textformatering

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)

Aktuella begränsningar

Följande områden utlöser NotImplementedError i den här releasen:

  • Diagram, SmartArt och OLE-objekt
  • Animationer och bildövergångar
  • Exportera till PDF, HTML, SVG eller bildformat
  • Hyperlänkar, åtgärdsinställningar, VBA-makron och digitala signaturer

Okända XML-delar som påträffas under inläsning bevaras ordagrant vid sparande, så PPTX-filer som skapats av andra verktyg kan round‑tripas säkert.

Se även