Guia del desenvolupador

Aquesta guia cobreix les capacitats principals d’Aspose.Slides FOSS per a Python amb exemples de codi executables per a cada àrea de funcionalitat.

En aquesta secció

PageDescription
Features and CapabilitiesLlista completa de funcions compatibles: diapositives, formes, text, farciment, efectes, formatació 3D, notes, comentaris, imatges i propietats del document.
Working with ImagesIncrusta imatges a les diapositives com a marcs d’imatge des d’un fitxer o bytes; controla el mode de farciment (estirament, mosaic).
Working with ConnectorsAfegeix connectors corbats, d’angle i rectes entre formes; defineix els punts de connexió i l’estil de línia.
Working with 3D EffectsAplica ombra externa, resplendor, difuminat, bisell, predefinits de càmera, equips de llum i materials a les formes.
Working with CommentsAfegeix comentaris de revisió en fil i notes del presentador; gestiona els autors dels comentaris; llegeix anotacions.

Punt d’entrada de l’API

Cada operació comença amb un objecte Presentation. Utilitzeu-lo sempre com a gestor de context:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

El gestor de context assegura que els recursos interns COM/XML es alliberen quan el bloc surt. No emmagatzemeu una referència Presentation fora del bloc with.

Format de sortida compatible

L’únic format de desament compatible és PPTX (SaveFormat.PPTX). L’exportació a PDF, HTML, SVG o formats d’imatge no està disponible en aquesta edició.

Classes clau

Class / EnumImport PathDescription
Presentationaspose.slides_fossContenidor arrel; utilitzeu-lo com a gestor de context
ShapeTypeaspose.slides_fossEnumeració per als tipus de forma (RECTANGLE, ELLIPSE, …)
FillTypeaspose.slides_fossEnumeració per als tipus d’emplenament (SOLID, GRADIENT, …)
NullableBoolaspose.slides_fossBooleà de tres estats per al format (TRUE, FALSE, NOT_DEFINED)
SaveFormataspose.slides_foss.exportEnumeració de format de sortida (només es suporta PPTX)
Coloraspose.slides_foss.drawingConstructor de color ARGB
PointFaspose.slides_foss.drawingPunt 2D flotant (utilitzat per a posicions de comentaris)

Limitacions conegudes

Les àrees següents generen NotImplementedError en aquesta edició:

  • Charts: no es pot crear ni modificar gràfics
  • SmartArt: no compatible
  • Animations and transitions: les transicions de diapositives i les animacions d’objectes no es poden establir
  • Export formats: només es suporta desar com a PPTX; no hi ha exportació a PDF, HTML, SVG o imatge
  • Hyperlinks and action settings: els objectes d’enllaç no són modificables
  • VBA macros and digital signatures: no són accessibles

Les parts XML desconegudes trobades durant la càrrega es conserven literalment en desar, de manera que el round‑tripping mai elimina el contingut que la biblioteca encara no entén.

Vegeu també

 Català