モダン 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.Slides for Python のパブリック API の 変更 により 非推奨 となっています。

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

aspose.pydrawing に依存する非推奨 API の削除は 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)

削除されるメンバーとモダン API での置換

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 に依存する削除対象メンバー:

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

よくある質問

なぜ aspose.pydrawing.Graphics が廃止されたのですか？

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

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

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

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

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

Python でプレゼンテーションの表示プロパティを取得および更新する よくある質問