ImageSequence モジュール

ImageSequence は、Python Pillow ライブラリ(PIL のフォーク)のモジュールで、マルチフレーム画像(GIF、TIFF などの形式)を処理することに特化しています。

ImageSequence モジュールを使用すると、画像シーケンス内の各フレームに反復的にアクセスでき、アニメーション画像や複数ページを含む画像ファイルの処理に非常に適しています。


ImageSequence の主な用途

  1. アニメーションGIFの処理:GIFアニメーションをフレームごとに読み取り、操作する
  2. マルチページTIFFの処理:TIFFファイル内の各ページにアクセスする
  3. 画像シーケンスの処理:複数の画像を含む単一のファイルを一括処理する
  4. フレームの抽出と分析:アニメーション画像から特定のフレームを抽出して分析または修正する

ImageSequence モジュールの核心的なメソッド

以下は、ImageSequence モジュールで最もよく使われるメソッドとその機能説明です:

メソッド/属性 説明 戻り値 例
ImageSequence.Iterator(image) 画像シーケンスを走査するためのイテレータオブジェクトを作成する イテレータオブジェクト for frame in ImageSequence.Iterator(img):
ImageSequence.all_frames(image) すべてのフレームを含むリストを返す リスト frames = list(ImageSequence.all_frames(img))
seek(frame) 指定したフレームにジャンプする(一部の画像形式でサポート) None img.seek(5) # 6番目のフレームにジャンプ
tell() 現在のフレームのインデックス位置を返す 整数 current_frame = img.tell()
n_frames 画像内の総フレーム数を返す 整数 total_frames = img.n_frames

使用例

1. 基本的な使い方:GIF アニメーションのすべてのフレームを走査する

実例

from PIL import Image, ImageSequence

# GIFファイルを開く
with Image.open('animation.gif') as img:
    # 各フレームを走査する
    for i, frame in enumerate(ImageSequence.Iterator(img)):
        # 各フレームを処理する
        frame.save(f'frame_{i}.png')  # 個別のPNGファイルとして保存する

2. TIFF ファイルのすべてのページを抽出する

実例

from PIL import Image, ImageSequence

# マルチページTIFFファイルを開く
with Image.open('multipage.tiff') as img:
    # すべてのフレームを取得する
    frames = list(ImageSequence.all_frames(img))
   
    # 各ページを処理する
    for i, page in enumerate(frames):
        page.save(f'page_{i}.jpg', quality=95)

3. アニメーションGIFを編集して保存する

実例

from PIL import Image, ImageSequence

# 元のGIFを開く
with Image.open('source.gif') as img:
    # 新しいフレームリストを準備する
    new_frames = []
   
    # 各フレームを処理する
    for frame in ImageSequence.Iterator(img):
        # 各フレームを修正する(例えばテキストを追加する)
        modified_frame = frame.copy()
        # ... ここに修正コードを追加 ...
       
        new_frames.append(modified_frame)
   
    # 修正後のGIFを保存する
    new_frames[0].save('modified.gif',
                      save_all=True,
                      append_images=new_frames[1:],
                      duration=img.info.get('duration', 100),
                      loop=0)

注意事項

  1. メモリ使用量:大きなマルチフレーム画像を処理する場合、メモリ消費に注意し、すべてのフレームを一度に読み込むのではなく、フレームごとに処理することを検討してください
  2. 形式のサポート:すべての画像形式がマルチフレーム操作をサポートしているわけではありません。一般的なサポート形式には GIF、TIFF、WebP などがあります
  3. フレームインデックス:フレームインデックスは0から始まります。一般的な画像ビューアの表示とは異なる場合があります(ビューアは通常1から数えます)
  4. 元画像の修正:フレームを直接変更すると元画像に影響を与える可能性があるため、frame.copy()コピーを作成してから変更することをお勧めします

まとめ

ImageSequence モジュールは、マルチフレーム画像を処理するためのシンプルかつ強力なツールを提供します。そのイテレータインターフェースを通じて、開発者はアニメーションやページ分割された画像の各フレームに簡単にアクセスして操作できます。フレームの抽出、コンテンツの分析、新しいアニメーションの作成のいずれにおいても、このモジュールはワークフローを大幅に簡素化できます。

その他の拡張