Pillow インストール

Pillow をインストールする前に、以下を確認してください:

  • Python 3.7 以降(最新版を推奨)
  • pip パッケージマネージャー(通常 Python に同梱)
  • プラットフォームによっては、追加のシステムライブラリや開発ツールが必要な場合があります

Python バージョン

Pillow には Python 3.7 以降が必要です。

次のコマンドで Python バージョンを確認できます:

python --version
# 或
python3 --version

pip ツール

pip は Python のパッケージ管理ツールで、通常 Python に同梱されています。

pip が利用可能か確認する:

pip --version
# 或
pip3 --version

pip がインストールされていない場合は、以下を参照してください公式 pip インストールガイドを参照してインストールしてください。


Pillow をインストール

基本的なインストール方法

最も簡単な方法は pip を使ったインストールです:

pip install pillow

または Python 3 を明示的に指定する場合:

pip3 install pillow

Anaconda Python ディストリビューションを使用している場合:

conda install -c anaconda pillow

特定バージョンのインストール

Pillow の特定バージョンをインストールする必要がある場合:

pip install pillow==9.0.0

仮想環境でのインストール

依存関係の競合を避けるため、仮想環境で Pillow をインストールすることをお勧めします:

# 创建虚拟环境
python -m venv pillow_env

# 激活虚拟环境
# Windows:
pillow_env\Scripts\activate

# 安装 Pillow
pip install Pillow

ソースコードからインストール

上級ユーザー向けに、ソースコードからインストールすることもできます:

ソースコードをダウンロード:

git clone https://github.com/python-pillow/Pillow.git
cd Pillow

依存関係をインストール:

pip install -r requirements.txt

コンパイルしてインストール:

python setup.py install

インストールの確認

インストール完了後、以下の方法で Pillow が正常にインストールされたか確認できます:

方法1:Python インタラクティブシェル

例

import PIL
print(PIL.__version__)

方法2:コマンドラインで確認

python3 -c "import PIL; print(PIL.__version__)"

インストール成功時には Pillow のバージョン番号が表示されます。


よくある問題の解決

1. インストール失敗

考えられる原因:

  • 依存ライブラリの不足(zlib、libjpeg など)
  • 権限の問題

解決策:

Linux/macOS ユーザーは最初にシステム依存関係をインストールする必要がある場合があります:

例

# Ubuntu/Debian
sudo apt-get install python3-dev python3-setuptools
 
# Fedora
sudo dnf install python3-devel

# macOS (Homebrew を使用)
brew install zlib jpeg

--user パラメータを使用して権限の問題を回避:

pip install --user pillow

2. インポートエラー

次のようなエラーが発生した場合ImportError: cannot import name '_imaging' from 'PIL'などのエラーが発生した場合は、次を試してください:

pip uninstall pillow
pip install --no-cache-dir pillow

3. パフォーマンスの問題

大規模な画像処理には、最適化されたバージョンのインストールを検討できます:
pip install pillow-simd

最初のPillowプログラム

Pillow のインストールが成功したら、その強力な画像処理機能を使い始めることができます:

例

from PIL import Image

# 画像を開く
img = Image.open("example.jpg")

# 画像を表示
img.show()

# 画像形式を変換
img.save("example.png")

# サイズ変更
small_img = img.resize((100, 100))
small_img.save("small_example.jpg")

コードの説明:

  1. モジュールのインポート

    • from PIL import Image→ Pillow の Image モジュールをインポート

  2. 画像を開く

    • img = Image.open("example.jpg")→ 指定したパスの画像ファイルを読み込む

    • 対応形式:JPG/PNG/GIF/BMP など

  3. 画像を表示

    • img.show()→ システムの既定の画像ビューアで開く

    • デバッグ専用であり、本番環境では推奨されません

  4. 画像を保存

    • img.save("example.png")→ 指定した形式で保存

    • 形式はファイル拡張子(.jpg / .png など)によって決まります

  5. サイズ調整

    • small_img = img.resize((100,100))→ 100×100 ピクセルに強制的にリサイズ

    • 注意:元画像の縦横比が変わります

  6. 新しい画像を保存

    • small_img.save("small_example.jpg")→ リサイズ後の画像を保存

    • quality パラメータを追加して JPEG 品質を制御できます

その他の拡張