Pillow ImageOps モジュール

ImageOps は Python Pillow 画像処理ライブラリの実用的なモジュールで、一連の定義済み画像処理操作を提供します。これらの操作は通常、PIL.Image モジュール機能のカプセル化と簡素化であり、開発者がより簡潔なコードで一般的な画像処理ニーズを実現できるようにします。


ImageOps モジュールの主な特徴

  1. 操作の簡素化:複雑な画像処理フローを単一の関数呼び出しにカプセル化する
  2. 標準化処理:標準化された画像処理方法を提供する
  3. 実用的な機能:さまざまな実用的な画像処理機能を含む
  4. 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")

より実用的な例

実例

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

注意事項

  1. 画像モード:一部の ImageOps メソッドは画像モードに対して特定の要件があり、例えばcolorize()グレースケール画像が必要
  2. パフォーマンスの考慮:大きな画像を処理する場合、一部の操作は多くのメモリを消費する可能性があります。
  3. パラメータの範囲:パラメータの有効範囲に注意してください。例えば、posterize()bits パラメータは1〜8の間でなければなりません。
  4. 元の画像の保護:ImageOps メソッドは通常、新しい画像オブジェクトを返すため、元の画像は変更されません。

まとめ

ImageOps モジュールは Pillow ライブラリの中でも非常に実用的なツールセットであり、多くの一般的な画像処理タスクを簡素化します。これらのメソッドを習得することで、開発者は複雑なコードを書くことなく、さまざまな画像処理効果を迅速に実現できます。より高度な画像処理が必要な場面では、PIL.Image モジュールの他の機能と組み合わせて使用できます。

その他の拡張