cv::inpaint の使い方【OpenCV/C++】〜画像修復で不要物を除去する〜

OpenCV for C++
📌 準備: OpenCV の環境構築がまだの方はこちら → C++ 環境構築ガイド / C#(OpenCvSharp)セットアップ

cv::inpaint の使い方【OpenCV/C++】〜画像修復で不要物を除去する〜

cv::inpaint は、マスクで指定した領域を周囲のピクセルから補完して自然に埋める関数です。スタンプや文字の除去、スクラッチ修復など、実務でよく求められる「不要物を消す」処理を数行で実装できます。

最小コードのイメージ:

cv::inpaint(src, mask, dst, 3, cv::INPAINT_TELEA);

動作環境

  • OpenCV 4.x
  • C++17
  • ビルド例: g++ -std=c++17 main.cpp $(pkg-config --cflags --libs opencv4)

環境構築がまだの方は環境構築ガイドを先にどうぞ。


基本の使い方

以下のサンプルは、画像内の白い矩形領域(不要物に見立てたもの)をマスクとして cv::inpaint で修復します。実務では「除去したい領域だけ白い二値マスク画像」を用意するのが基本パターンです。

#include <opencv2/opencv.hpp>
#include <opencv2/photo.hpp>
#include <iostream>

int main() {
    // 元画像の読み込み
    cv::Mat src = cv::imread("input.jpg");
    if (src.empty()) {
        std::cerr << "画像を読み込めませんでした" << std::endl;
        return -1;
    }

    // 修復対象領域をマスクとして作成(白=修復対象、黒=保持)
    cv::Mat mask = cv::Mat::zeros(src.size(), CV_8UC1);
    // 例: 画像中央付近の矩形を消したいとする
    cv::rectangle(mask, cv::Rect(100, 100, 200, 50), cv::Scalar(255), cv::FILLED);

    // inpaint で修復
    cv::Mat dst;
    cv::inpaint(src, mask, dst, 5, cv::INPAINT_TELEA);

    // 結果を保存
    cv::imwrite("output.jpg", dst);
    std::cout << "修復完了: output.jpg に保存しました" << std::endl;

    // ウィンドウ表示(デスクトップ環境がある場合)
    cv::imshow("Original", src);
    cv::imshow("Mask",     mask);
    cv::imshow("Inpainted", dst);
    cv::waitKey(0);

    return 0;
}

実行結果:

修復完了: output.jpg に保存しました

output.jpg を確認すると、マスクで白く塗った矩形領域が周囲の色・テクスチャを参考にして自然に補完されています。矩形の境界が目立ちにくく埋まっているのが確認できます。

行ごとの解説

  • cv::Mat::zeros(src.size(), CV_8UC1) — マスクは 1チャンネル8ビット で作成する。これを守らないと例外(cv::Exception)になります。
  • cv::rectangle(..., cv::FILLED) — 修復したい領域を塗りつぶして白にします。実務ではこの部分をユーザ操作や別の検出処理で生成します。
  • inpaintRadius = 5 — 修復時に参照する周辺ピクセルの半径。大きすぎるとぼやけます。
  • cv::INPAINT_TELEA — アルゴリズム選択(後述)。

引数と戻り値

void cv::inpaint(
    InputArray  src,           // 入力画像(8UC1 / 16UC1 / 32FC1 / 8UC3)
    InputArray  inpaintMask,   // マスク(8UC1。0以外=修復対象、0=保持)
    OutputArray dst,           // 出力画像(src と同サイズ・同型)
    double      inpaintRadius, // 参照半径(ピクセル単位)
    int         flags          // アルゴリズム選択
);
引数 型 説明
src InputArray 入力画像。CV_8UC1 / CV_16UC1 / CV_32FC1 / CV_8UC3
inpaintMask InputArray 修復対象領域のマスク。CV_8UC1・0 以外の画素が修復対象(通常は 255 で塗る)
dst OutputArray 修復後の画像。src と同サイズ・同型
inpaintRadius double 修復時に参照する周辺ピクセルの半径
flags int cv::INPAINT_NS または cv::INPAINT_TELEA

flags の選択肢:

定数 アルゴリズム 特徴
cv::INPAINT_NS Navier-Stokes ベース エッジを保ちやすい。構造が明確な領域向き
cv::INPAINT_TELEA Fast Marching Method (Telea) 速度が速く、テクスチャ補完が自然。多くの用途でこちらを先に試す

戻り値はなし(void)。結果は dst に格納されます。


実践例

例1: 画像上の文字スタンプを除去する

ロゴや日付テキストが写り込んだ画像を修復するケースです。テキスト領域を別途二値化して取得し、そのままマスクに使います。

#include <opencv2/opencv.hpp>
#include <opencv2/photo.hpp>
#include <iostream>

int main() {
    cv::Mat src = cv::imread("stamped.jpg");
    if (src.empty()) {
        std::cerr << "画像を読み込めませんでした" << std::endl;
        return -1;
    }

    // グレースケールに変換して白いスタンプ文字を検出
    cv::Mat gray;
    cv::cvtColor(src, gray, cv::COLOR_BGR2GRAY);

    // 閾値処理で白い領域(スタンプ)を抽出
    cv::Mat mask;
    cv::threshold(gray, mask, 220, 255, cv::THRESH_BINARY);

    // ノイズを減らすため膨張処理(マスクを少し広げると境界が自然になる)
    cv::Mat kernel = cv::getStructuringElement(cv::MORPH_RECT, cv::Size(3, 3));
    cv::dilate(mask, mask, kernel);

    // inpaint で修復
    cv::Mat dst;
    cv::inpaint(src, mask, dst, 7, cv::INPAINT_TELEA);

    cv::imwrite("removed.jpg", dst);
    std::cout << "スタンプ除去完了: removed.jpg" << std::endl;

    return 0;
}

