Python でプレゼンテーションのピクチャーフレームを管理する

このページの概要

Aspose.Slides for Python via .NET を使用して、プレゼンテーション内のピクチャーフレームを作成、書式設定、リンク、クロップ、抽出、圧縮します。

概要

Picture frame は画像を表示するスライドシェイプです。Aspose.Slides では、画像リソースとそれを表示するシェイプは別々のオブジェクトです。 Presentation は埋め込み画像リソースをその ImageCollection を通じて所有し、PictureFrame は画像の位置、サイズ、線の書式設定、回転、クロップ、画像効果、およびその他のフレームレベルの設定を制御します。

この分離は同じ画像を複数回表示する場合に便利です。画像をプレゼンテーションに一度だけ追加し、返される PPImage を保持し、PictureFrame を作成する際にその画像リソースを使用します。

PictureFrame は PNG や JPEG などのラスタ画像や SVG などのベクター画像を含めることができます。また、画像バイトをプレゼンテーションに格納せずにリンク画像を参照することも可能です。選択はポータビリティ、ファイルサイズ、抽出、エクスポート動作に影響するため、書式設定や最適化を適用する前に画像の保存方法を決めておくと便利です。

埋め込み画像の追加と書式設定

埋め込み画像の場合、画像データをプレゼンテーションに追加し、ShapeCollection.add_picture_frame でピクチャーフレームを作成します。画像はプレゼンテーションパッケージの一部になるため、別のコンピューターに移動してもプレゼンテーションは自己完結します。

次の例は JPEG 画像を追加し、画像のネイティブ寸法でフレームを作成し、線の書式設定と回転を適用します。

import aspose.pydrawing as draw
import aspose.slides as slides

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

    with slides.Images.from_file("photo.jpg") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 100, image.width, image.height, image)
    picture_frame.line_format.fill_format.fill_type = slides.FillType.SOLID
    picture_frame.line_format.fill_format.solid_fill_color.color = draw.Color.blue
    picture_frame.line_format.width = 3
    picture_frame.rotation = 15

    presentation.save("picture-frame.pptx", slides.export.SaveFormat.PPTX)

PictureFrame は表示されるジオメトリを制御します。フレームサイズを変更しても、埋め込み画像リソースに保存されている元のピクセル寸法は変わりません。この区別は後で画像をクロップまたは圧縮する際に重要になります。

相対スケールの使用

PictureFrame はフレーム用に relative_scale_width と relative_scale_height を公開します。1.0 の値は元の画像サイズの 100% に相当します。相対スケールは、最終寸法を手動で計算する代わりに、元画像サイズとの関係を保持したいワークフローで便利です。

import aspose.slides as slides

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

    with slides.Images.from_file("photo.jpg") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)
    picture_frame.relative_scale_width = 1.35
    picture_frame.relative_scale_height = 0.8

    presentation.save("relative-scale.pptx", slides.export.SaveFormat.PPTX)

相対スケールはフレームのスケール設定を変更しますが、埋め込み画像をリサンプリングしたり圧縮したりはしません。

埋め込み画像とリンク画像

埋め込み画像は画像データをプレゼンテーション内に格納するため、ポータビリティと予測可能なレンダリングに最も安全な選択です。リンク画像は Picture のリンクパスを介して外部ロケーションを保存し、画像データを同様に埋め込むことはありません。

リンク画像は PPTX に保存される画像データ量を減らすことができますが、外部依存性が生じます。リンク先のファイルはプレゼンテーションを開くまたはレンダリングするアプリケーションがアクセスできる状態である必要があります。パスが変更されたり、ファイルが移動したり、リソースが利用できなくなった場合、リンク画像は期待どおりに表示されない可能性があります。メールで送付したり、アーカイブしたり、隔離された環境でレンダリングする必要があるプレゼンテーションでは、埋め込み画像の方が通常は信頼性が高いです。

リンク画像の追加

次の例はピクチャーフレームを作成し、ローカル画像ファイルを指すように設定します。この例は画像リンクのみを扱い、ビデオリンクは別のメディアワークフローであり、意図的にこの例に混在させていません。

