モダン API

はじめに

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

バージョン 24.4 から、この公開 API は非推奨と宣言されています。

これらのクラスへの依存を排除するために、「Modern API」と呼ばれる API を追加しました。すなわち、非推奨の API の代わりに使用すべき API で、シグネチャに BufferedImage への依存が含まれています。Graphics2D は非推奨と宣言され、公開 Slides API からのサポートは削除されました。

System.Drawing への依存を持つ非推奨の公開 API の削除は、リリース 24.8 で行われます。

Modern API

公開 API に以下のクラスと列挙体を追加しました：

IImage – ラスタまたはベクタ画像を表します。
ImageFormat – 画像のファイル形式を表します。
Images – IImage クラスを生成し操作するメソッド群。

IImage は disposable です（IDisposable を実装しており、using でラップするか、別の便利な方法で dispose してください）。

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

var pres = new aspose.slides.Presentation();
try {
    var ppImage;
    // ディスク上のファイルから IImage の破棄可能なインスタンスを作成します。
    var image = aspose.slides.Images.fromFile("image.png");
    try {
        // IImage のインスタンスをプレゼンテーションの画像に追加して PowerPoint 画像を作成します。
        ppImage = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // スライド #1 に画像形状を追加します。
    pres.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    var size = java.newInstanceSync("java.awt.Dimension", 1920, 1080);
    // スライド #1 を表す IImage のインスタンスを取得します。
    var slideImage = pres.getSlides().get_Item(0).getImage(size);
    try {
        // 画像をディスクに保存します。
        slideImage.save("slide1.jpeg", aspose.slides.ImageFormat.Jpeg);
    } finally {
        if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

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

一般的に、ImageIO を使用した古いメソッド呼び出しを新しいものに置き換える必要があります。

古い：

var imageio = java.import("javax.imageio.ImageIO");
var size = java.newInstanceSync("java.awt.Dimension", 1920, 1080);
var slideImage = pres.getSlides().get_Item(0).getThumbnail(size);
var file = java.newInstanceSync("java.io.File", "image.png");
imageio.write(slideImage, "PNG", file);

新しい：

var size = java.newInstanceSync("java.awt.Dimension", 1920, 1080);
var slideImage = pres.getSlides().get_Item(0).getImage(size);
slideImage.save("image.png", aspose.slides.ImageFormat.Png);
slideImage.dispose();

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

非推奨 API を使用したコード：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var slideImage = pres.getSlides().get_Item(0).getThumbnail();
    var imageio = java.import("javax.imageio.ImageIO");
    var file = java.newInstanceSync("java.io.File", "slide1.png");
    imageio.write(slideImage, "PNG", file);
} finally {
    if (pres != null) pres.dispose();
}

Modern API：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var slideImage = pres.getSlides().get_Item(0).getImage();
    slideImage.save("slide1.png", aspose.slides.ImageFormat.Png);
    slideImage.dispose();
} finally {
    if (pres != null) pres.dispose();
}

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

非推奨 API を使用したコード：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThumbnail();
    var imageio = java.import("javax.imageio.ImageIO");
    var file = java.newInstanceSync("java.io.File", "shape.png");
    imageio.write(shapeImage, "PNG", file);
} finally {
    if (pres != null) pres.dispose();
}

Modern API：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
    shapeImage.save("shape.png");
    shapeImage.dispose();
} finally {
    if (pres != null) pres.dispose();
}

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

非推奨 API を使用したコード：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var size = java.newInstanceSync("java.awt.Dimension", 1980, 1028);
    var bitmaps = pres.getThumbnails(new aspose.slides.RenderingOptions(), size);
    for (var index = 0; index < bitmaps.length; index++)
    {
        var thumbnail = bitmaps[index];
        var imageio = java.import("javax.imageio.ImageIO");
        var file = java.newInstanceSync("java.io.File", "slide" + index + ".png");
        imageio.write(thumbnail, "PNG", file);
    }
} finally {
    if (pres != null) pres.dispose();
}

Modern API：

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var size = java.newInstanceSync("java.awt.Dimension", 1980, 1028);
    var images = pres.getImages(new aspose.slides.RenderingOptions(), size);
    try
    {
        for (var index = 0; index < images.length; index++)
        {
            var thumbnail = images[index];
            thumbnail.save("slide" + index + ".png", aspose.slides.ImageFormat.Png);
        }
    }
    finally
    {
        images.forEach(item => {item.dispose();});
    }
} finally {
    if (pres != null) pres.dispose();
}

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