閾値 220 は画像によって調整が必要です。スタンプが半透明の場合は cv::inRange や HSV 変換でマスク生成を工夫してください。


例2: 手動で描いたマスクを使ったインタラクティブ修復

実務ではユーザがマウスで消したい部分を塗ると、そのストロークをマスクにして inpaint する UI がよく使われます。以下はその骨格です。

#include <opencv2/opencv.hpp>
#include <opencv2/photo.hpp>
#include <iostream>

// グローバル変数(マウスコールバック用)
cv::Mat g_src, g_mask, g_display;
bool g_drawing = false;

void onMouse(int event, int x, int y, int, void*) {
    if (event == cv::EVENT_LBUTTONDOWN) g_drawing = true;
    if (event == cv::EVENT_LBUTTONUP)   g_drawing = false;
    if (g_drawing && event == cv::EVENT_MOUSEMOVE) {
        // マスクと表示用画像の両方に描画
        cv::circle(g_mask,    cv::Point(x, y), 8, cv::Scalar(255), cv::FILLED);
        cv::circle(g_display, cv::Point(x, y), 8, cv::Scalar(0, 0, 255), cv::FILLED);
        cv::imshow("Draw Mask (Enter=inpaint / ESC=cancel)", g_display);
    }
}

int main() {
    g_src = cv::imread("photo.jpg");
    if (g_src.empty()) {
        std::cerr << "画像を読み込めませんでした" << std::endl;
        return -1;
    }

    g_mask    = cv::Mat::zeros(g_src.size(), CV_8UC1);
    g_display = g_src.clone();

    cv::namedWindow("Draw Mask (Enter=inpaint / ESC=cancel)");
    cv::setMouseCallback("Draw Mask (Enter=inpaint / ESC=cancel)", onMouse);
    cv::imshow("Draw Mask (Enter=inpaint / ESC=cancel)", g_display);

    int key = cv::waitKey(0);
    if (key == 13) { // Enter
        cv::Mat result;
        cv::inpaint(g_src, g_mask, result, 5, cv::INPAINT_TELEA);
        cv::imshow("Result", result);
        cv::imwrite("interactive_result.jpg", result);
        cv::waitKey(0);
    }
    return 0;
}

実行するとウィンドウが開き、左ドラッグで赤く塗った領域がマスクになります。Enter キーで cv::inpaint が走り、修復結果が表示されます。


つまずきポイント

⚠️ マスクのチャンネル数・型の不一致

inpaintMask は CV_8UC1(1チャンネル) でなければなりません。カラー画像をそのままマスクに渡すと (-210:Unsupported format or combination of formats) The mask must be 8-bit 1-channel image in function 'icvInpaint' の例外が発生します。cvtColor でグレースケールに変換してから渡してください。

// NG: カラー画像をマスクに渡している
cv::inpaint(src, src, dst, 5, cv::INPAINT_TELEA); // 例外

// OK
cv::Mat mask;
cv::cvtColor(some_color_mask, mask, cv::COLOR_BGR2GRAY);
cv::inpaint(src, mask, dst, 5, cv::INPAINT_TELEA);

⚠️ opencv_photo のリンク忘れ(Windows/Visual Studio)

cv::inpaint は opencv2/photo.hpp にあり、ライブラリとしては opencv_photo モジュールに属します。Visual Studio で opencv_world を使わず個別 lib を指定している場合、opencv_photo4xx.lib を追加リンクしないと LNK2019 未解決の外部シンボル エラーになります。CMakeLists.txt の場合は target_link_libraries に opencv_photo を忘れずに追加してください。

⚠️ 修復半径が大きすぎるとぼやける・処理が重くなる

inpaintRadius を大きくすると参照範囲が広がり、広い領域の欠損を埋めやすくなりますが、テクスチャ周波数が高い領域(布・木目など)はぼやけます。また処理時間はマスク面積と半径に比例して増加します。まず 3〜7 程度から始め、結果を見ながら調整するのが実務的です。


関連する関数

  • cv::threshold / cv::inRange — マスク生成に使用。二値化でスタンプや特定色域をマスク化できます。
  • cv::dilate / cv::erode — マスクの微調整。境界を少し広げると inpaint の補完が自然になります。
  • cv::seamlessClone(opencv2/photo.hpp)— 別の修復系関数。領域を別画像から自然合成する用途向き。

動体検出・追跡系の記事(BackgroundSubtractorMOG2など)と組み合わせると、「背景差分で検出した前景物体をマスク化→inpaint で背景を復元する」という応用が作れます。


まとめ

  • cv::inpaint は CV_8UC1 マスク + 修復半径 + アルゴリズム選択 の3点を押さえれば即使える。
  • アルゴリズムは INPAINT_TELEA を先に試し、エッジ保持が重要な場合に INPAINT_NS を検討する。
  • マスクの型(CV_8UC1)とリンク設定(opencv_photo)が C++ 実装でよくはまるポイント。

🛠 画像処理のプロが開発するSDK/API

本ブログを運営するスワローインキュベートは、OpenCV ベースのなりすまし判定SDK/API(C++製・OpenCV 4.10)を開発しています。顔認証システムへの組み込み実績多数。

→ 顔認証のなりすまし対策 設計チェックリスト(当ブログ)
→ なりすまし判定SDK/APIの詳細を見る
→ API仕様書・サンプルコード

タイトルとURLをコピーしました