Pillow ImageTk モジュール
ImageTk は、Python の画像処理ライブラリ Pillow(PIL の派生版)のサブモジュールで、主に Tkinter GUI プログラムで画像を表示および処理するために使用されます。
ImageTk はPhotoImageクラスの代替手段を提供し、より多くの画像形式(JPEG、PNG など)をサポートし、画像データを直接操作できます。
インポート方法:
from PIL import Image, ImageTk
ImageTk の主要メソッド
次の表にImageTkモジュールの主要メソッドとその機能の説明を示します:
| メソッド | 引数 | 戻り値 | 機能の説明 |
|---|---|---|---|
ImageTk.PhotoImage() |
image(PIL.Image オブジェクト)size(オプション、サイズ変更)format(オプション、形式指定) |
PhotoImageオブジェクト |
PIL.Image オブジェクトを Tkinter 互換の画像オブジェクトに変換します |
ImageTk.BitmapImage() |
file(ビットマップファイルのパス)background(背景色)foreground(前景色) |
BitmapImageオブジェクト |
ビットマップ(.xbm 形式)を読み込み、Tkinter 画像オブジェクトに変換します |
ImageTk.getimage() |
photoimage(Tkinter.PhotoImage オブジェクト) |
PIL.Image オブジェクト | Tkinter の PhotoImage オブジェクトを PIL.Image オブジェクトに戻します |
基本的な使用例
画像を表示する
例
from PIL import Image, ImageTk
import tkinter as tk
root = tk.Tk()
# 画像を読み込んで Tkinter 形式に変換
image = Image.open("example.jpg")
photo = ImageTk.PhotoImage(image)
# Label に表示する
label = tk.Label(root, image=photo)
label.pack()
root.mainloop()
import tkinter as tk
root = tk.Tk()
# 画像を読み込んで Tkinter 形式に変換
image = Image.open("example.jpg")
photo = ImageTk.PhotoImage(image)
# Label に表示する
label = tk.Label(root, image=photo)
label.pack()
root.mainloop()
画像を動的に更新する
例
def update_image():
new_image = Image.open("new_image.jpg")
new_photo = ImageTk.PhotoImage(new_image)
label.config(image=new_photo)
label.image = new_photo # ガベージコレクションに回収されないようにする
button = tk.Button(root, text="画像を更新", command=update_image)
button.pack()
new_image = Image.open("new_image.jpg")
new_photo = ImageTk.PhotoImage(new_image)
label.config(image=new_photo)
label.image = new_photo # ガベージコレクションに回収されないようにする
button = tk.Button(root, text="画像を更新", command=update_image)
button.pack()
注意事項
- メモリ管理:Tkinter の
PhotoImageオブジェクトは長期間参照される必要があります(グローバル変数やコントロールの属性にバインドするなど)。そうしないと、ガベージコレクションによって画像が消えてしまいます。 - スレッドセーフ:Tkinter と
ImageTkの操作はメインスレッドで実行する必要があります。 - 形式のサポート:
ImageTk.PhotoImagePillow がデコードできるすべての形式(PNG、JPEG など)をサポートしますが、BitmapImageサポートされるのは .xbm ビットマップのみです。
よくある質問
画像が表示されない
- 原因:正しく保持されていない
PhotoImageオブジェクトの参照。 - 解決策:画像オブジェクトを
photoコントロールまたはグローバル変数にバインドします:label.image = photo # 关键!
パフォーマンスの最適化
- 大きい画像には
thumbnail()或resize()事前のリサイズを使用します:image.thumbnail((800, 600)) # 限制最大尺寸