| OpenCV 3.4.8 Open Source Computer Vision

Introduction to OpenCV Tracker

## Goal

In this tutorial you will learn how to

- Create a tracker object.
- Use the roiSelector function to select a ROI from a given image.
- Track a specific region in a given image.

## Source Code

#include <opencv2/core/utility.hpp>
#include <opencv2/tracking.hpp>
#include <opencv2/videoio.hpp>
#include <opencv2/highgui.hpp>
#include <iostream>
#include <cstring>
using namespace std;
using namespace cv;
int main( int argc, char** argv ){
// show help
if(argc<2){
cout<<
" Usage: tracker <video_name>\n"
" examples:\n"
" example_tracking_kcf Bolt/img/%04d.jpg\n"
" example_tracking_kcf faceocc2.webm\n"
<< endl;
return 0;
}
// declares all required variables
Rect2d roi;
Mat frame;
// create a tracker object
Ptr<Tracker> tracker = TrackerKCF::create();
// set input video
std::string video = argv[1];
VideoCapture cap(video);
// get bounding box
cap >> frame;
roi=selectROI("tracker",frame);
//quit if ROI was not selected
if(roi.width==0 || roi.height==0)
return 0;
// initialize the tracker
tracker->init(frame,roi);
// perform the tracking process
printf("Start the tracking process, press ESC to quit.\n");
for ( ;; ){
// get frame from the video
cap >> frame;
// stop the program if no more images
if(frame.rows==0 || frame.cols==0)
break;
// update the tracking result
tracker->update(frame,roi);
// draw the tracked object
rectangle( frame, roi, Scalar( 255, 0, 0 ), 2, 1 );
// show image with the tracked object
imshow("tracker",frame);
//quit on ESC button
if(waitKey(1)==27)break;
}
return 0;
}

## Explanation

1. Set up the input video

   if(argc<2){
   cout<<
   " Usage: tracker <video_name>\n"
   " examples:\n"
   " example_tracking_kcf Bolt/img/%04d.jpg\n"
   " example_tracking_kcf faceocc2.webm\n"
   << endl;
   return 0;
   }

   In this tutorial, you can choose between video or list of images for the program input. As written in the help, you should specify the input video as parameter of the program. If you want to use image list as input, the image list should have formatted numbering as shown in help. In the help, it means that the image files are numbered with 4 digits (e.g. the file naming will be 0001.jpg, 0002.jpg, and so on).

   You can find video samples in opencv_extra/testdata/cv/tracking https://github.com/opencv/opencv_extra/tree/master/testdata/cv/tracking

2. Declares the required variables

   You need roi to record the bounding box of the tracked object. The value stored in this variable will be updated using the tracker object.

   Rect2d roi;
   Mat frame;

   The frame variable is used to hold the image data from each frame of the input video or images list.

3. Creating a tracker object

   Ptr<Tracker> tracker = TrackerKCF::create();

   There are at least 7 types of tracker algorithms that can be used:

   - MIL
   - BOOSTING
   - MEDIANFLOW
   - TLD
   - KCF
   - GOTURN
   - MOSSE

   Each tracker algorithm has their own advantages and disadvantages, please refer the documentation of cv::Tracker for more detailed information.

4. Select the tracked object

   roi=selectROI("tracker",frame);

   Using this function, you can select the bounding box of the tracked object using a GUI. With default parameters, the selection is started from the center of the box and a middle cross will be shown.

5. Initializing the tracker object

   tracker->init(frame,roi);

   Any tracker algorithm should be initialized with the provided image data, and an initial bounding box of the tracked object. Make sure that the bounding box is valid (size more than zero) to avoid failure of the initialization process.

6. Update

   tracker->update(frame,roi);

   This update function will perform the tracking process and pass the result to the roi variable.