Aspose.Slides FOSS
Python
Guide du développeur
Images

Travailler avec des images dans les présentations — Aspose.Slides FOSS pour Python

Aspose.Slides FOSS for Python lets you embed images in a presentation’s shared image collection and display them on slides using PictureFrame formes. Les images peuvent également être utilisées comme remplissages d’arrière-plan de forme via FillType.PICTURE.

Ajouter une image depuis un fichier

Chargez les octets d’image depuis le disque et ajoutez-les à la collection d’images de la présentation avec prs.images.add_image(). Ensuite, placez l’image sur une diapositive en tant que PictureFrame:

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

with slides.Presentation() as prs:
    # Add the image to the shared collection
    with open("logo.png", "rb") as f:
        img = prs.images.add_image(f.read())

    # Place it on the slide as a PictureFrame
    slide = prs.slides[0]
    slide.shapes.add_picture_frame(ShapeType.RECTANGLE, 50, 50, 300, 200, img)

    prs.save("with-image.pptx", SaveFormat.PPTX)

Les quatre arguments positionnels de add_picture_frame() sont : x, y, width, height en points.

Ajout d’une image à partir d’octets

Si vous avez déjà des octets d’image (par ex., téléchargés depuis une URL ou lus depuis une base de données), transmettez-les directement à add_image():

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

# Simulate having bytes in memory
with open("photo.jpg", "rb") as f:
    image_bytes = f.read()

with slides.Presentation() as prs:
    img = prs.images.add_image(image_bytes)
    prs.slides[0].shapes.add_picture_frame(ShapeType.RECTANGLE, 100, 80, 400, 250, img)
    prs.save("from-bytes.pptx", SaveFormat.PPTX)

Positionnement et dimensionnement d’un PictureFrame

Le PictureFrame renvoyé par add_picture_frame() hérite de tous les Shape propriétés géométriques et peut être repositionné après création :

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

with slides.Presentation() as prs:
    with open("photo.jpg", "rb") as f:
        img = prs.images.add_image(f.read())

    pf = prs.slides[0].shapes.add_picture_frame(ShapeType.RECTANGLE, 0, 0, 100, 100, img)

    # Reposition and resize after creation
    pf.x = 50
    pf.y = 100
    pf.width = 350
    pf.height = 250

    prs.save("positioned.pptx", SaveFormat.PPTX)

Utiliser une image comme remplissage de forme

Toute forme (pas seulement PictureFrame) peut utiliser une image comme remplissage d’arrière-plan. Définissez fill_type = FillType.PICTURE et attribuez l’image à picture_fill_format.picture.image:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, FillType, PictureFillMode
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    with open("background.png", "rb") as f:
        img = prs.images.add_image(f.read())

    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.ROUND_CORNER_RECTANGLE, 50, 50, 400, 250)
    shape.fill_format.fill_type = FillType.PICTURE
    shape.fill_format.picture_fill_format.picture_fill_mode = PictureFillMode.STRETCH
    shape.fill_format.picture_fill_format.picture.image = img

    prs.save("picture-fill.pptx", SaveFormat.PPTX)

PictureFillMode.STRETCH redimensionne l’image pour remplir entièrement la forme. Utilisez TILE pour un motif de tuiles répétitif.

Ajout de plusieurs images sur plusieurs diapositives

Images ajoutées à prs.images sont partagées entre toutes les diapositives. Le même Image objet peut être utilisé sur plusieurs diapositives sans dupliquer les données :

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

with slides.Presentation() as prs:
    with open("logo.png", "rb") as f:
        logo = prs.images.add_image(f.read())

    # Add the same image to both slides
    prs.slides[0].shapes.add_picture_frame(ShapeType.RECTANGLE, 600, 10, 100, 40, logo)

    prs.save("shared-image.pptx", SaveFormat.PPTX)

Voir aussi

 Français