import os
import aspose.slides as slides

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

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 320, 180, None)
    linked_image_path = os.path.abspath("linked-image.jpg")
    picture_frame.picture_format.picture.link_path_long = linked_image_path

    presentation.save("linked-image.pptx", slides.export.SaveFormat.PPTX)

外部ファイル管理が意図的である場合にリンクを使用してください。圧縮の代替として単に使用しないでください。壊れた画像依存関係を持つ小さな PPTX は、サイズは小さくても自己完結プレゼンテーションより実用性が低いことが多いです。

ピクチャーフレームから画像を抽出する

既存のプレゼンテーションから画像を抽出する前に、シェイプが実際に PictureFrame であり、埋め込み画像を含んでいるかを確認してください。リンクピクチャーフレームは、同じ方法で抽出できる画像バイトを含まない可能性があります。

ラスタ画像の抽出

最新の画像 API は IImage を直接使用します。次の例はスライド上の最初の埋め込みラスタ画像を見つけ、PNG として保存します。

import aspose.slides as slides

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

    for shape in slide.shapes:
        if not isinstance(shape, slides.PictureFrame):
            continue

        embedded_image = shape.picture_format.picture.image
        if embedded_image is None or embedded_image.svg_image is not None:
            continue

        raster_image = embedded_image.image
        raster_image.save("extracted-image.png", slides.ImageFormat.PNG)
        break

IImage を介して保存すると、抽出した画像が要求された出力形式に変換されます。プレゼンテーションに格納されているエンコード済みバイトが必要な場合は、代わりに PPImage.binary_data プロパティを使用してください。

SVG 画像の抽出

SVG 画像の場合、PPImage は SvgImage オブジェクトを公開します。これにより、画像をラスタライズせずに SVG データを直接取得できます。

import aspose.slides as slides

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

    for shape in slide.shapes:
        if not isinstance(shape, slides.PictureFrame):
            continue

        embedded_image = shape.picture_format.picture.image
        svg_image = embedded_image.svg_image if embedded_image is not None else None
        if svg_image is None:
            continue

        svg_data = bytes(svg_image.svg_data)
        with open("extracted-image.svg", "wb") as svg_stream:
            svg_stream.write(svg_data)
        break

SVG コンテンツを SVG のまま保持すると、プレゼンテーション内にベクトルソースが保存されます。PNG や JPEG などのラスタエクスポートは、そのベクトルコンテンツをピクセルにレンダリングします。PDF や SVG へのスライドエクスポートもレンダリング操作であるため、エクスポートされたグラフィックは元の埋め込み SVG のバイト単位のコピーとして扱うべきではありません。元のベクトルリソースが必要なときは、埋め込みの SvgImage.svg_data を使用してください。

画像のクロップ

クロップはフレーム内で画像のどの部分が表示されるかを変更します。PictureFillFormat のクロップ値は元画像の寸法に対するパーセンテージです。クロップは最初に埋め込み画像から隠れたピクセルを削除するのではなく、表示領域を変更するだけです。

次の例はピクチャーフレームを安全に取得し、クロップ値を適用します。

import aspose.slides as slides

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

    for shape in slide.shapes:
        if isinstance(shape, slides.PictureFrame):
            picture_frame = shape
            break

    if picture_frame is not None:
        picture_frame.picture_format.crop_left = 23.6
        picture_frame.picture_format.crop_right = 21.5
        picture_frame.picture_format.crop_top = 3
        picture_frame.picture_format.crop_bottom = 31
        presentation.save("cropped-image.pptx", slides.export.SaveFormat.PPTX)

隠れた画像データは依然として存在するため、後で元のピクセルを失うことなくクロップを変更できます。ファイルサイズが重要で、可逆性が不要な場合は、次のセクションで説明するようにクロップ領域を物理的に削除できます。

クロップされた画像データの削除

