コンピュータビジョンプログラムをインタラクティブに視覚的にデバッグするためのGUI

詳細説明

すべての関数の名前空間は cvv である。すなわち cvv::showImage() のようになる。

コンパイル:

• 開発時、すなわちcvvのGUIを表示させるには、cvvを使用するコードを g++ -DCVVISUAL_DEBUGMODE* でコンパイルする。
• リリース時、すなわちcvvの呼び出しを何もしないようにするには、上記のフラグを付けずにコードをコンパイルする。

cvvを使用するアプリケーション例の注釈付きサンプルについては、cvvチュートリアルを参照。

名前空間
namespace	cvv::impl

クラス
class	cvv::FinalShowCaller
	デストラクタで finalShow() を呼び出すRAIIクラス。 さらに...

関数
static void	cvv::debugDMatch (cv::InputArray img1, std::vector< cv::KeyPoint > keypoints1, cv::InputArray img2, std::vector< cv::KeyPoint > keypoints2, std::vector< cv::DMatch > matches, const impl::CallMetaData &data, const char *description=nullptr, const char *view=nullptr, bool useTrainDescriptor=true)
	塗りつぶされた DMatch <dmatch> をデバッグ GUI に追加する。
static void	cvv::debugDMatch (cv::InputArray img1, std::vector< cv::KeyPoint > keypoints1, cv::InputArray img2, std::vector< cv::KeyPoint > keypoints2, std::vector< cv::DMatch > matches, const impl::CallMetaData &data, const std::string &description, const std::string &view, bool useTrainDescriptor=true)
static void	cvv::debugFilter (cv::InputArray original, cv::InputArray result, impl::CallMetaData metaData, const ::std::string &description, const ::std::string &view="")
static void	cvv::debugFilter (cv::InputArray original, cv::InputArray result, impl::CallMetaData metaData=impl::CallMetaData(), const char *description=nullptr, const char *view=nullptr)
	デバッグフレームワークを使って2つの画像を比較する（2つ目は1つ目にフィルタを適用した結果であることを意図している）。
static bool	cvv::debugMode ()
	このTUおよびスレッドでデバッグモードが有効かどうかを返す。
void	cvv::finalShow ()
	最後に一度だけ制御をデバッグウィンドウへ渡す。
static void	cvv::setDebugFlag (bool active)
	現在の翻訳単位およびスレッドに対してcvvを有効または無効にする。
static void	cvv::showImage (cv::InputArray img, impl::CallMetaData metaData, const ::std::string &description, const ::std::string &view="")
static void	cvv::showImage (cv::InputArray img, impl::CallMetaData metaData=impl::CallMetaData(), const char *description=nullptr, const char *view=nullptr)
	デバッグGUIに単一の画像を追加する（imshow <> に類似）。

関数詳解

debugDMatch() [1/2]

static void cvv::debugDMatch ( cv::InputArray img1, std::vector< cv::KeyPoint > keypoints1, cv::InputArray img2, std::vector< cv::KeyPoint > keypoints2, std::vector< cv::DMatch > matches, const impl::CallMetaData & data, const char * description = nullptr, const char * view = nullptr, bool useTrainDescriptor = true )

inlinestatic

#include <opencv2/cvv/dmatch.hpp>

値が設定されたDMatch <dmatch> をデバッグGUIに追加する。

マッチングは、さまざまなGUIビュー(対話的な :draw_matches:drawMatches<> に類似したもの)で対話的に検査できるように可視化される。

引数

img1	DMatch <dmatch> で使用される1枚目の画像。
keypoints1	1枚目の画像のキーポイント。
img2	DMatchで使用される2枚目の画像。
keypoints2	2枚目の画像のキーポイント。
matches
data	showImageを参照
description	showImageを参照
view	showImageを参照
useTrainDescriptor	クエリ記述子のインデックスの代わりに、DMatch <dmatch> のトレイン記述子のインデックスを使用する。

この関数の呼び出しグラフ:

debugDMatch() [2/2]

static void cvv::debugDMatch ( cv::InputArray img1, std::vector< cv::KeyPoint > keypoints1, cv::InputArray img2, std::vector< cv::KeyPoint > keypoints2, std::vector< cv::DMatch > matches, const impl::CallMetaData & data, const std::string & description, const std::string & view, bool useTrainDescriptor = true )

inlinestatic

#include <opencv2/cvv/dmatch.hpp>

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

この関数の呼び出しグラフ:

debugFilter() [1/2]

static void cvv::debugFilter ( cv::InputArray original, cv::InputArray result, impl::CallMetaData metaData, const ::std::string & description, const ::std::string & view = "" )

inlinestatic

#include <opencv2/cvv/filter.hpp>

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

この関数の呼び出しグラフ:

debugFilter() [2/2]

static void cvv::debugFilter ( cv::InputArray original, cv::InputArray result, impl::CallMetaData metaData = impl::CallMetaData(), const char * description = nullptr, const char * view = nullptr )

inlinestatic

#include <opencv2/cvv/filter.hpp>

デバッグフレームワークを使用して、2枚の画像を比較する(2枚目は1枚目にフィルタを適用した結果であることを想定している)。

この関数の呼び出しグラフ:

debugMode()

static bool cvv::debugMode ( )

inlinestatic

#include <opencv2/cvv/debug_mode.hpp>

このTUおよびスレッドでデバッグモードが有効かどうかを返す。

この関数の呼び出しグラフ:

finalShow()

void cvv::finalShow ( )

inline

#include <opencv2/cvv/final_show.hpp>

最後に一度だけ、制御をデバッグウィンドウに渡す。

この関数は、cvvの呼び出しがある場合、すべてのcvvの呼び出しの後に一度必ず呼び出さなければならない。代わりに、デストラクタで finalShow() を呼び出す FinalShowCaller のインスタンスを生成してもよい(RAIIスタイル)。

この関数の呼び出しグラフ:

setDebugFlag()

static void cvv::setDebugFlag ( bool active )

inlinestatic

#include <opencv2/cvv/debug_mode.hpp>

現在の翻訳単位とスレッドに対してcvvを有効または無効にする。

(この方法で無効にした場合、コンパイルフラグを使用する場合に比べてオーバーヘッドは高くなるが、それでも低い)。

引数

active

この関数の呼び出しグラフ:

showImage() [1/2]

static void cvv::showImage ( cv::InputArray img, impl::CallMetaData metaData, const ::std::string & description, const ::std::string & view = "" )

inlinestatic

#include <opencv2/cvv/show_image.hpp>

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

この関数の呼び出しグラフ:

showImage() [2/2]

static void cvv::showImage ( cv::InputArray img, impl::CallMetaData metaData = impl::CallMetaData(), const char * description = nullptr, const char * view = nullptr )

inlinestatic

#include <opencv2/cvv/show_image.hpp>

デバッグGUIに1枚の画像を追加する(imshow <> に類似)。

引数

img	デバッグGUIに表示する画像。
metaData	適切に初期化されたCallMetaData構造体。すなわちGUI用のファイル名・行番号・関数名の情報。CVVISUAL_LOCATIONマクロを使用すること。
description	画像に文脈を与えるための、人間が読める説明。
view	GUIでこの画像を可視化する際に使用するビューをあらかじめ選択する。あとからGUIで他のビューを選択することもできる。

この関数の呼び出しグラフ: