Aspose.Slides FOSS
Python
Como adicionar imagens a slides do PowerPoint no Python

Como adicionar imagens a slides do PowerPoint no Python

Este guia mostra como incorporar imagens em slides do PowerPoint usando Aspose.Slides FOSS para Python. prs.images.add_image() para adicionar bytes de imagem à coleção de fotos da apresentação, em seguida, chamar slide.shapes.add_picture_frame() para colocar a imagem no slide como quadro de fotografia.

Precondições

Instale a biblioteca no seu ambiente Python executando o seguinte comando pip antes de executar qualquer exemplo:

pip install aspose-slides-foss

Adicionar uma imagem de um arquivo

Leia os bytes da imagem e passe-os para o " prs.images.add_image(), então crie o quadro de imagem com slide.shapes.add_picture_frame():

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

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Load image into the presentation's image collection
    with open("photo.jpg", "rb") as f:
        img = prs.images.add_image(f.read())

    # Add a picture frame at (x=50, y=50, width=400, height=300) in points
    frame = slide.shapes.add_picture_frame(
        ShapeType.RECTANGLE,
        50, 50, 400, 300,
        img,
    )

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

A Comissão add_picture_frame assinatura:

add_picture_frame(shape_type, x, y, width, height, image) → PictureFrame

Todas as dimensões estão em: pontos de (1 ponto = 1/72 polegada) Para um slide padrão de tela larga 16:9, o espaço coordenado é 960 × 540 pontos.

Adicionar uma imagem de bytes

Se você já tem a imagem como bytes (por exemplo, baixado de um URL ou ler de uma base de dados), passe-os diretamente para o prs.images.add_image(image_bytes):

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

image_bytes = open("logo.png", "rb").read()  # or any bytes source

with slides.Presentation() as prs:
    img = prs.images.add_image(image_bytes)

    prs.slides[0].shapes.add_picture_frame(
        ShapeType.RECTANGLE,
        200, 100, 300, 200,
        img,
    )
    prs.save("logo-slide.pptx", SaveFormat.PPTX)

Controle o modo de preenchimento

A Comissão picture_fill_format em um PictureFrame Controla como a imagem preenche os limites do quadro:

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

with slides.Presentation() as prs:
    img = prs.images.add_image(open("texture.png", "rb").read())
    frame = prs.slides[0].shapes.add_picture_frame(
        ShapeType.RECTANGLE, 50, 50, 600, 350, img
    )

    # STRETCH: scale image to fill the frame exactly (default)
    frame.picture_format.picture_fill_mode = PictureFillMode.STRETCH

    # TILE: repeat the image in a grid pattern
    # frame.picture_format.picture_fill_mode = PictureFillMode.TILE

    prs.save("filled.pptx", SaveFormat.PPTX)
PictureFillModeComportamento
STRETCHEscala a imagem para preencher o quadro, ignorando a proporção de aspecto
TILERepita a imagem como um padrão de azulejos

Adicionar várias imagens a diferentes slides

Adicionar slides conforme necessário com prs.slides.add_empty_slide(layout) Então, liga. prs.images.add_image() e a) slide.shapes.add_picture_frame() para cada ficheiro de imagem:

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

image_files = ["slide1.jpg", "slide2.jpg", "slide3.jpg"]

with slides.Presentation() as prs:
    layout = prs.slides[0].layout_slide

    # Ensure enough slides exist
    while len(prs.slides) < len(image_files):
        prs.slides.add_empty_slide(layout)

    for i, path in enumerate(image_files):
        if not os.path.exists(path):
            continue
        img = prs.images.add_image(open(path, "rb").read())
        prs.slides[i].shapes.add_picture_frame(
            ShapeType.RECTANGLE, 0, 0, 960, 540, img
        )

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

Conte imagens em uma apresentação existente

Carregar o arquivo e verificar len(prs.images) Para contar as imagens armazenadas na coleção de imagem partilhada:

import aspose.slides_foss as slides

with slides.Presentation("with-image.pptx") as prs:
    print(f"Presentation contains {len(prs.images)} image(s)")

A Comissão prs.images A coleção é compartilhada em todos os slides: os mesmos bytes de imagem são armazenados uma vez, mesmo que a moldura da imagen apareça em vários slates.

Ver também:

 Português