Pillow ImageColor モジュール

ImageColor は Python Pillow 画像処理ライブラリのサブモジュールであり、色に関連する操作を処理するために特化しています。

ImageColor は、色文字列を RGB または RGBA 形式のタプルに変換する一連のメソッドを提供し、複数の色表現形式をサポートします。

ImageColor モジュールは小さいながらも、画像処理において重要な役割を果たします。特に、動的に色を指定する必要があるシナリオで重要です。

ImageColor モジュールは次の方法でインポートできます:

from PIL import ImageColor

ImageColor モジュールのコアメソッド

次の表に、ImageColor モジュールの主要なメソッドとその機能説明を示します:

メソッド名 パラメータ 戻り値 機能説明
getrgb(color) color色文字列 RGB タプル (r, g, b) 色文字列を RGB タプルに変換します
getcolor(color, mode) color色文字列
mode: ターゲットカラーモード
色値のタプル 色文字列を指定されたカラーモードの値に変換します
colormap 无 辞書 Pillow がサポートする色マッピングテーブルを返します

メソッドの詳細説明と例

getrgb() メソッド

getrgb()メソッドは最もよく使われるメソッドで、さまざまな形式の色文字列を標準の RGB タプルに変換します。

サポートされる形式は次のとおりです::

  • 16進数カラーコード:"#RRGGBB" 或 "#RGB"
  • RGB 関数表現:"rgb(255, 0, 0)"
  • HSL 関数表現:"hsl(0, 100%, 50%)"
  • 色名:"red", "blue" 等

サンプルコード:

例

from PIL import ImageColor

# 16進数カラー
print(ImageColor.getrgb("#ff0000"))  # 出力: (255, 0, 0)
print(ImageColor.getrgb("#f00"))    # 出力: (255, 0, 0)

# RGB 関数
print(ImageColor.getrgb("rgb(255, 0, 0)"))  # 出力: (255, 0, 0)

# 色名
print(ImageColor.getrgb("red"))    # 出力: (255, 0, 0)
print(ImageColor.getrgb("blue"))   # 出力: (0, 0, 255)

getcolor() メソッド

getcolor()メソッドはgetrgb()似ていますが、ターゲットカラーモードを指定できます。

サポートされるモードは次のとおりです::

  • "RGB"
  • "RGBA"
  • "L"(グレースケール)
  • "CMYK"
  • "HSV"

サンプルコード:

例

from PIL import ImageColor

# RGBA に変換
print(ImageColor.getcolor("red", "RGBA"))  # 出力: (255, 0, 0, 255)

# グレースケールに変換
print(ImageColor.getcolor("red", "L"))    # 出力: 76 (赤色のグレースケールでの値)

colormap 属性

colormapPillow がサポートするすべての名前付き色と、それに対応する16進数値を含む辞書です。

サンプルコード:

例

from PIL import ImageColor

# 色マッピングテーブルを取得
color_map = ImageColor.colormap

# 色の数を確認
print(f"Pillow は {len(color_map)} 種の名前付き色をサポートしています")

# 特定の色を確認
print("赤色の16進数値:", color_map["red"])  # 出力: #ff0000

実用的な応用例

単色画像の作成

例

from PIL import Image, ImageColor

# ImageColor を使用して色を取得
color = ImageColor.getrgb("lightblue")

# 200x200 の単色画像を作成
img = Image.new("RGB", (200, 200), color)
img.show()

描画色の動的設定

例

from PIL import Image, ImageDraw, ImageColor

# 空白画像を作成
img = Image.new("RGB", (400, 200), "white")
draw = ImageDraw.Draw(img)

# さまざまな色を使用して図形を描画
colors = ["red", "#0080FF", "rgb(0, 0, 255)", "hsl(30, 100%, 50%)"]

for i, color_str in enumerate(colors):
    color = ImageColor.getrgb(color_str)
    draw.rectangle([50 + i*80, 50, 100 + i*80, 150], fill=color)

img.show()

注意事項

  1. 色文字列の形式:色文字列の形式が正しいことを確認してください。そうでないと例外が発生しますValueError
  2. カラーモードのサポート:すべてのカラーモードがすべての色変換をサポートしているわけではありません
  3. パフォーマンスに関する考慮事項:色変換メソッドを頻繁に呼び出すとパフォーマンスに影響を与える可能性があるため、よく使う色は事前に変換して保存することをお勧めします
  4. 色名の制限:Pillow がサポートする色名は限られています。完全なリストは次の方法でImageColor.colormap参照してください。

ImageColor モジュールを習得することで、Pillow 画像処理でさまざまな色表現をより柔軟に使用でき、画像処理プログラムにさらなる可能性を加えることができます。

その他の拡張