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

画像を動的に更新する

例

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

注意事項

  1. メモリ管理:Tkinter のPhotoImageオブジェクトは長期間参照される必要があります(グローバル変数やコントロールの属性にバインドするなど)。そうしないと、ガベージコレクションによって画像が消えてしまいます。
  2. スレッドセーフ:Tkinter とImageTkの操作はメインスレッドで実行する必要があります。
  3. 形式のサポート:ImageTk.PhotoImagePillow がデコードできるすべての形式(PNG、JPEG など)をサポートしますが、BitmapImageサポートされるのは .xbm ビットマップのみです。

よくある質問

画像が表示されない

  • 原因:正しく保持されていないPhotoImageオブジェクトの参照。
  • 解決策:画像オブジェクトをphotoコントロールまたはグローバル変数にバインドします:
    label.image = photo  # 关键!

パフォーマンスの最適化

  • 大きい画像にはthumbnail() 或 resize()事前のリサイズを使用します:
    image.thumbnail((800, 600))  # 限制最大尺寸
その他の拡張