モダン API で画像処理を強化

はじめに

歴史的に、Aspose Slides は System.Drawing に依存しており、公開 API には以下のクラスが含まれています:

バージョン 24.4 以降、この公開 API は廃止予定と宣言されています。

.NET6 以降のバージョンで非 Windows 環境向けに System.Drawing のサポートが削除されたため（breaking change）、Slides は 2 つのライブラリ バージョン方式を実装しました:

Aspose.Slides.NET6.CrossPlatform の不便さは、同じ名前空間に独自の System.Drawing 実装を持ち、公開 API との下位互換性を保っている点です。そのため、Aspose.Slides.NET6.CrossPlatform と .NETFramework からの System.Drawing、または System.Drawing.Common パッケージを同時に使用すると、エイリアスを使用しない限り名前の競合が発生します。

メインの Aspose.Slides.NET パッケージで System.Drawing への依存を排除するために、いわゆる「Modern API」を追加しました。これは、廃止予定の API の代わりに使用すべき API で、シグネチャに System.Drawing の Image と Bitmap の依存が含まれていました。PrinterSettings と Graphics は廃止され、公開 Slides API からサポートが削除されました。

System.Drawing への依存を持つ廃止予定の公開 API の削除は 24.8 リリースで行われます。

Modern API

以下のクラスと列挙型が公開 API に追加されました:

  • Aspose.Slides.IImage – ラスターまたはベクター画像を表します。
  • Aspose.Slides.ImageFormat – 画像のファイル形式を表します。
  • Aspose.Slides.Images – IImage インターフェイスのインスタンス化と操作のためのメソッド。

IImage は IDisposable を実装しているため、using ステートメントでラップするか、適切な方法で破棄してください。

新しい API の典型的な使用シナリオは次のようになります:

    using (Presentation pres = new Presentation())
    {
        IPPImage ppImage;
        // ディスク上のファイルから IImage の破棄可能なインスタンスを作成します。  
        using (IImage image = Images.FromFile("image.png"))
        {
            // IImage のインスタンスをプレゼンテーションの画像に追加して PowerPoint 画像を作成します。
            ppImage = pres.Images.AddImage(image);
        }

        // スライド #1 に画像シェイプを追加します
        pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

        // スライド #1 を表す IImage のインスタンスを取得します。
        using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
        {
            // 画像をディスクに保存します。
            slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
        }
    }

古いコードを Modern API に置き換える

移行を容易にするために、IImage のインターフェイスは Image と Bitmap クラスの個別シグネチャをそのまま繰り返しています。基本的には、System.Drawing を使用している古いメソッド呼び出しを新しいものに置き換えるだけです。

スライドサムネイルの取得

廃止予定 API を使用したコード:

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetThumbnail().Save("slide1.png");
}

Modern API:

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetImage().Save("slide1.png");
}

シェイプサムネイルの取得

廃止予定 API を使用したコード:

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetThumbnail().Save("shape.png");
}

Modern API:

using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetImage().Save("shape.png");
}

プレゼンテーションサムネイルの取得

廃止予定 API を使用したコード:

using (Presentation pres = new Presentation("pres.pptx"))
{
    var bitmaps = pres.GetThumbnails(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < bitmaps.Length; index++)
        {
            Bitmap thumbnail = bitmaps[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (Bitmap bitmap in bitmaps)
        {
            bitmap.Dispose();
        }
    }
}

Modern API:

using (Presentation pres = new Presentation("pres.pptx"))
{
    var images = pres.GetImages(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < images.Length; index++)
        {
            IImage thumbnail = images[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (IImage image in images)
        {
            image.Dispose();
        }
    }
}

プレゼンテーションへの画像追加

廃止予定 API を使用したコード:

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (Image image = Image.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}

Modern API:

using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (IImage image = Aspose.Slides.Images.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}

削除対象のメソッド/プロパティと Modern API における置換

Presentation

メソッド シグネチャ 置換メソッド シグネチャ
public Bitmap[] GetThumbnails(IRenderingOptions options) GetImages(IRenderingOptions options)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides) GetImages(IRenderingOptions options, int[] slides)
public Bitmap[] GetThumbnails(IRenderingOptions options, float scaleX, float scaleY) GetImages(IRenderingOptions options, float scaleX, float scaleY)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY) GetImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)
public Bitmap[] GetThumbnails(IRenderingOptions options, Size imageSize) GetImages(IRenderingOptions options, Size imageSize)
public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, Size imageSize) GetImages(IRenderingOptions options, int[] slides, Size imageSize)
public void Save(string fname, SaveFormat format, HttpResponse response, bool showInline) 完全に削除されます
public void Save(string fname, SaveFormat format, ISaveOptions options, HttpResponse response, bool showInline) 完全に削除されます
public void Print() 完全に削除されます
public void Print(PrinterSettings printerSettings) 完全に削除されます
public void Print(string printerName) 完全に削除されます
public void Print(PrinterSettings printerSettings, string presName) 完全に削除されます