非推奨 API を使用したコード：

var pres = new aspose.slides.Presentation();
try {
    var imageio = java.import("javax.imageio.ImageIO");
    var file = java.newInstanceSync("java.io.File", "image.png");
    var bufferedImages = imageio.read(file);
    var ppImage = pres.getImages().addImage(bufferedImages);

    pres.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
} finally {
    if (pres != null) pres.dispose();
}

Modern API：

var pres = new aspose.slides.Presentation();
try {
    var image = aspose.slides.Images.fromFile("image.png");
    var ppImage = pres.getImages().addImage(image);
    image.dispose();

    pres.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
} finally {
    if (pres != null) pres.dispose();
}

削除されるメソッドと Modern API における置換

Presentation

メソッドシグネチャ	置換メソッドシグネチャ
public final BufferedImage[] getThumbnails(IRenderingOptions options)	public final IImage[] getImages(IRenderingOptions options)
public final BufferedImage[] getThumbnails(IRenderingOptions options, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides)	public final IImage[] getImages(IRenderingOptions options, int[] slides)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, Dimension imageSize)	public final IImage[] getImages(IRenderingOptions options, int[] slides, Dimension imageSize)
public final BufferedImage[] getThumbnails(IRenderingOptions options, Dimension imageSize)	public final IImage[] getImages(IRenderingOptions options, Dimension imageSize)

Shape

メソッドシグネチャ	置換メソッドシグネチャ
public final BufferedImage getThumbnail()	public final IImage getImage()
public final BufferedImage getThumbnail(int bounds, float scaleX, float scaleY)	public final IImage getImage(int bounds, float scaleX, float scaleY)

Slide

メソッドシグネチャ	置換メソッドシグネチャ
public final BufferedImage getThumbnail()	public final IImage getImage()
public final BufferedImage getThumbnail(float scaleX, float scaleY)	public final IImage getImage(float scaleX, float scaleY)
public final BufferedImage getThumbnail(IRenderingOptions options)	public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, float scaleX, float scaleY)	public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, Dimension imageSize)	public final IImage getImage(IRenderingOptions options, Dimension imageSize)
public final BufferedImage getThumbnail(ITiffOptions options)	public final IImage getImage(ITiffOptions options)
public final BufferedImage getThumbnail(Dimension imageSize)	public final IImage getImage(Dimension imageSize)
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics)	完全に削除されます
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, float scaleX, float scaleY)	完全に削除されます
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, Dimension renderingSize)	完全に削除されます

Output

メソッドシグネチャ	置換メソッドシグネチャ
public final IOutputFile add(String path, BufferedImage image)	public final IOutputFile add(String path, IImage image)

ImageCollection

メソッドシグネチャ	置換メソッドシグネチャ
public final PPImage addImage(BufferedImage image)	public final PPImage addImage(IImage image)

PPImage

メソッドシグネチャ	置換メソッドシグネチャ
public final BufferedImage getSystemImage()	public final IImage getImage()

PatternFormat

メソッドシグネチャ	置換メソッドシグネチャ
public final BufferedImage getTileImage(Color styleColor)	public final IImage getTile(Color styleColor)
public final BufferedImage getTileImage(Color background, Color foreground)	public final IImage getTile(Color background, Color foreground)

PatternFormatEffectiveData

メソッドシグネチャ	置換メソッドシグネチャ
public final java.awt.image.BufferedImage getTileImage(Color background, Color foreground)	public final IImage getTileIImage(Color background, Color foreground)

Graphics2D 用 API サポートの中止

Graphics2D を使用したメソッドは非推奨と宣言され、公開 API からのサポートが削除されます。

Graphics2D を使用する API 部分は削除されます：

Slide

よくある質問

IImage は Image/Bitmap と比べて実用的な利点は何ですか？

IImage はラスタ画像とベクタ画像の両方の操作を統一し、ImageFormat を通じてさまざまな形式への保存を簡素化します。

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

getThumbnail から getImage への切り替えはシナリオを劣化させません。新メソッドはオプションやサイズ指定で画像を生成する同等の機能を提供し、レンダリングオプションのサポートも保持しています。性能の向上または低下はシナリオ次第ですが、機能的には置換は等価です。

3D プレゼンテーション VBAによるプレゼンテーション