JavaのOpenCVライブラリで画像にマーカーを描画する方法をわかりやすく解説

OpenCVでは、org.opencv.imgproc.Imgprocクラスに用意されているdrawMarker()メソッドを使うことで、画像上に簡単にマーカー（目印）を描画できます。検出した物体の位置を可視化したい場合などに非常に便利な機能です。

drawMarker()メソッドのパラメータ

このメソッドは、以下のパラメータを受け取ります。

• img − 入力画像を表すMatオブジェクト
• position − マーカーの位置を指定するPointクラスのオブジェクト
• color − マーカーの色を指定するScalarクラスのオブジェクト
• markerType − マーカーの種類を指定する整数定数
• size − マーカーのサイズを指定する整数値
• thickness − マーカーの線の太さを指定する整数値

指定できるマーカーの種類

markerTypeには、Imgprocクラスで定義されている以下の定数を指定できます。

• MARKER_CROSS − 十字型
• MARKER_TILTED_CROSS − 45度傾いた斜め十字型
• MARKER_STAR − 星型
• MARKER_DIAMOND − ひし形（ダイヤモンド）
• MARKER_SQUARE − 四角形
• MARKER_TRIANGLE_UP − 上向き三角形
• MARKER_TRIANGLE_DOWN − 下向き三角形

サンプルコード

import org.opencv.core.Core;
import org.opencv.core.Mat;
import org.opencv.core.Point;
import org.opencv.core.Scalar;
import org.opencv.highgui.HighGui;
import org.opencv.imgcodecs.Imgcodecs;
import org.opencv.imgproc.Imgproc;

public class DrawingMarkers {
   public static void main(String args[]) throws Exception {
      // OpenCVのコアライブラリを読み込む
      System.loadLibrary( Core.NATIVE_LIBRARY_NAME );
      // 画像ファイルを読み込む
      String file ="D:\\Images\\elephant.jpg";
      Mat src = Imgcodecs.imread(file);
      // マーカーの色と位置を設定
      Scalar color = new Scalar(0, 0, 125);
      Point point = new Point(150, 260);
      // マーカーを描画
      Imgproc.drawMarker(src, point, color, Imgproc.MARKER_SQUARE, 150, 8, Imgproc.LINE_8);
      HighGui.imshow("Drawing Markers", src);
      HighGui.waitKey();
   }
}

コードのポイント

このサンプルでは、暗い赤系統の色（BGR値：0, 0, 125）を指定し、座標(150, 260)の位置に、サイズ150・線の太さ8の四角形マーカー（MARKER_SQUARE）を描画しています。なお、OpenCVの色指定はRGBではなくBGRの順で行う点に注意してください。

入力画像

実行結果

上記のプログラムを実行すると、次のようなウィンドウが表示され、指定した位置にマーカーが描画された画像を確認できます。