Introduktion

Aspose.Slides FOSS för Python är nu tillgängligt på PyPI: ett gratis, MIT-licensierat bibliotek för att skapa, läsa och redigera 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 integrera presentationsskapande i webbapplikationer. Eftersom aspose-slides-foss är ren Python med endast lxml som beroende, distribueras det identiskt på Windows, macOS, Linux och Docker‑containrar.

Nyckelfunktioner

  • Fullständig round‑trip‑stöd för PPTX: Öppna vilken .pptx‑fil som helst, ändra dess innehåll och spara den igen utan att förlora okända XML‑delar som biblioteket ännu inte förstår.
  • Hantera bilder: Lägg till, ta bort och iterera bilder med 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().
  • Formatering av rik text: Formatera text på teckennivå med PortionFormat: teckenstorlek, fet, kursiv, understrykning och ARGB‑färg via FillType.SOLID och Color.from_argb().
  • Fyllningstyper: Applicera FillType.SOLID, GRADIENT, PATTERN eller PICTURE‑fyllningar på vilken form som helst.
  • Visuella effekter: Yttre skugga, glöd, mjuk kant, oskärpa, reflektion och inre skugga via shape.effect_format.
  • 3D‑formatering: Avfasning, kamera, ljusrigg, material och extruderingens djup 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‑array 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 ett 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 bildspelsövergångar
  • Export till PDF, HTML, SVG eller bildformat
  • Hyperlänkar, åtgärdsinställningar, VBA‑makron och digitala signaturer

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

Se även