Foire aux questions

Comment installer Aspose.Slides FOSS ?

Installez depuis PyPI à l’aide de pip. Python 3.10 ou version ultérieure est requis.

pip install aspose-slides-foss

Vérifiez l’installation :

import aspose.slides_foss as slides
with slides.Presentation() as prs:
    print(f"Slides: {len(prs.slides)}")

La dépendance lxml est installée automatiquement. Aucun Microsoft Office ou autre environnement d’exécution système n’est requis.

Pourquoi dois-je utiliser `with slides.Presentation() as prs:`?

La classe Presentation gère les poignées de fichiers internes et les ressources XML. Sans le gestionnaire de contexte, ces ressources ne sont pas libérées lorsque l’objet Presentation sort de la portée, ce qui peut entraîner des fuites de ressources ou des verrous de fichiers sous Windows.

Suivez toujours ce modèle :

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

Quels formats de fichier puis-je enregistrer ?

Seul PPTX est pris en charge :

from aspose.slides_foss.export import SaveFormat
prs.save("output.pptx", SaveFormat.PPTX)

L’exportation vers PDF, HTML, SVG ou les formats d’image (PNG, JPEG) n’est pas disponible dans cette édition.

Puis-je ouvrir les fichiers `.ppt` (ancien PowerPoint 97–2003) ?

Non. Seuls les fichiers .pptx (Office Open XML) sont pris en charge. Le format binaire hérité .ppt n’est pas géré par cette bibliothèque.

Comment accéder aux diapositives ?

Les diapositives sont une liste indexée à partir de zéro accessible via prs.slides:

first_slide = prs.slides[0]
slide_count = len(prs.slides)

Comment ajouter une deuxième diapositive ?

Utilisez prs.slides.add_empty_slide() avec une mise en page :

with slides.Presentation() as prs:
    layout = prs.layout_slides[0]
    prs.slides.add_empty_slide(layout)
    slide2 = prs.slides[1]
    prs.save("two-slides.pptx", SaveFormat.PPTX)

Comment définir la couleur d’arrière-plan de la diapositive ?

La coloration d’arrière-plan des diapositives n’est pas disponible dans cette édition. La classe Slide n’expose pas de propriété background. Tenter slide.background déclenchera AttributeError. Cette fonctionnalité n’est pas implémentée dans la version actuelle.

Comment puis‑je utiliser `NullableBool`?

NullableBool est une énumération à trois états utilisée pour les propriétés de formatage. Utilisez NullableBool.TRUE (et non le True de Python) pour le gras, l’italique et des propriétés similaires :

from aspose.slides_foss import NullableBool, TextUnderlineType
fmt.font_bold = NullableBool.TRUE
fmt.font_italic = NullableBool.FALSE
# font_underline is TextUnderlineType, not NullableBool:
fmt.font_underline = TextUnderlineType.NOT_DEFINED  # inherits from theme

Pourquoi le réglage de la couleur du texte n’a‑t‑il aucun effet ?

Vous devez également définir fill_type = FillType.SOLID avant d’attribuer la couleur :

from aspose.slides_foss import FillType
from aspose.slides_foss.drawing import Color

fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)

Puis-je utiliser des graphiques ou SmartArt ?

Non. Les graphiques, SmartArt, objets OLE, animations, transitions, hyperliens, macros VBA et signatures numériques ne sont pas implémentés dans cette édition et déclenchent NotImplementedError.

La bibliothèque prend‑elle en charge Python 3.9 ?

Non. Python 3.10 ou version ultérieure est requis.

Cette bibliothèque est‑elle thread‑safe ?

Chaque objet Presentation est indépendant. Créer et utiliser des instances distinctes de Presentation à partir de threads séparés est sûr tant que vous ne partagez pas un même objet Presentation entre les threads sans verrouillage externe.

Comment intégrer une image ?

Lisez les octets de l’image et ajoutez‑les à prs.images, puis créez un PictureFrame:

with open("logo.png", "rb") as f:
    image_data = f.read()
image = prs.images.add_image(image_data)
slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image)

Foire aux questions