Como adicionar imagens a slides do PowerPoint no .NET

Este guia mostra como incorporar imagens em slides do PowerPoint usando Aspose.Slides FOSS para .NET. Carregar dados de imagem no prs.Images.AddImage(),Então , liga-me . slide.Shapes.AddPictureFrame() Todas as dimensões são em pontos (1 ponto = 1/72 polegada).

Passo 1: Instalar o pacote

Adicione o pacote NuGet ao seu projeto executando o comando dotnet CLI install:

aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.

Passo 2: Adicionar uma imagem de um arquivo

Carregar bytes de imagem a partir de um arquivo para o prs.Images.AddImage(),Então , liga-me . slide.Shapes.AddPictureFrame() com a posição e o tamanho do alvo em pontos:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Load image into the presentation's image collection
byte[] imageData = File.ReadAllBytes("photo.jpg");
var img = prs.Images.AddImage(imageData);

// Add a picture frame at (x=50, y=50, width=400, height=300) in points
var frame = slide.Shapes.AddPictureFrame(
    ShapeType.Rectangle,
    50, 50, 400, 300,
    img
);

prs.Save("with-image.pptx", SaveFormat.Pptx);

A Comissão AddPictureFrame Assinatura de método aceita o tipo de forma, a posição, as dimensões e a referência da imagem:

AddPictureFrame(shapeType, x, y, width, height, image) -> PictureFrame

<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“Copy code”

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Todas as dimensões estão em: pontos de (1 ponto = 1/72 polegada) Para um slide padrão de 10 x 7,5 polegadas, o espaço coordenado é 720 x 540 pontos.

Passo 3: Adicionar uma imagem de um fluxo

Se já tiver a imagem como um stream (por exemplo, baixada de uma URL ou lida de um banco de dados):

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
using var stream = File.OpenRead("logo.png");
var img = prs.Images.AddImage(stream);

prs.Slides[0].Shapes.AddPictureFrame(
    ShapeType.Rectangle,
    200, 100, 300, 200,
    img
);
prs.Save("logo-slide.pptx", SaveFormat.Pptx);

Passo 4: Controle o modo de preenchimento

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

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
byte[] texData = File.ReadAllBytes("texture.png");
var img = prs.Images.AddImage(texData);
var frame = prs.Slides[0].Shapes.AddPictureFrame(
    ShapeType.Rectangle, 50, 50, 600, 350, img
);

// STRETCH: scale image to fill the frame exactly (default)
frame.PictureFormat.PictureFillMode = PictureFillMode.Stretch;

// TILE: repeat the image in a grid pattern
// frame.PictureFormat.PictureFillMode = PictureFillMode.Tile;

prs.Save("filled.pptx", SaveFormat.Pptx);

`PictureFillMode`	Comportamento
`Stretch`	Escala a imagem para preencher o quadro, ignorando a proporção de aspecto
`Tile`	Repita a imagem como um padrão de azulejos

Passo 5: Adicionar várias imagens a diferentes slides

Adicionar um quadro de imagem para cada slide repetindo uma lista de caminhos do arquivo da imagen e chamando AddPictureFrame() em cada diapositiva da coleção:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

string[] imageFiles = { "slide1.jpg", "slide2.jpg", "slide3.jpg" };

using var prs = new Presentation();
var layout = prs.Slides[0].LayoutSlide;

// Ensure enough slides exist
while (prs.Slides.Count < imageFiles.Length)
    prs.Slides.AddEmptySlide(layout);

for (int i = 0; i < imageFiles.Length; i++)
{
    if (!File.Exists(imageFiles[i])) continue;
    var img = prs.Images.AddImage(File.ReadAllBytes(imageFiles[i]));
    prs.Slides[i].Shapes.AddPictureFrame(
        ShapeType.Rectangle, 0, 0, 720, 540, img
    );
}

prs.Save("multi-image.pptx", SaveFormat.Pptx);

Passo 6: Conte imagens em uma apresentação existente

Carregar uma apresentação existente e ler prs.Images.Count para obter o número total de imagens armazenadas na coleção compartilhada:

using Aspose.Slides.Foss;

using var prs = new Presentation("with-image.pptx");
Console.WriteLine($"Presentation contains {prs.Images.Count} 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.