ImageSequence モジュール
ImageSequence は、Python Pillow ライブラリ(PIL のフォーク)のモジュールで、マルチフレーム画像(GIF、TIFF などの形式)を処理することに特化しています。
ImageSequence モジュールを使用すると、画像シーケンス内の各フレームに反復的にアクセスでき、アニメーション画像や複数ページを含む画像ファイルの処理に非常に適しています。
ImageSequence の主な用途
- アニメーションGIFの処理:GIFアニメーションをフレームごとに読み取り、操作する
- マルチページTIFFの処理:TIFFファイル内の各ページにアクセスする
- 画像シーケンスの処理:複数の画像を含む単一のファイルを一括処理する
- フレームの抽出と分析:アニメーション画像から特定のフレームを抽出して分析または修正する
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ファイルとして保存する
# 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)
# マルチページ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)
# 元の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)
注意事項
- メモリ使用量:大きなマルチフレーム画像を処理する場合、メモリ消費に注意し、すべてのフレームを一度に読み込むのではなく、フレームごとに処理することを検討してください
- 形式のサポート:すべての画像形式がマルチフレーム操作をサポートしているわけではありません。一般的なサポート形式には GIF、TIFF、WebP などがあります
- フレームインデックス:フレームインデックスは0から始まります。一般的な画像ビューアの表示とは異なる場合があります(ビューアは通常1から数えます)
- 元画像の修正:フレームを直接変更すると元画像に影響を与える可能性があるため、
frame.copy()コピーを作成してから変更することをお勧めします
まとめ
ImageSequence モジュールは、マルチフレーム画像を処理するためのシンプルかつ強力なツールを提供します。そのイテレータインターフェースを通じて、開発者はアニメーションやページ分割された画像の各フレームに簡単にアクセスして操作できます。フレームの抽出、コンテンツの分析、新しいアニメーションの作成のいずれにおいても、このモジュールはワークフローを大幅に簡素化できます。
その他の拡張