JavaとOpenCVで線を描画する方法をわかりやすく解説

Java版OpenCVライブラリのorg.opencv.imgprocパッケージには、Imgprocというクラスが含まれています。画像に直線を描画するには、このクラスが提供するline()メソッドを呼び出します。

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

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

• Matオブジェクト ― 直線を描画する対象となる画像を表します。
• Pointオブジェクト2つ ― 直線の始点と終点の座標を表します。
• Scalarオブジェクト ― 直線の色をBGR形式で指定します。
• 整数値 ― 直線の太さを指定します（デフォルト値：1）。

サンプルコード

以下は、白紙の画像に対して直線を1本描画するJavaプログラムの例です。

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 DrawingLine {
    public static void main(String args[]) {
        // OpenCVネイティブライブラリの読み込み
        System.loadLibrary(Core.NATIVE_LIBRARY_NAME);

        // 元画像をMatオブジェクトとして読み込む
        Mat src = Imgcodecs.imread("D:\\images\\blank.jpg");

        // 直線を描画するための設定
        Point start = new Point(150, 200);   // 始点
        Point end = new Point(450, 200);     // 終点
        Scalar color = new Scalar(64, 64, 64); // 色（BGR）
        int thickness = 10;                  // 太さ

        // line()メソッドで直線を描画
        Imgproc.line(src, start, end, color, thickness);

        // 画像の保存と表示
        Imgcodecs.imwrite("line_output.jpg", src);
        HighGui.imshow("Drawing a line", src);
        HighGui.waitKey();
    }
}

コードのポイント解説

• System.loadLibrary(Core.NATIVE_LIBRARY_NAME) ― OpenCVのネイティブライブラリを読み込みます。この処理は必ず最初に行います。
• Imgcodecs.imread() ― 指定したパスから画像ファイルを読み込み、Matオブジェクトとして返します。
• Imgproc.line() ― 始点・終点・色・太さを指定して、画像上に直線を描画します。
• HighGui.imshow() / waitKey() ― 描画結果をウィンドウに表示し、キー入力を待機します。

実行結果

このプログラムを実行すると、指定した座標間に灰色の太い直線が描かれた画像が生成され、次のようなウィンドウが表示されます。

line()メソッドを使えば、図形への注釈追加や検出結果の可視化など、さまざまな用途に応用できます。色や太さ、座標を変えて、ぜひいろいろ試してみてください。