モダンAPI

はじめに

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

• Graphics2D
• BufferedImage

バージョン24.4以降、この公開APIは非推奨として宣言されました。

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

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

モダンAPI

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

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

IImageは破棄可能であり（IDisposableインターフェースを実装しており、その使用はusingでラップするか、別の便利な方法で破棄する必要があります）。

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

from asposeslides.api import Presentation, SaveFormat, Images, ShapeType, ImageFormat
from javax.imageio import ImageIO
from java.io import File
from java.awt import Dimension

pres = Presentation();

# ディスク上のファイルからIImageの破棄可能なインスタンスをインスタンス化します。
image = Images.fromFile("image.png");

# IImageのインスタンスをプレゼンテーションの画像に追加してPowerPoint画像を作成します。
ppImage = pres.getImages().addImage(image);
image.dispose();

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

# スライド#1を表すIImageのインスタンスを取得します。
slideImage = pres.getSlides().get_Item(0).getImage(Dimension(1920, 1080));

# 画像をディスクに保存します。
slideImage.save("slide1.jpeg", ImageFormat.Jpeg);
slideImage.dispose();

pres.dispose();

古いコードをモダンAPIに置き換える

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

古い：

image_format = "PNG"
buffImage = pres.getSlides().get_Item(0).getThumbnail(Dimension(1920, 1080))
ImageIO.write(buffImage, image_format, File("image.png"))

新しい：

slideImage = pres.getSlides().get_Item(0).getImage(Dimension(1920, 1080));
slideImage.save("image.png", ImageFormat.Png);

スライドのサムネイルを取得する

非推奨APIを使用するコード：

from asposeslides.api import Presentation
from javax.imageio import ImageIO
from java.io import File
from java.awt import Dimension


pres = Presentation("pres.pptx");

slideImage = pres.getSlides().get_Item(0).getThumbnail();
image_format = "PNG"
ImageIO.write(slideImage, image_format, File("slide1.png"))

pres.dispose();

モダンAPI：

from asposeslides.api import Presentation, ImageFormat


pres = Presentation("pres.pptx");

slideImage = pres.getSlides().get_Item(0).getImage();
slideImage.save("slide1.png", ImageFormat.Png);
slideImage.dispose();

pres.dispose();

形状のサムネイルを取得する

非推奨APIを使用するコード：

from asposeslides.api import Presentation
from javax.imageio import ImageIO
from java.io import File
from java.awt import Dimension


pres = Presentation("pres.pptx");

shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThumbnail();
image_format = "PNG"
ImageIO.write(shapeImage, image_format, File("shape.png"))

pres.dispose();

モダンAPI：

from asposeslides.api import Presentation, ImageFormat


pres = Presentation("pres.pptx");

shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
shapeImage.save("shape.png", ImageFormat.Png);
shapeImage.dispose();

pres.dispose();

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

非推奨APIを使用するコード：

from asposeslides.api import Presentation, RenderingOptions
from javax.imageio import ImageIO
from java.io import File
from java.awt import Dimension


pres = Presentation("pres.pptx");

image_format = "PNG"
rendering_options = RenderingOptions();
bitmaps = pres.getThumbnails(rendering_options, Dimension(1980, 1028));

for index in range(bitmaps.length):
    thumbnail = bitmaps[index];
    ImageIO.write(thumbnail, "PNG", File("slide" + str(index) + ".png"));
    
pres.dispose();

モダンAPI：

from asposeslides.api import Presentation, RenderingOptions, ImageFormat
from java.awt import Dimension


pres = Presentation("pres.pptx");

rendering_options = RenderingOptions();
images = pres.getImages(rendering_options, Dimension(1980, 1028));

for index in range(images.length):
    thumbnail = images[index];
    thumbnail.save("slide" + str(index) + ".png", ImageFormat.Png);
    thumbnail.dispose();

pres.dispose();

プレゼンテーションに画像を追加する

非推奨APIを使用するコード：

from asposeslides.api import Presentation, ShapeType
from javax.imageio import ImageIO
from java.io import File


pres = Presentation();

bufferedImages = ImageIO.read(File("image.png"));
ppImage = pres.getImages().addImage(bufferedImages);

pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

pres.dispose();

モダンAPI：

from asposeslides.api import Presentation, ShapeType, Images
from java.awt import Dimension


pres = Presentation();

image = Images.fromFile("image.png");
ppImage = pres.getImages().addImage(image);
image.dispose();

pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

pres.dispose();

削除されるメソッドとモダンAPIにおけるその置き換え

プレゼンテーション

メソッドシグネチャ	置き換えメソッドシグネチャ
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)

形状

メソッドシグネチャ	置き換えメソッドシグネチャ
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)

スライド

メソッドシグネチャ	置き換えメソッドシグネチャ
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)	完全に削除されます

出力

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

ImageCollection

メソッドシグネチャ	置き換えメソッドシグネチャ
public final IPPImage addImage(BufferedImage image)	public final IPPImage 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)

APIのGraphics2Dサポートは廃止されます

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

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

スライド

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