Visual Servoing Platform  version 3.6.1 under development (2024-11-15)
tutorial-mb-generic-tracker-stereo-mono.cpp
1 #include <cstdlib>
3 #include <visp3/core/vpConfig.h>
4 #include <visp3/core/vpIoTools.h>
5 #include <visp3/gui/vpDisplayGDI.h>
6 #include <visp3/gui/vpDisplayOpenCV.h>
7 #include <visp3/gui/vpDisplayX.h>
8 #include <visp3/io/vpImageIo.h>
10 #include <visp3/mbt/vpMbGenericTracker.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  int opt_tracker = vpMbGenericTracker::EDGE_TRACKER;
24 
25  for (int i = 0; i < argc; i++) {
26  if (std::string(argv[i]) == "--name" && i + 1 < argc)
27  opt_videoname = std::string(argv[i + 1]);
28  else if (std::string(argv[i]) == "--tracker" && i + 1 < argc)
29  opt_tracker = atoi(argv[i + 1]);
30  else if (std::string(argv[i]) == "--help" || std::string(argv[i]) == "-h") {
31  std::cout << "\nUsage: " << argv[0] << " [--name <video name>] [--tracker <1=egde|2=keypoint|3=hybrid>]"
32  << " [--help] [-h]\n"
33  << std::endl;
34  return EXIT_SUCCESS;
35  }
36  }
37 
38  if (opt_tracker < 1 || opt_tracker > 3) {
39  std::cerr << "Wrong tracker type. Correct values are: "
40  "1=egde|2=keypoint|3=hybrid."
41  << std::endl;
42  return EXIT_SUCCESS;
43  }
44 
45  std::string parentname = vpIoTools::getParent(opt_videoname);
46  std::string objectname = vpIoTools::getNameWE(opt_videoname);
47 
48  if (!parentname.empty()) {
49  objectname = parentname + "/" + objectname;
50  }
51 
52  std::cout << "Video name: " << opt_videoname << std::endl;
53  std::cout << "Tracker requested config files: " << objectname << ".[init, cao]" << std::endl;
54  std::cout << "Tracker optional config files: " << objectname << ".[ppm]" << std::endl;
55 
59 
60  vpVideoReader g;
61  g.setFileName(opt_videoname);
62  g.open(I);
63 
64 #if defined(VISP_HAVE_X11)
65  vpDisplayX display;
66 #elif defined(VISP_HAVE_GDI)
67  vpDisplayGDI display;
68 #elif defined(HAVE_OPENCV_HIGHGUI)
69  vpDisplayOpenCV display;
70 #endif
71  display.init(I, 100, 100, "Model-based tracker");
72 
74  vpMbGenericTracker tracker(1, opt_tracker);
76 
77 #if !defined(VISP_HAVE_MODULE_KLT)
78  if (opt_tracker >= 2) {
79  std::cout << "KLT and hybrid model-based tracker are not available since visp_klt module is missing"
80  << std::endl;
81  return EXIT_SUCCESS;
82  }
83 #endif
84 
86 
87 #if defined(VISP_HAVE_PUGIXML)
89  tracker.loadConfigFile(objectname + ".xml");
91 #else
92  // Corresponding parameters manually set to have an example code
93  if (opt_tracker == 1 || opt_tracker == 3) {
94  vpMe me;
95  me.setMaskSize(5);
96  me.setMaskNumber(180);
97  me.setRange(8);
99  me.setThreshold(20);
100  me.setMu1(0.5);
101  me.setMu2(0.5);
102  me.setSampleStep(4);
103  tracker.setMovingEdge(me);
104  }
105 
106 #if defined(VISP_HAVE_MODULE_KLT) && defined(VISP_HAVE_OPENCV) && defined(HAVE_OPENCV_IMGPROC) && defined(HAVE_OPENCV_VIDEO)
107  if (opt_tracker == 2 || opt_tracker == 3) {
108  vpKltOpencv klt_settings;
109  tracker.setKltMaskBorder(5);
110  klt_settings.setMaxFeatures(300);
111  klt_settings.setWindowSize(5);
112  klt_settings.setQuality(0.015);
113  klt_settings.setMinDistance(8);
114  klt_settings.setHarrisFreeParameter(0.01);
115  klt_settings.setBlockSize(3);
116  klt_settings.setPyramidLevels(3);
117  tracker.setKltOpencv(klt_settings);
118  }
119 #endif
120 
121  {
123  vpCameraParameters cam;
124  cam.initPersProjWithoutDistortion(839.21470, 839.44555, 325.66776, 243.69727);
125  tracker.setCameraParameters(cam);
127  }
128 #endif
130 
132  tracker.loadModel(objectname + ".cao");
135  tracker.setDisplayFeatures(true);
138  tracker.initClick(I, objectname + ".init", true);
140 
141  while (!g.end()) {
142  g.acquire(I);
145  tracker.track(I);
149  tracker.getPose(cMo);
152  vpCameraParameters cam;
153  tracker.getCameraParameters(cam);
154  tracker.display(I, cMo, cam, vpColor::red, 2);
156  vpDisplay::displayFrame(I, cMo, cam, 0.025, vpColor::none, 3);
157  vpDisplay::displayText(I, 10, 10, "A click to exit...", vpColor::red);
158  vpDisplay::flush(I);
159 
160  if (vpDisplay::getClick(I, false)) {
161  break;
162  }
163  }
165  }
166  catch (const vpException &e) {
167  std::cerr << "Catch a ViSP exception: " << e.what() << std::endl;
168 }
169 
170  return EXIT_SUCCESS;
171 #else
172  (void)argc;
173  (void)argv;
174  std::cout << "Install OpenCV and rebuild ViSP to use this example." << std::endl;
175  return EXIT_SUCCESS;
176 #endif
177 }
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...
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
const char * what() const
Definition: vpException.cpp:71
Implementation of an homogeneous matrix and operations on such kind of matrices.
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
Real-time 6D object pose tracking using its CAD model.
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)