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)
# 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 (赤色のグレースケールでの値)
# 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
# 色マッピングテーブルを取得
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()
# 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()
# 空白画像を作成
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()
注意事項
- 色文字列の形式:色文字列の形式が正しいことを確認してください。そうでないと例外が発生します
ValueError - カラーモードのサポート:すべてのカラーモードがすべての色変換をサポートしているわけではありません
- パフォーマンスに関する考慮事項:色変換メソッドを頻繁に呼び出すとパフォーマンスに影響を与える可能性があるため、よく使う色は事前に変換して保存することをお勧めします
- 色名の制限:Pillow がサポートする色名は限られています。完全なリストは次の方法で
ImageColor.colormap参照してください。
ImageColor モジュールを習得することで、Pillow 画像処理でさまざまな色表現をより柔軟に使用でき、画像処理プログラムにさらなる可能性を加えることができます。
その他の拡張