Shape

メソッド シグネチャ 置換メソッド シグネチャ
public Bitmap GetThumbnail() GetImage
public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY) GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY)

Slide

メソッド シグネチャ 置換メソッド シグネチャ
public Bitmap GetThumbnail(float scaleX, float scaleY) GetImage(float scaleX, float scaleY)
public Bitmap GetThumbnail() GetImage
public Bitmap GetThumbnail(IRenderingOptions options) GetImage(IRenderingOptions options)
public Bitmap GetThumbnail(Size imageSize) GetImage(Size imageSize)
public Bitmap GetThumbnail(ITiffOptions options) GetImage(ITiffOptions options)
public Bitmap GetThumbnail(IRenderingOptions options, float scaleX, float scaleY) GetImage(IRenderingOptions options, float scaleX, float scaleY)
public Bitmap GetThumbnail(IRenderingOptions options, Size imageSize) GetImage(IRenderingOptions options, Size imageSize)
public void RenderToGraphics(IRenderingOptions options, Graphics graphics) 完全に削除されます
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY) 完全に削除されます
public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize) 完全に削除されます

Output

メソッド シグネチャ 置換メソッド シグネチャ
public IOutputFile Add(string path, Image image) Add(string path, IImage image)

ImageCollection

メソッド シグネチャ 置換メソッド シグネチャ
IPPImage AddImage(Image image) AddImage(IImage image)

ImageWrapperFactory

メソッド シグネチャ 置換メソッド シグネチャ
IImageWrapper CreateImageWrapper(Image image) CreateImageWrapper(IImage image)

PPImage

メソッド/プロパティ シグネチャ 置換メソッド シグネチャ
void ReplaceImage(Image newImage) ReplaceImage(IImage newImage)
Image SystemImage { get; } IImage Image { get; }

PatternFormat

メソッド シグネチャ 置換メソッド シグネチャ
Bitmap GetTileImage(Color background, Color foreground) GetTile(Color background, Color foreground)
Bitmap GetTileImage(Color styleColor) GetTile(Color styleColor)

IPatternFormatEffectiveData

メソッド シグネチャ 置換メソッド シグネチャ
Bitmap GetTileImage(Color background, Color foreground) GetTileIImage(SlidesImage image)

Graphics と PrinterSettings のサポートは終了します

Graphics クラスは .NET6 以上のクロスプラットフォーム バージョンではサポートされません。Aspose Slides では、これを使用している API 部分が削除されます: Slide

また、印刷に関連する API 部分も削除されます:

Presentation:

FAQ

なぜ System.Drawing.Graphics が廃止されたのですか？

Graphics のサポートは、レンダリングと画像処理を統一し、プラットフォーム固有の依存関係を排除し、IImage を使用したクロスプラットフォーム アプローチに切り替えるために、公開 API から削除されます。Graphics を対象としたすべてのレンダリング メソッドが削除されます。

IImage は Image/Bitmap と比べて実際にどんな利点がありますか？

IImage はラスタ画像とベクター画像の両方を統一的に扱い、ImageFormat を介したさまざまな形式への保存を簡素化し、System.Drawing への依存を減らし、環境間でのコードの移植性を高めます。

Modern API はサムネイル生成のパフォーマンスに影響しますか？

GetThumbnail から GetImage への切り替えでパフォーマンスが低下することはありません。新しいメソッドは同等の機能とオプション、サイズ指定を提供し、レンダリング オプションも引き続きサポートしています。具体的な効果はシナリオに依存しますが、機能的には置換は等価です。

.NET 6 サポート サポート対象プラットフォームの更新