OpenCVで画像に楕円を描画する方法｜cv2.ellipse()の使い方を解説

この記事では、Pythonの画像処理ライブラリ「OpenCV」を使って、画像の上に楕円を描画する方法を解説します。楕円の描画には、OpenCVが提供する cv2.ellipse() 関数を使用します。

元画像

アルゴリズム（処理の手順）

楕円を描画するまでの流れは、以下の手順になります。

ステップ1: cv2 をインポートする。
ステップ2: imread() で画像を読み込む。
ステップ3: 楕円の中心座標を設定する。
ステップ4: 楕円の長軸・短軸の長さ（axesLength）を設定する。
ステップ5: 楕円の回転角度（angle）を設定する。
ステップ6: 描画を開始する角度と終了する角度を設定する。
ステップ7: 線の色（BGR形式）を設定する。
ステップ8: 線の太さ（thickness）を設定する。
ステップ9: 上記のパラメータを指定して cv2.ellipse() を呼び出し、元画像に楕円を描画する。
ステップ10: 最終結果を画面に表示する。

サンプルコード

実際に動作するPythonコードは以下の通りです。各パラメータの意味はコメントとして記載しています。

import cv2

# 画像を読み込む
image = cv2.imread('testimage.jpg')

# 楕円の中心座標 (x, y)
center_coordinates = (120, 100)

# 長軸と短軸の長さ (長軸, 短軸)
axesLength = (100, 50)

# 楕円の回転角度（度数法）
angle = 0

# 描画開始角度と終了角度
startAngle = 0
endAngle = 360

# 線の色（BGR形式：ここでは赤）
color = (0, 0, 255)

# 線の太さ
thickness = 5

# 楕円を描画
image = cv2.ellipse(image, center_coordinates, axesLength, angle, startAngle, endAngle, color, thickness)

# 結果を表示
cv2.imshow('Ellipse', image)
cv2.waitKey(0)
cv2.destroyAllWindows()

主なパラメータの解説

• center_coordinates: 楕円の中心となる座標をタプル (x, y) で指定します。
• axesLength: 長軸と短軸の半分の長さをタプルで指定します。
• angle: 楕円全体を回転させる角度です。0 の場合は回転なしになります。
• startAngle / endAngle: 0〜360 を指定すると完全な楕円になり、範囲を狭めると楕円弧（部分的な楕円）が描けます。
• color: BGR形式で指定します。(0, 0, 255) は赤色を意味します。
• thickness: 輪郭線の太さです。-1 を指定すると塗りつぶしになります。

実行結果

上記のコードを実行すると、元画像の上に赤い楕円が描画されます。

startAngle や endAngle、angle の値を変更することで、傾いた楕円や部分的な円弧など、さまざまな形状を自由に描画できます。ぜひいろいろな値を試してみてください。