Cómo agregar imágenes a diapositivas de PowerPoint en .NET
Las imágenes en Aspose.Slides FOSS se incrustan como marcos de imagen, formas que contienen una imagen y pueden posicionarse, redimensionarse y estilizarse como cualquier otra forma. Los datos de la imagen se almacenan una sola vez en la colección prs.Images y son referenciados por el marco.
Requisitos previos
dotnet add package Aspose.Slides.FossAgregar una imagen desde un archivo
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);La firma AddPictureFrame:
AddPictureFrame(shapeType, x, y, width, height, image) -> PictureFrameTodas las dimensiones están en puntos (1 punto = 1/72 de pulgada). Para una diapositiva estándar de 10 × 7,5 pulgadas, el espacio de coordenadas es de 720 × 540 puntos.
Agregar una imagen desde un flujo
Si ya tienes la imagen como un flujo (p. ej., descargada de una URL o leída de una base de datos):
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);Controlar el modo de relleno
El PictureFormat en un PictureFrame controla cómo la imagen llena los límites del marco:
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 | Comportamiento |
|---|---|
Stretch | Escalar la imagen para llenar el marco, ignorando la relación de aspecto |
Tile | Repetir la imagen como un patrón en mosaico |
Agregar varias imágenes a diferentes diapositivas
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);Contar imágenes en una presentación existente
using Aspose.Slides.Foss;
using var prs = new Presentation("with-image.pptx");
Console.WriteLine($"Presentation contains {prs.Images.Count} image(s)");La colección prs.Images se comparte en todas las diapositivas: los mismos bytes de imagen se almacenan una sola vez, incluso si el marco de imagen aparece en varias diapositivas.