モダン API を使用した画像処理の強化

はじめに

現在、Aspose.Slides for Python のパブリック API は以下の aspose.pydrawing タイプに依存しています:

  • aspose.pydrawing.Graphics
  • aspose.pydrawing.Image
  • aspose.pydrawing.Bitmap
  • aspose.pydrawing.printing.PrinterSettings

バージョン 24.4 以降、このパブリック API は 変更 により 非推奨 となりました。

aspose.pydrawing をパブリック API から排除するために、Modern API を導入しました。aspose.pydrawing.Image と aspose.pydrawing.Bitmap を使用するメソッドは非推奨となり、Modern API の同等機能に置き換えられます。aspose.pydrawing.Graphics を使用するメソッドは非推奨であり、サポートはパブリック API から削除されます。

非推奨 API（aspose.pydrawing に依存）の削除は 24.8 リリースで予定されています。

モダン API

パブリック API に次のクラスと列挙型が追加されました:

新しい API の典型的な使用シナリオは次のとおりです:

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with slides.Images.from_file("image.png") as image:
        pp_image = presentation.images.add_image(image)

    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

    with slide.get_image(drawing.Size(1920, 1080)) as slide_image:
        slide_image.save("slide1.jpeg", slides.ImageFormat.JPEG)

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

移行を容易にするために、新しい IImage クラスは Image と Bitmap クラスの個別 API を鏡のように提供します。ほとんどの場合、aspose.pydrawing を使用するメソッド呼び出しをモダン API の同等機能に置き換えるだけで済みます。

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

非推奨 API:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    slide.get_thumbnail().save("slide1.png")

モダン API:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    with slide.get_image() as image:
        image.save("slide1.png")

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

非推奨 API:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]
    
    shape.get_thumbnail().save("shape.png")

モダン API:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    with shape.get_image() as image:
        image.save("shape.png")

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

非推奨 API:

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation("sample.pptx") as presentation:
    thumbnails = presentation.get_thumbnails(slides.export.RenderingOptions(), drawing.Size(1980, 1028))

    for index, thumbnail in enumerate(thumbnails):
        thumbnail.save(f"slide_{index}.png", drawing.imaging.ImageFormat.png)

モダン API:

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation("sample.pptx") as presentation:
    thumbnails = presentation.get_images(slides.export.RenderingOptions(), drawing.Size(1980, 1028))

    for index, thumbnail in enumerate(thumbnails):
        thumbnail.save(f"slide_{index}.png", slides.ImageFormat.PNG)

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

非推奨 API:

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    image = drawing.Image.from_file("image.png")
    pp_image = presentation.images.add_image(image)
    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

モダン API:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with slides.Images.from_file("image.png") as image:
        pp_image = presentation.images.add_image(image)

    slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 100, 100, pp_image)

削除されるメソッドとプロパティおよびそのモダン置換

Presentation クラス

メソッドシグネチャ 置換メソッドシグネチャ
get_thumbnails(options) get_images(options)
get_thumbnails(options, slides) get_images(options, slides)
get_thumbnails(options, scale_x, scale_y) get_images(options, scale_x, scale_y)
get_thumbnails(options, slides, scale_x, scale_y) get_images(options, slides, scale_x, scale_y)
get_thumbnails(options, image_size) get_images(options, image_size)
get_thumbnails(options, slides, image_size) get_images(options, slides, image_size)
save(fname, format, response, show_inline) 完全に削除されます
save(fname, format, options, response, show_inline) 完全に削除されます
print() 完全に削除されます
print(printer_settings) 完全に削除されます
print(printer_name) 完全に削除されます
print(printer_settings, pres_name) 完全に削除されます

Slide クラス

メソッドシグネチャ 置換メソッドシグネチャ
get_thumbnail() get_image()
get_thumbnail(scale_x, scale_y) get_image(scale_x, scale_y)
get_thumbnail(image_size) get_image(image_size)
get_thumbnail(options) get_image(options: ITiffOotions)
get_thumbnail(options) get_image(options: IRenderingOptions)
get_thumbnail(options, scale_x, scale_y) get_image(options, scale_x, scale_y)
get_thumbnail(options, image_size) get_image(options, image_size)
render_to_graphics(options, graphics) 完全に削除されます
render_to_graphics(options, graphics, scale_x, scale_y) 完全に削除されます
render_to_graphics(options, graphics, rendering_size) 完全に削除されます

Shape クラス

メソッドシグネチャ 置換メソッドシグネチャ
get_thumbnail() get_image()
get_thumbnail(bounds, scale_x, scale_y) get_image(bounds, scale_x, scale_y)

ImageCollection クラス

メソッドシグネチャ 置換メソッドシグネチャ
add_image(image: aspose.pydrawing.Image) add_image(image)

PPImage クラス

メソッド/プロパティ シグネチャ 置換 メソッド/プロパティ シグネチャ
replace_image(new_image: aspose.pydrawing.Image) replace_image(new_image)
system_image image

ImageWrapperFactory クラス

メソッドシグネチャ 置換メソッドシグネチャ
create_image_wrapper(image: aspose.pydrawing.Image) create_image_wrapper(image)

PatternFormat クラス

メソッドシグネチャ 置換メソッドシグネチャ
get_tile_image(background, foreground) get_tile(background, foreground)
get_tile_image(style_color) get_tile(style_color)

IPatternFormatEffectiveData クラス

メソッドシグネチャ 置換メソッドシグネチャ
get_tile_image(background, foreground) get_tile_i_image(background, foreground)

Output クラス

メソッドシグネチャ 置換メソッドシグネチャ
add(path, image: aspose.pydrawing.Image) add(path, image)

aspose.pydrawing.Graphics の API サポートは終了します

aspose.pydrawing.Graphics を使用するメソッドは非推奨であり、サポートはパブリック API から削除されます。

aspose.pydrawing.Graphics に依存し、削除対象となる API メンバーは次のとおりです:

  • aspose.pydrawing.Slide.render_to_graphics(options, graphics)
  • aspose.pydrawing.Slide.render_to_graphics(options, graphics, scale_x, scale_y)
  • aspose.pydrawing.Slide.render_to_graphics(options, graphics, rendering_size)

FAQ

なぜ aspose.pydrawing.Graphics が削除されたのですか？

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

IImage は Image/Bitmap と比べて実用的にどんなメリットがありますか？

IImage はラスタとベクタの両方の画像操作を統一し、ImageFormat を通じてさまざまな形式への保存を簡素化し、pydrawing への依存を減らし、環境間でのコード移植性を高めます。

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

get_thumbnail から get_image への切り替えでパフォーマンスが低下することはありません。新しいメソッドはオプションやサイズ指定で同等の画像生成機能を提供し、レンダリングオプションも引き続きサポートします。具体的な性能向上または低下はシナリオ次第ですが、機能的には置換は同等です。

技術記事 既知の問題