Pillow ImageDraw モジュール
ImageDraw は、Python の画像処理ライブラリ Pillow(PIL のフォーク)のモジュールで、画像上にさまざまな図形やテキストを描画するために使用します。
ImageDraw は、線、矩形、円、多角形、テキストなど、豊富な描画機能を提供します。画像への注釈付け、グラフの生成、簡単な図形デザインに適しています。
ImageDrawモジュールの主な特徴は次のとおりです。
- 既存の画像上に描画できる
- 新しい空白のキャンバスを作成できる
- 多様な描画プリミティブ(点、線、矩形、楕円など)を提供する
- テキスト描画とフォント設定をサポートする
- 描画色とスタイルをカスタマイズできる
ImageDraw の基本的な使い方
Draw オブジェクトの作成
ImageDraw を使用する前に、まずImageDraw.Drawオブジェクトを作成し、Imageオブジェクトを描画のベースとして渡します。
例
from PIL import Image, ImageDraw
# 空白画像を作成(白い背景)
image = Image.new("RGB", (400, 300), "white")
# Draw オブジェクトを作成
draw = ImageDraw.Draw(image)
# 空白画像を作成(白い背景)
image = Image.new("RGB", (400, 300), "white")
# Draw オブジェクトを作成
draw = ImageDraw.Draw(image)
基本図形の描画
ImageDraw はさまざまな描画メソッドをサポートしています。例:
- 線の描画:
line() - 矩形の描画:
rectangle() - 円/楕円の描画:
ellipse() - 多角形の描画:
polygon() - テキストの描画:
text()
ImageDraw でよく使うメソッド
| メソッド | 説明 | 例 |
|---|---|---|
line(xy, fill=None, width=1) |
線を描画します。xyは座標タプル((x1, y1, x2, y2))です。 |
draw.line([(10, 10), (100, 50)], fill="red", width=2) |
rectangle(xy, fill=None, outline=None, width=1) |
矩形を描画します。xyは左上隅と右下隅の座標です。 |
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black") |
ellipse(xy, fill=None, outline=None, width=1) |
楕円または円を描画します。 | draw.ellipse([(100, 100), (200, 200)], fill="green") |
polygon(xy, fill=None, outline=None) |
多角形を描画します。 | draw.polygon([(50, 50), (100, 20), (150, 50)], fill="yellow") |
text(xy, text, fill=None, font=None) |
画像上にテキストを描画します。 | draw.text((50, 50), "Hello Pillow!", fill="black") |
arc(xy, start, end, fill=None, width=1) |
円弧を描画します。 | draw.arc([(50, 50), (150, 150)], 0, 90, fill="red") |
chord(xy, start, end, fill=None, outline=None) |
弦(円弧 + 接続線)を描画します。 | draw.chord([(50, 50), (150, 150)], 0, 180, fill="blue") |
pieslice(xy, start, end, fill=None, outline=None) |
扇形を描画します。 | draw.pieslice([(50, 50), (150, 150)], 0, 90, fill="green") |
textbbox() |
指定されたテキストを画像上に描画する際に占めるバウンディングボックスを計算するために使用します。 | draw.textbbox((50, 50), "Hello Pillow!", font=font) |
総合サンプル
以下は、ImageDraw を使用してさまざまな図形やテキストを描画する方法を示す完全な例です。
例
from PIL import Image, ImageDraw, ImageFont
# 空白画像を作成
image = Image.new("RGB", (500, 400), "white")
draw = ImageDraw.Draw(image)
# 線を描画
draw.line([(10, 10), (490, 10)], fill="red", width=3)
# 矩形を描画
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")
# 円を描画
draw.ellipse([(200, 50), (300, 150)], fill="green")
# 多角形を描画
draw.polygon([(350, 50), (400, 100), (450, 50), (400, 150)], fill="yellow")
# テキストを描画
font = ImageFont.load_default()
draw.text((50, 200), "Hello Pillow!", fill="black", font=font)
# 画像を保存
image.save("draw_example.png")
# 空白画像を作成
image = Image.new("RGB", (500, 400), "white")
draw = ImageDraw.Draw(image)
# 線を描画
draw.line([(10, 10), (490, 10)], fill="red", width=3)
# 矩形を描画
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")
# 円を描画
draw.ellipse([(200, 50), (300, 150)], fill="green")
# 多角形を描画
draw.polygon([(350, 50), (400, 100), (450, 50), (400, 150)], fill="yellow")
# テキストを描画
font = ImageFont.load_default()
draw.text((50, 200), "Hello Pillow!", fill="black", font=font)
# 画像を保存
image.save("draw_example.png")
実行すると、さまざまな図形を含む画像ファイルが生成されます。draw_example.png。
まとめ
ImageDraw は Pillow の中でも非常に実用的な描画モジュールであり、次のような用途に適しています:
- 画像の注釈付け(文字や矢印の追加など)
- 簡単なグラフや模式図の生成
- カスタム図形の描画
をマスターすることで、line()、rectangle()、ellipse()、text()などのメソッドを使えば、さまざまな描画ニーズを簡単に実現できます。
より高度な描画機能が必要な場合は、ImageFont(フォント設定)やImageFilter(フィルター効果)と組み合わせて、機能をさらに拡張できます。
本チュートリアルが、Pillow の ImageDraw モジュールをすぐに使いこなす一助となれば幸いです。
その他の拡張