Visual Servoing Platform  version 3.6.1 under development (2024-11-15)
tutorial-mb-tracker-full.cpp
1 #include <visp3/core/vpConfig.h>
3 #include <visp3/core/vpIoTools.h>
4 #include <visp3/gui/vpDisplayGDI.h>
5 #include <visp3/gui/vpDisplayOpenCV.h>
6 #include <visp3/gui/vpDisplayX.h>
7 #include <visp3/io/vpImageIo.h>
9 #include <visp3/mbt/vpMbEdgeKltTracker.h>
10 #include <visp3/mbt/vpMbEdgeTracker.h>
12 #include <visp3/io/vpVideoReader.h>
13 
14 int main(int argc, char **argv)
15 {
16 #if defined(VISP_HAVE_OPENCV)
17 #ifdef ENABLE_VISP_NAMESPACE
18  using namespace VISP_NAMESPACE_NAME;
19 #endif
20 
21  try {
22  std::string opt_videoname = "teabox.mp4";
23  std::string opt_modelname = "teabox.cao";
24  int opt_tracker = 0;
25 
26  for (int i = 0; i < argc; i++) {
27  if (std::string(argv[i]) == "--video")
28  opt_videoname = std::string(argv[i + 1]);
29  else if (std::string(argv[i]) == "--model")
30  opt_modelname = std::string(argv[i + 1]);
31  else if (std::string(argv[i]) == "--tracker")
32  opt_tracker = atoi(argv[i + 1]);
33  else if (std::string(argv[i]) == "--help" || std::string(argv[i]) == "-h") {
34  std::cout << "\nUsage: " << argv[0]
35  << " [--video <video name>] [--model <model name>] "
36  "[--tracker <0=egde|1=keypoint|2=hybrid>] [--help] [-h]\n"
37  << std::endl;
38  return EXIT_SUCCESS;
39  }
40  }
41  std::string parentname = vpIoTools::getParent(opt_modelname);
42  std::string objectname = vpIoTools::getNameWE(opt_modelname);
43 
44  if (!parentname.empty())
45  objectname = parentname + "/" + objectname;
46 
47  std::cout << "Video name: " << opt_videoname << std::endl;
48  std::cout << "Tracker requested config files: " << objectname << ".[init,"
49  << "xml,"
50  << "cao or wrl]" << std::endl;
51  std::cout << "Tracker optional config files: " << objectname << ".[ppm]" << std::endl;
52 
60 
61  vpVideoReader g;
62  g.setFileName(opt_videoname);
63  g.open(I);
64 
65  vpDisplay *display = nullptr;
66 #if defined(VISP_HAVE_X11)
67  display = new vpDisplayX;
68 #elif defined(VISP_HAVE_GDI)
69  display = new vpDisplayGDI;
70 #elif defined(HAVE_OPENCV_HIGHGUI)
71  display = new vpDisplayOpenCV;
72 #endif
73  display->init(I, 100, 100, "Model-based tracker");
74 
76  vpMbTracker *tracker;
77  if (opt_tracker == 0)
78  tracker = new vpMbEdgeTracker;
79 #if defined(VISP_HAVE_OPENCV) && defined(HAVE_OPENCV_IMGPROC) && defined(HAVE_OPENCV_VIDEO)
80  else if (opt_tracker == 1)
81  tracker = new vpMbKltTracker;
82  else
83  tracker = new vpMbEdgeKltTracker;
84 #else
85  else {
86  std::cout << "klt and hybrid model-based tracker are not available "
87  "since visp_klt module is missing"
88  << std::endl;
89  return EXIT_FAILURE;
90  }
91 #endif
93 
94  bool usexml = false;
96 #if defined(VISP_HAVE_PUGIXML)
97  if (vpIoTools::checkFilename(objectname + ".xml")) {
98  tracker->loadConfigFile(objectname + ".xml");
99  usexml = true;
100  }
101 #endif
103 
104  if (!usexml) {
106  if (opt_tracker == 0 || opt_tracker == 2) {
108  vpMe me;
109  me.setMaskSize(5);
110  me.setMaskNumber(180);
111  me.setRange(8);
113  me.setThreshold(20);
114  me.setMu1(0.5);
115  me.setMu2(0.5);
116  me.setSampleStep(4);
117  dynamic_cast<vpMbEdgeTracker *>(tracker)->setMovingEdge(me);
119  }
120 
121 #if defined(VISP_HAVE_OPENCV) && defined(HAVE_OPENCV_IMGPROC) && defined(HAVE_OPENCV_VIDEO)
122  if (opt_tracker == 1 || opt_tracker == 2) {
124  vpKltOpencv klt_settings;
125  klt_settings.setMaxFeatures(300);
126  klt_settings.setWindowSize(5);
127  klt_settings.setQuality(0.015);
128  klt_settings.setMinDistance(8);
129  klt_settings.setHarrisFreeParameter(0.01);
130  klt_settings.setBlockSize(3);
131  klt_settings.setPyramidLevels(3);
132  dynamic_cast<vpMbKltTracker *>(tracker)->setKltOpencv(klt_settings);
133  dynamic_cast<vpMbKltTracker *>(tracker)->setKltMaskBorder(5);
135  }
136 #endif
137 
139  cam.initPersProjWithoutDistortion(839.21470, 839.44555, 325.66776, 243.69727);
140  tracker->setCameraParameters(cam);
142 
144  tracker->setAngleAppear(vpMath::rad(70));
145  tracker->setAngleDisappear(vpMath::rad(80));
148  tracker->setNearClippingDistance(0.1);
149  tracker->setFarClippingDistance(100.0);
152  tracker->setClipping(tracker->getClipping() | vpMbtPolygon::FOV_CLIPPING);
155  }
158  tracker->setOgreVisibilityTest(false);
159  tracker->setOgreShowConfigDialog(false);
162  tracker->setScanLineVisibilityTest(true);
165 
167  if (vpIoTools::checkFilename(objectname + ".cao"))
168  tracker->loadModel(objectname + ".cao");
171  else if (vpIoTools::checkFilename(objectname + ".wrl"))
172  tracker->loadModel(objectname + ".wrl");
175  tracker->setDisplayFeatures(true);
178  tracker->initClick(I, objectname + ".init", true);
180 
181  while (!g.end()) {
182  g.acquire(I);
185  tracker->track(I);
188  tracker->getPose(cMo);
191  tracker->getCameraParameters(cam);
192  tracker->display(I, cMo, cam, vpColor::red, 2);
194  vpDisplay::displayFrame(I, cMo, cam, 0.025, vpColor::none, 3);
195  vpDisplay::displayText(I, 10, 10, "A click to exit...", vpColor::red);
196  vpDisplay::flush(I);
197 
198  if (vpDisplay::getClick(I, false))
199  break;
200  }
203  delete display;
204  delete tracker;
206  }
207  catch (const vpException &e) {
208  std::cout << "Catch a ViSP exception: " << e << std::endl;
209  }
210 #ifdef VISP_HAVE_OGRE
211  catch (Ogre::Exception &e) {
212  std::cout << "Catch an Ogre exception: " << e.getDescription() << std::endl;
213  }
214 #endif
215 #else
216  (void)argc;
217  (void)argv;
218  std::cout << "Install OpenCV and rebuild ViSP to use this example." << std::endl;
219 #endif
220 }
Generic class defining intrinsic camera parameters.
void initPersProjWithoutDistortion(double px, double py, double u0, double v0)
static const vpColor red
Definition: vpColor.h:217
static const vpColor none
Definition: vpColor.h:229
Display for windows using GDI (available on any windows 32 platform).
Definition: vpDisplayGDI.h:130
The vpDisplayOpenCV allows to display image using the OpenCV library. Thus to enable this class OpenC...
Class that defines generic functionalities for display.
Definition: vpDisplay.h:178
static bool getClick(const vpImage< unsigned char > &I, bool blocking=true)
static void display(const vpImage< unsigned char > &I)
static void displayFrame(const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMo, const vpCameraParameters &cam, double size, const vpColor &color=vpColor::none, unsigned int thickness=1, const vpImagePoint &offset=vpImagePoint(0, 0), const std::string &frameName="", const vpColor &textColor=vpColor::black, const vpImagePoint &textOffset=vpImagePoint(15, 15))
static void flush(const vpImage< unsigned char > &I)
static void displayText(const vpImage< unsigned char > &I, const vpImagePoint &ip, const std::string &s, const vpColor &color)
error that can be emitted by ViSP classes.
Definition: vpException.h:60
Implementation of an homogeneous matrix and operations on such kind of matrices.
static bool checkFilename(const std::string &filename)
Definition: vpIoTools.cpp:786
static std::string getNameWE(const std::string &pathname)
Definition: vpIoTools.cpp:1227
static std::string getParent(const std::string &pathname)
Definition: vpIoTools.cpp:1314
Wrapper for the KLT (Kanade-Lucas-Tomasi) feature tracker implemented in OpenCV. Thus to enable this ...
Definition: vpKltOpencv.h:74
void setBlockSize(int blockSize)
Definition: vpKltOpencv.h:267
void setQuality(double qualityLevel)
Definition: vpKltOpencv.h:356
void setHarrisFreeParameter(double harris_k)
Definition: vpKltOpencv.h:275
void setMaxFeatures(int maxCount)
Definition: vpKltOpencv.h:315
void setMinDistance(double minDistance)
Definition: vpKltOpencv.h:324
void setWindowSize(int winSize)
Definition: vpKltOpencv.h:377
void setPyramidLevels(int pyrMaxLevel)
Definition: vpKltOpencv.h:343
static double rad(double deg)
Definition: vpMath.h:129
Make the complete tracking of an object by using its CAD model.
Main methods for a model-based tracker.
Definition: vpMbTracker.h:107
virtual void track(const vpImage< unsigned char > &I)=0
virtual void setOgreShowConfigDialog(bool showConfigDialog)
Definition: vpMbTracker.h:652
virtual void getCameraParameters(vpCameraParameters &cam) const
Definition: vpMbTracker.h:250
virtual void setDisplayFeatures(bool displayF)
Definition: vpMbTracker.h:520
virtual void getPose(vpHomogeneousMatrix &cMo) const
Definition: vpMbTracker.h:416
virtual void setCameraParameters(const vpCameraParameters &cam)
Definition: vpMbTracker.h:490
virtual void setAngleDisappear(const double &a)
Definition: vpMbTracker.h:483
virtual void setScanLineVisibilityTest(const bool &v)
Definition: vpMbTracker.h:610
virtual void setOgreVisibilityTest(const bool &v)
virtual void setNearClippingDistance(const double &dist)
virtual void setFarClippingDistance(const double &dist)
virtual void setClipping(const unsigned int &flags)
virtual void display(const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMo, const vpCameraParameters &cam, const vpColor &col, unsigned int thickness=1, bool displayFullModel=false)=0
virtual void loadModel(const std::string &modelFile, bool verbose=false, const vpHomogeneousMatrix &T=vpHomogeneousMatrix())
virtual void setAngleAppear(const double &a)
Definition: vpMbTracker.h:472
virtual unsigned int getClipping() const
Definition: vpMbTracker.h:258
virtual void loadConfigFile(const std::string &configFile, bool verbose=true)
Definition: vpMe.h:134
void setMu1(const double &mu_1)
Definition: vpMe.h:385
void setRange(const unsigned int &range)
Definition: vpMe.h:415
void setLikelihoodThresholdType(const vpLikelihoodThresholdType likelihood_threshold_type)
Definition: vpMe.h:505
void setMaskNumber(const unsigned int &mask_number)
Definition: vpMe.cpp:552
void setThreshold(const double &threshold)
Definition: vpMe.h:466
void setSampleStep(const double &sample_step)
Definition: vpMe.h:422
void setMaskSize(const unsigned int &mask_size)
Definition: vpMe.cpp:560
void setMu2(const double &mu_2)
Definition: vpMe.h:392
@ NORMALIZED_THRESHOLD
Definition: vpMe.h:145
Class that enables to manipulate easily a video file or a sequence of images. As it inherits from the...
void acquire(vpImage< vpRGBa > &I)
void open(vpImage< vpRGBa > &I)
void setFileName(const std::string &filename)