PictureFillFormat.delete_picture_cropped_areas は現在のクロップ矩形の外側にある画像データを削除し、結果の画像リソースを返します。これによりファイルサイズが削減できる可能性がありますが、破壊的な最適化です。プレゼンテーションを保存した後は、削除されたピクセルは後からのアンクロップ操作で利用できなくなります。

import aspose.slides as slides

with slides.Presentation("cropped-image.pptx") as presentation:
    slide = presentation.slides[0]
    picture_frame = None

    for shape in slide.shapes:
        if isinstance(shape, slides.PictureFrame):
            picture_frame = shape
            break

    if picture_frame is not None:
        cropped_image = picture_frame.picture_format.delete_picture_cropped_areas()
        if cropped_image is not None:
            presentation.save("cropped-data-removed.pptx", slides.export.SaveFormat.PPTX)

このメソッドはプレゼンテーションに新しい画像リソースを追加することがあります。元画像が他のピクチャーフレームでも使用されている場合、これらのフレームは既存のリソースを引き続き必要とするため、クロップ領域を削除しても画像総数が減るとは限りません。WMF や EMF コンテンツをこのメソッドでクロップすると、結果は PNG にラスタライズされます。

ラスタ画像の圧縮

PictureFillFormat.compress_image は表示サイズに対してラスタ画像の解像度を下げます。同時にクロップ領域を削除することもできます。画像がリサイズまたはクロップされた場合は True を、変更が不要だった場合は False を返します。

標準のターゲット解像度で十分な場合は、事前定義された PicturesCompression 値を使用してください。

import aspose.slides as slides

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

    for shape in slide.shapes:
        if isinstance(shape, slides.PictureFrame):
            picture_frame = shape
            break

    if picture_frame is not None:
        compressed = picture_frame.picture_format.compress_image(True, slides.export.PicturesCompression.DPI150)
        print("The image was compressed." if compressed else "No compression was necessary.")
        presentation.save("compressed-image.pptx", slides.export.SaveFormat.PPTX)

特定のターゲットが必要なときは、列挙値の代わりにカスタムの正の DPI 値を渡すこともできます。

圧縮はラスタ画像を対象としています。SVG やメタファイルのコンテンツはこのラスタ圧縮ワークフローでは縮小されません。また、解像度を下げたりクロップ領域を削除したりすると、最適化されたプレゼンテーションから元に戻すことはできません。最終的に実際に表示またはエクスポートされる最大サイズに基づいてターゲット解像度を選択し、全体的に最も低い DPI を適用しないようにしてください。

画像変換効果の管理

明るさ、コントラスト、カラー変換、ぼかし、アルファ効果、順序チェーン、検査、削除、ラウンドトリップ検証を網羅した完全なワークフローについては、Image Transform Effects を参照してください。

ピクチャーフレームジオメトリのロック

PictureFrameLock 設定は、ピクチャーフレームに対して無効化する編集操作を制御します。たとえば、aspect_ratio_locked プロパティはリサイズ時にシェイプの比率を保持します。

import aspose.slides as slides

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

    with slides.Images.from_file("photo.jpg") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 100, image.width, image.height, image)
    picture_frame.picture_frame_lock.aspect_ratio_locked = True

    presentation.save("locked-picture-frame.pptx", slides.export.SaveFormat.PPTX)

ロックはピクチャーフレームシェイプに適用されます。ソース画像がリサンプリングされたり、同じアスペクト比に永久的に変更されたりすることは強制されません。

StretchOffset 値の調整

ピクチャー塗りつぶしモードが stretch の場合、PictureFillFormat の stretch‑offset 値はピクチャーフレームのバウンディングボックスに対する塗りつぶし矩形を定義します。正のパーセンテージはエッジからのインセットを作り、負のパーセンテージはアウトセットを作ります。

これはクロップとは異なります。クロップ値は元画像のどの部分が表示されるかを選択し、stretch offset は表示されるピクチャー塗りつぶしが伸張される矩形を変更します。

