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 インタラクティブシェル
例
print(PIL.__version__)
方法2:コマンドラインで確認
python3 -c "import PIL; print(PIL.__version__)"
インストール成功時には Pillow のバージョン番号が表示されます。
よくある問題の解決
1. インストール失敗
考えられる原因:
- 依存ライブラリの不足(zlib、libjpeg など)
- 権限の問題
解決策:
Linux/macOS ユーザーは最初にシステム依存関係をインストールする必要がある場合があります:
例
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 のインストールが成功したら、その強力な画像処理機能を使い始めることができます:
例
# 画像を開く
img = Image.open("example.jpg")
# 画像を表示
img.show()
# 画像形式を変換
img.save("example.png")
# サイズ変更
small_img = img.resize((100, 100))
small_img.save("small_example.jpg")
コードの説明:
モジュールのインポート
from PIL import Image→ Pillow の Image モジュールをインポート
画像を開く
img = Image.open("example.jpg")→ 指定したパスの画像ファイルを読み込む対応形式:JPG/PNG/GIF/BMP など
画像を表示
img.show()→ システムの既定の画像ビューアで開くデバッグ専用であり、本番環境では推奨されません
画像を保存
img.save("example.png")→ 指定した形式で保存形式はファイル拡張子(.jpg / .png など)によって決まります
サイズ調整
small_img = img.resize((100,100))→ 100×100 ピクセルに強制的にリサイズ注意:元画像の縦横比が変わります
新しい画像を保存
small_img.save("small_example.jpg")→ リサイズ後の画像を保存quality パラメータを追加して JPEG 品質を制御できます