Aspose.Slides FOSS
.NET
.NETでPowerPointスライドに画像を追加する方法

.NETでPowerPointスライドに画像を追加する方法

Aspose.Slides FOSS の画像は ピクチャーフレーム として埋め込まれ、画像を保持し、他のシェイプと同様に位置指定、サイズ変更、スタイル設定が可能なシェイプです。画像データは prs.Images コレクションに一度だけ保存され、フレームから参照されます。

前提条件 

dotnet add package Aspose.Slides.Foss

ファイルから画像を追加 

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);

AddPictureFrame の署名:

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

すべての寸法は ポイント（1ポイント = 1/72インチ）です。標準的な 10 × 7.5 インチのスライドの場合、座標空間は 720 × 540 ポイントです。

ストリームから画像を追加

画像がすでにストリームとしてある場合（例：URL からダウンロードしたものやデータベースから読み取ったもの）:

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);

フィルモードを制御する

PictureFrame上のPictureFormatは、画像がフレームの境界を埋める方法を制御します：

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動作
Stretch画像をフレーム全体に拡大し、アスペクト比を無視する
Tile画像をタイル状パターンとして繰り返す

異なるスライドに複数の画像を追加 

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);

既存のプレゼンテーション内の画像をカウントする 

using Aspose.Slides.Foss;

using var prs = new Presentation("with-image.pptx");
Console.WriteLine($"Presentation contains {prs.Images.Count} image(s)");

prs.Images コレクションはすべてのスライドで共有されます: 同じ画像バイトは、画像フレームが複数のスライドに表示されても、一度だけ保存されます。

参照

 日本語