Pillow ImageOps モジュール
ImageOps は Python Pillow 画像処理ライブラリの実用的なモジュールで、一連の定義済み画像処理操作を提供します。これらの操作は通常、PIL.Image モジュール機能のカプセル化と簡素化であり、開発者がより簡潔なコードで一般的な画像処理ニーズを実現できるようにします。
ImageOps モジュールの主な特徴
- 操作の簡素化:複雑な画像処理フローを単一の関数呼び出しにカプセル化する
- 標準化処理:標準化された画像処理方法を提供する
- 実用的な機能:さまざまな実用的な画像処理機能を含む
- PIL.Image と補完的:PIL.Image モジュールの機能を補完する
ImageOps モジュールのよく使用されるメソッド
以下は、ImageOps モジュールで最もよく使用されるメソッドとその機能説明です。
画像調整メソッド
| メソッド名 | パラメータ | 戻り値 | 機能説明 |
|---|---|---|---|
autocontrast(image, cutoff=0, ignore=None) |
image: 入力画像 cutoff: 切り取りパーセント(0-100) ignore: 無視する背景色 |
新しい画像オブジェクト | 画像のコントラストを自動調整し、画像内の最も暗いピクセルを黒に、最も明るいピクセルを白にします。 |
colorize(image, black, white) |
image: グレースケール画像 black: 黒色の置換色 white: 白色の置換色 |
新しい画像オブジェクト | グレースケール画像に色を付け、黒と白をそれぞれどの色にマッピングするかを指定します。 |
equalize(image, mask=None) |
image: 入力画像 mask: オプションのマスク |
新しい画像オブジェクト | 画像にヒストグラム均等化処理を施し、コントラストを強化します。 |
mirror(image) |
image: 入力画像 | 新しい画像オブジェクト | 画像を水平方向に反転(ミラー効果) |
画像変換メソッド
| メソッド名 | パラメータ | 戻り値 | 機能説明 |
|---|---|---|---|
expand(image, border, fill=0) |
image: 入力画像 border: 枠線の幅 fill: 塗りつぶし色 |
新しい画像オブジェクト | 画像に枠線を追加します |
fit(image, size, method=0, bleed=0.0, centering=(0.5, 0.5)) |
image: 入力画像 size: ターゲットサイズ method: リサイズ方法 bleed: 切り取り比率 centering: 中心点 |
新しい画像オブジェクト | 画像を指定サイズに調整し、アスペクト比を維持します。 |
flip(image) |
image: 入力画像 | 新しい画像オブジェクト | 画像を垂直方向に反転します |
scale(image, factor, resample=3) |
image: 入力画像 factor: スケール係数 resample: リサンプリング方法 |
新しい画像オブジェクト | 画像を比率に応じて拡大・縮小します。 |
画像エフェクトメソッド
| メソッド名 | パラメータ | 戻り値 | 機能説明 |
|---|---|---|---|
posterize(image, bits) |
image: 入力画像 bits: 保持するビット数(1-8) |
新しい画像オブジェクト | 画像の各色チャンネルのビット数を減らし、ポスタリゼーション効果を生成します。 |
solarize(image, threshold=128) |
image: 入力画像 threshold: しきい値(0-255) |
新しい画像オブジェクト | しきい値より高いすべてのピクセル値を反転し、露出過度の効果を生成します。 |
invert(image) |
image: 入力画像 | 新しい画像オブジェクト | 画像の色を反転(ネガ効果) |
使用例
基本的な使用例
実例
from PIL import Image, ImageOps
# 画像ファイルを開く
image = Image.open("example.jpg")
# コントラストを自動調整
adjusted_image = ImageOps.autocontrast(image)
# 処理後の画像を保存
adjusted_image.save("adjusted_example.jpg")
# 画像ファイルを開く
image = Image.open("example.jpg")
# コントラストを自動調整
adjusted_image = ImageOps.autocontrast(image)
# 処理後の画像を保存
adjusted_image.save("adjusted_example.jpg")
より実用的な例
実例
from PIL import Image, ImageOps
# 画像のネガを作成
image = Image.open("photo.jpg")
inverted_image = ImageOps.invert(image)
inverted_image.save("inverted_photo.jpg")
# 画像に枠線を追加
bordered_image = ImageOps.expand(image, border=50, fill="white")
bordered_image.save("bordered_photo.jpg")
# 画像の着色処理(まず画像をグレースケールに変換)
gray_image = ImageOps.grayscale(image)
colored_image = ImageOps.colorize(gray_image, black="blue", white="yellow")
colored_image.save("colored_photo.jpg")
# 画像のネガを作成
image = Image.open("photo.jpg")
inverted_image = ImageOps.invert(image)
inverted_image.save("inverted_photo.jpg")
# 画像に枠線を追加
bordered_image = ImageOps.expand(image, border=50, fill="white")
bordered_image.save("bordered_photo.jpg")
# 画像の着色処理(まず画像をグレースケールに変換)
gray_image = ImageOps.grayscale(image)
colored_image = ImageOps.colorize(gray_image, black="blue", white="yellow")
colored_image.save("colored_photo.jpg")
注意事項
- 画像モード:一部の ImageOps メソッドは画像モードに対して特定の要件があり、例えば
colorize()グレースケール画像が必要 - パフォーマンスの考慮:大きな画像を処理する場合、一部の操作は多くのメモリを消費する可能性があります。
- パラメータの範囲:パラメータの有効範囲に注意してください。例えば、
posterize()bits パラメータは1〜8の間でなければなりません。 - 元の画像の保護:ImageOps メソッドは通常、新しい画像オブジェクトを返すため、元の画像は変更されません。
まとめ
ImageOps モジュールは Pillow ライブラリの中でも非常に実用的なツールセットであり、多くの一般的な画像処理タスクを簡素化します。これらのメソッドを習得することで、開発者は複雑なコードを書くことなく、さまざまな画像処理効果を迅速に実現できます。より高度な画像処理が必要な場面では、PIL.Image モジュールの他の機能と組み合わせて使用できます。
その他の拡張