OpenCV  4.0.0-beta
Open Source Computer Vision
Namespaces | Classes | Functions
GUI for Interactive Visual Debugging of Computer Vision Programs

Namespaces

 cvv::impl
 

Classes

class  cvv::FinalShowCaller
 RAII-class to call finalShow() in it's dtor. More...
 

Functions

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)
 Add a filled in DMatch <dmatch> to debug GUI. More...
 
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=impl::CallMetaData(), const char *description=nullptr, const char *view=nullptr)
 Use the debug-framework to compare two images (from which the second is intended to be the result of a filter applied to the first). More...
 
static void cvv::debugFilter (cv::InputArray original, cv::InputArray result, impl::CallMetaData metaData, const ::std::string &description, const ::std::string &view="")
 
static bool cvv::debugMode ()
 Returns whether debug-mode is active for this TU and thread. More...
 
void cvv::finalShow ()
 Passes the control to the debug-window for a last time. More...
 
static void cvv::setDebugFlag (bool active)
 Enable or disable cvv for current translation unit and thread. More...
 
static void cvv::showImage (cv::InputArray img, impl::CallMetaData metaData=impl::CallMetaData(), const char *description=nullptr, const char *view=nullptr)
 Add a single image to debug GUI (similar to imshow <>). More...
 
static void cvv::showImage (cv::InputArray img, impl::CallMetaData metaData, const ::std::string &description, const ::std::string &view="")
 

Detailed Description

Namespace for all functions is cvv, i.e. cvv::showImage().

Compilation:

See cvv tutorial for a commented example application using cvv.

Function Documentation

§ 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

Add a filled in DMatch <dmatch> to debug GUI.

The matches can are visualized for interactive inspection in different GUI views (one similar to an interactive :draw_matches:drawMatches<>).

Parameters
img1First image used in DMatch <dmatch>.
keypoints1Keypoints of first image.
img2Second image used in DMatch.
keypoints2Keypoints of second image.
matches
dataSee showImage
descriptionSee showImage
viewSee showImage
useTrainDescriptorUse DMatch <dmatch>'s train descriptor index instead of query descriptor index.

§ 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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

§ debugFilter() [1/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

Use the debug-framework to compare two images (from which the second is intended to be the result of a filter applied to the first).

§ debugFilter() [2/2]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

§ debugMode()

static bool cvv::debugMode ( )
inlinestatic

Returns whether debug-mode is active for this TU and thread.

§ finalShow()

void cvv::finalShow ( )
inline

Passes the control to the debug-window for a last time.

This function must be called once after all cvv calls if any. As an alternative create an instance of FinalShowCaller, which calls finalShow() in its destructor (RAII-style).

§ setDebugFlag()

static void cvv::setDebugFlag ( bool  active)
inlinestatic

Enable or disable cvv for current translation unit and thread.

(disabled this way has higher - but still low - overhead compared to using the compile flags).

Parameters
active

§ showImage() [1/2]

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

Add a single image to debug GUI (similar to imshow <>).

Parameters
imgImage to show in debug GUI.
metaDataProperly initialized CallMetaData struct, i.e. information about file, line and function name for GUI. Use CVVISUAL_LOCATION macro.
descriptionHuman readable description to provide context to image.
viewPreselect view that will be used to visualize this image in GUI. Other views can still be selected in GUI later on.

§ showImage() [2/2]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.