ImageTk モジュール

ImageTk モジュールには、PIL画像からTkinter BitmapImageおよびPhotoImageオブジェクトを作成および変更するためのサポートが含まれています。

例については、Scriptsディレクトリのデモプログラムを参照してください。

class PIL.ImageTk.BitmapImage(image: Image | None = None, **kw: Any)

Tkinterと互換性のあるビットマップ画像です。Tkinterが画像オブジェクトを期待する場所でどこでも使用できます。

指定された画像は、「1」モードでなければなりません。値が0のピクセルは透過処理されます。オプションがある場合は、Tkinterに渡されます。最も一般的に使用されるオプションはforegroundで、非透過部分の色を指定するために使用されます。色の指定方法については、Tkinterのドキュメントを参照してください。

パラメータ：

image – PIL画像。

height() → int

画像の高さを取得します。

戻り値：

ピクセル単位の高さ。

width() → int

画像の幅を取得します。

戻り値：

ピクセル単位の幅。

class PIL.ImageTk.PhotoImage(image: Image | str | None = None, size: tuple[int, int] | None = None, **kw: Any)

Tkinterと互換性のあるフォト画像です。Tkinterが画像オブジェクトを期待する場所でどこでも使用できます。画像がRGBA画像の場合、アルファ値が0のピクセルは透過処理されます。

コンストラクタは、PIL画像、またはモードとサイズを受け取ります。あるいは、fileまたはdataオプションを使用して、フォトイメージオブジェクトを初期化することもできます。

パラメータ：

• image – PIL画像、またはモード文字列のいずれか。モード文字列を使用する場合は、サイズも指定する必要があります。

• size – 最初の引数がモード文字列の場合、これは画像のサイズを定義します。

• file – (Image.open(file)を使用して) 画像を読み込むファイル名。

• data – 画像データを含む8ビット文字列（画像ファイルから読み込まれたもの）。

height() → int

画像の高さを取得します。

戻り値：

ピクセル単位の高さ。

paste(im: Image) → None

PIL画像をPhotoImageに貼り付けます。PhotoImageが表示されている場合、非常に遅くなる可能性があります。

パラメータ：

im – PIL画像。サイズはターゲット領域と一致する必要があります。モードが一致しない場合は、ビットマップ画像のモードに変換されます。

width() → int

画像の幅を取得します。

戻り値：

ピクセル単位の幅。