import aspose.slides as slides

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

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

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 10, 10, 400, 300, image)
    picture_frame.picture_format.picture_fill_mode = slides.PictureFillMode.STRETCH
    picture_frame.picture_format.stretch_offset_left = 12
    picture_frame.picture_format.stretch_offset_right = 12
    picture_frame.picture_format.stretch_offset_top = 8
    picture_frame.picture_format.stretch_offset_bottom = 8

    presentation.save("stretch-offsets.pptx", slides.export.SaveFormat.PPTX)

塗りつぶしの配置には stretch offset を使用し、元画像のエッジを隠す目的にはクロッププロパティを使用してください。

ストレージ、ファイルサイズ、エクスポートの考慮事項

画像のストレージとピクチャーフレーム書式設定を別々に扱うと、主なトレードオフが管理しやすくなります。

埋め込み画像 はプレゼンテーションを自己完結させ、共有やサーバー側レンダリングに最も信頼性が高いですが、大きなラスタ画像は PPTX のサイズとメモリ使用量を増加させます。
リンク画像 はパッケージを小さく保てますが、プレゼンテーションは外部ファイルが保存されたパスまたはロケーションに依存します。
クロップ は最初は非破壊的です。隠れたピクセルはクロップ領域が明示的に削除されるか圧縮時に除去されるまで埋め込まれたままです。
圧縮は過大なラスタ画像のファイルサイズを大幅に削減できますが、ソース解像度を犠牲にします。スライド上での最終表示サイズが判明した後に適用すべきです。
SVG 画像 はベクトル保存が重要な場合は SVG のままにすべきです。ベクトルリソース自体が必要なときは埋め込み SVG を直接抽出してください。ラスタスライドエクスポートは常にレンダリングされたスライドをピクセルに変換します。
繰り返し使用する画像 は可能な限り既存の PPImage リソースを再利用し、同じファイルを何度もプレゼンテーションワークフローにロードしないようにしてください。

大規模なプレゼンテーションでは、画像最適化は選択的に行うと最も効果的です。ロゴや図はベクトルコンテンツのまま保持し、写真は実際の表示サイズに応じて圧縮し、後で編集が不要な場合にのみクロップされたピクセルを削除し、外部リンクは依存関係管理がデプロイ設計の一部である場合にのみ使用してください。

FAQ

ピクチャーフレームと画像リソースの違いは何ですか？

PPImage はプレゼンテーションに関連付けられた画像リソースを表します。PictureFrame は画像を表示し、サイズ、回転、クロップ値、効果、ロックなどのフレームレベルのジオメトリと書式設定を保持するスライド上のシェイプです。

画像は埋め込むべきですか、リンクすべきですか？

プレゼンテーションをポータブルに、アーカイブ可能に、または外部リソースにアクセスせずにレンダリングする必要がある場合は埋め込み画像を使用してください。画像ファイルを PPTX の外に保持し、外部ロケーションを確実に管理できる場合にのみリンク画像を使用してください。

クロップは PPTX のファイルサイズを減らしますか？

単体では減らしません。通常のクロップ設定は画像の一部を非表示にするだけで、基になるピクセルは保持されます。ピクセルを永久に削除したい場合は、PictureFillFormat.delete_picture_cropped_areas またはクロップ領域削除を伴う画像圧縮を使用してください。

圧縮後に画像品質を復元できますか？

できません。圧縮は保存されたラスタ解像度を下げ、クロップ領域の削除は画像データを破棄します。後で高解像度の編集が必要になる可能性がある場合は、元のソース画像をプレゼンテーションの外に保管してください。

SVG 画像はどのように扱うべきですか？

ベクトルの忠実度が重要な場合は、SVG コンテンツを SVG のまま保持してください。埋め込みの SvgImage は直接抽出できます。PNG や JPEG などのラスタ形式にスライドをレンダリングすると、SVG はピクセルに変換されます。

既存スライドを読む際に安全でないキャストを回避するには？

シェイプがピクチャーフレームかどうかを使用する前に確認してください。isinstance(shape, slides.PictureFrame) を使用すれば、無効なキャストを回避し、ピクチャーフレームを含まないスライドでも安全に処理できます。

Python を使用したプレゼンテーションの画像変換効果の管理