OpenCV 4.5.3(日本語機械翻訳)
tracking_legacy.hpp
1 /*M///////////////////////////////////////////////////////////////////////////////////////
2 //
3 // IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
4 //
5 // By downloading, copying, installing or using the software you agree to this license.
6 // If you do not agree to this license, do not download, install,
7 // copy or use the software.
8 //
9 //
10 // License Agreement
11 // For Open Source Computer Vision Library
12 //
13 // Copyright (C) 2013, OpenCV Foundation, all rights reserved.
14 // Third party copyrights are property of their respective owners.
15 //
16 // Redistribution and use in source and binary forms, with or without modification,
17 // are permitted provided that the following conditions are met:
18 //
19 // * Redistribution's of source code must retain the above copyright notice,
20 // this list of conditions and the following disclaimer.
21 //
22 // * Redistribution's in binary form must reproduce the above copyright notice,
23 // this list of conditions and the following disclaimer in the documentation
24 // and/or other materials provided with the distribution.
25 //
26 // * The name of the copyright holders may not be used to endorse or promote products
27 // derived from this software without specific prior written permission.
28 //
29 // This software is provided by the copyright holders and contributors "as is" and
30 // any express or implied warranties, including, but not limited to, the implied
31 // warranties of merchantability and fitness for a particular purpose are disclaimed.
32 // In no event shall the Intel Corporation or contributors be liable for any direct,
33 // indirect, incidental, special, exemplary, or consequential damages
34 // (including, but not limited to, procurement of substitute goods or services;
35 // loss of use, data, or profits; or business interruption) however caused
36 // and on any theory of liability, whether in contract, strict liability,
37 // or tort (including negligence or otherwise) arising in any way out of
38 // the use of this software, even if advised of the possibility of such damage.
39 //
40 //M*/
41
42 #ifndef OPENCV_TRACKING_LEGACY_HPP
43 #define OPENCV_TRACKING_LEGACY_HPP
44
45 /*
46 * Partially based on:
47 * ====================================================================================================================
48 * - [AAM] S. Salti, A. Cavallaro, L. Di Stefano, Adaptive Appearance Modeling for Video Tracking: Survey and Evaluation
49 * - [AMVOT] X. Li, W. Hu, C. Shen, Z. Zhang, A. Dick, A. van den Hengel, A Survey of Appearance Models in Visual Object Tracking
50 *
51 * This Tracking API has been designed with PlantUML. If you modify this API please change UML files under modules/tracking/doc/uml
52 *
53 */
54
55 #include "tracking_internals.hpp"
56
57 namespace cv {
58 namespace legacy {
59 #ifndef CV_DOXYGEN
60 inline namespace tracking {
61 #endif
62 using namespace cv::detail::tracking;
63
68 /************************************ Tracker Base Class ************************************/
69
72 class CV_EXPORTS_W Tracker : public virtual Algorithm
73{
74 public:
75 Tracker();
76 virtual ~Tracker() CV_OVERRIDE;
77
84 CV_WRAP bool init( InputArray image, const Rect2d& boundingBox );
85
95 CV_WRAP bool update( InputArray image, CV_OUT Rect2d& boundingBox );
96
97 virtual void read( const FileNode& fn ) CV_OVERRIDE = 0;
98 virtual void write( FileStorage& fs ) const CV_OVERRIDE = 0;
99
100 protected:
101
102 virtual bool initImpl( const Mat& image, const Rect2d& boundingBox ) = 0;
103 virtual bool updateImpl( const Mat& image, Rect2d& boundingBox ) = 0;
104
105 bool isInit;
106
107 Ptr<TrackerContribFeatureSet> featureSet;
108 Ptr<TrackerContribSampler> sampler;
109 Ptr<TrackerModel> model;
110};
111
112
113 /************************************ Specific Tracker Classes ************************************/
114
123 class CV_EXPORTS_W TrackerMIL : public cv::legacy::Tracker
124{
125 public:
126 struct CV_EXPORTS Params : cv::TrackerMIL::Params
127 {
128 void read( const FileNode& fn );
129 void write( FileStorage& fs ) const;
130 };
131
135 static Ptr<legacy::TrackerMIL> create(const TrackerMIL::Params &parameters);
136
137 CV_WRAP static Ptr<legacy::TrackerMIL> create();
138
139 virtual ~TrackerMIL() CV_OVERRIDE {}
140};
141
148 class CV_EXPORTS_W TrackerBoosting : public cv::legacy::Tracker
149{
150 public:
151 struct CV_EXPORTS Params
152 {
153 Params();
154 int numClassifiers;
155 float samplerOverlap;
156 float samplerSearchFactor;
157 int iterationInit;
158 int featureSetNumFeatures;
162 void read( const FileNode& fn );
163
167 void write( FileStorage& fs ) const;
168 };
169
173 static Ptr<legacy::TrackerBoosting> create(const TrackerBoosting::Params &parameters);
174
175 CV_WRAP static Ptr<legacy::TrackerBoosting> create();
176
177 virtual ~TrackerBoosting() CV_OVERRIDE {}
178};
179
190 class CV_EXPORTS_W TrackerMedianFlow : public cv::legacy::Tracker
191{
192 public:
193 struct CV_EXPORTS Params
194 {
195 Params();
197 int pointsInGrid;
199 cv::Size winSize;
200 int maxLevel;
201 TermCriteria termCriteria;
202 cv::Size winSizeNCC;
203 double maxMedianLengthOfDisplacementDifference;
204
205 void read( const FileNode& /*fn*/ );
206 void write( FileStorage& /*fs*/ ) const;
207 };
208
212 static Ptr<legacy::TrackerMedianFlow> create(const TrackerMedianFlow::Params &parameters);
213
214 CV_WRAP static Ptr<legacy::TrackerMedianFlow> create();
215
216 virtual ~TrackerMedianFlow() CV_OVERRIDE {}
217};
218
232 class CV_EXPORTS_W TrackerTLD : public cv::legacy::Tracker
233{
234 public:
235 struct CV_EXPORTS Params
236 {
237 Params();
238 void read( const FileNode& /*fn*/ );
239 void write( FileStorage& /*fs*/ ) const;
240 };
241
245 static Ptr<legacy::TrackerTLD> create(const TrackerTLD::Params &parameters);
246
247 CV_WRAP static Ptr<legacy::TrackerTLD> create();
248
249 virtual ~TrackerTLD() CV_OVERRIDE {}
250};
251
260 class CV_EXPORTS_W TrackerKCF : public cv::legacy::Tracker
261{
262 public:
269 typedef enum cv::tracking::TrackerKCF::MODE MODE;
270
271 struct CV_EXPORTS Params : cv::tracking::TrackerKCF::Params
272 {
273 void read(const FileNode& /*fn*/);
274 void write(FileStorage& /*fs*/) const;
275 };
276
277 virtual void setFeatureExtractor(void(*)(const Mat, const Rect, Mat&), bool pca_func = false) = 0;
278
282 static Ptr<legacy::TrackerKCF> create(const TrackerKCF::Params &parameters);
283
284 CV_WRAP static Ptr<legacy::TrackerKCF> create();
285
286 virtual ~TrackerKCF() CV_OVERRIDE {}
287};
288
289 #if 0 // legacy variant is not available
305 class CV_EXPORTS_W TrackerGOTURN : public cv::legacy::Tracker
306{
307 public:
308 struct CV_EXPORTS Params
309 {
310 Params();
311 void read(const FileNode& /*fn*/);
312 void write(FileStorage& /*fs*/) const;
313 String modelTxt;
314 String modelBin;
315 };
316
320 static Ptr<legacy::TrackerGOTURN> create(const TrackerGOTURN::Params &parameters);
321
322 CV_WRAP static Ptr<legacy::TrackerGOTURN> create();
323
324 virtual ~TrackerGOTURN() CV_OVERRIDE {}
325};
326 #endif
327
334 class CV_EXPORTS_W TrackerMOSSE : public cv::legacy::Tracker
335{
336 public:
339 CV_WRAP static Ptr<legacy::TrackerMOSSE> create();
340
341 virtual ~TrackerMOSSE() CV_OVERRIDE {}
342};
343
344
345 /************************************ MultiTracker Class ---By Laksono Kurnianggoro---) ************************************/
351 class CV_EXPORTS_W MultiTracker : public Algorithm
352{
353 public:
354
358 CV_WRAP MultiTracker();
359
363 ~MultiTracker() CV_OVERRIDE;
364
372 CV_WRAP bool add(Ptr<cv::legacy::Tracker> newTracker, InputArray image, const Rect2d& boundingBox);
373
380 bool add(std::vector<Ptr<legacy::Tracker> > newTrackers, InputArray image, std::vector<Rect2d> boundingBox);
381
387 bool update(InputArray image);
388
394 CV_WRAP bool update(InputArray image, CV_OUT std::vector<Rect2d> & boundingBox);
395
399 CV_WRAP const std::vector<Rect2d>& getObjects() const;
400
404 CV_WRAP static Ptr<MultiTracker> create();
405
406protected:
408 std::vector< Ptr<Tracker> > trackerList;
409
411 std::vector<Rect2d> objects;
412};
413
414 /************************************ Multi-Tracker Classes ---By Tyan Vladimir---************************************/
415
420 class CV_EXPORTS MultiTracker_Alt
421{
422 public:
425 MultiTracker_Alt()
426 {
427 targetNum = 0;
428 }
429
437 bool addTarget(InputArray image, const Rect2d& boundingBox, Ptr<legacy::Tracker> tracker_algorithm);
438
446 bool update(InputArray image);
447
450 int targetNum;
451
454 std::vector <Ptr<Tracker> > trackers;
455
458 std::vector <Rect2d> boundingBoxes;
461 std::vector<Scalar> colors;
462};
463
479 class CV_EXPORTS MultiTrackerTLD : public MultiTracker_Alt
480{
481 public:
492 bool update_opt(InputArray image);
493};
494
495 /*********************************** CSRT ************************************/
500 class CV_EXPORTS_W TrackerCSRT : public cv::legacy::Tracker
501{
502 public:
503 struct CV_EXPORTS Params : cv::tracking::TrackerCSRT::Params
504 {
508 void read(const FileNode& /*fn*/);
509
513 void write(cv::FileStorage& fs) const;
514 };
515
519 static Ptr<legacy::TrackerCSRT> create(const TrackerCSRT::Params &parameters);
520
521 CV_WRAP static Ptr<legacy::TrackerCSRT> create();
522
523 CV_WRAP virtual void setInitialMask(InputArray mask) = 0;
524
525 virtual ~TrackerCSRT() CV_OVERRIDE {}
526};
527
528
529CV_EXPORTS_W Ptr<cv::Tracker> upgradeTrackingAPI(const Ptr<legacy::Tracker>& legacy_tracker);
530
532
533 #ifndef CV_DOXYGEN
534} // namespace
535 #endif
536}} // namespace
537
538 #endif // OPENCV_TRACKING_LEGACY_HPP
cv::Algorithm
This is a base class for all more or less complex algorithms in OpenCV
Definition: core.hpp:3091
cv::FileNode
File Storage Node class.
Definition: persistence.hpp:482
cv::FileStorage
XML/YAML/JSON file storage class that encapsulates all the information necessary for writing or readi...
Definition: persistence.hpp:304
cv::Mat
n-dimensional dense array class
Definition: mat.hpp:802
cv::Rect_
Template class for 2D rectangles
Definition: core/types.hpp:421
cv::Size_
Template class for specifying the size of an image or rectangle.
Definition: core/types.hpp:316
cv::TermCriteria
The class defining termination criteria for iterative algorithms.
Definition: core/types.hpp:853
cv::TrackerGOTURN
the GOTURN (Generic Object Tracking Using Regression Networks) tracker
Definition: video/tracking.hpp:798
cv::legacy::MultiTracker_Alt
Base abstract class for the long-term Multi Object Trackers:
Definition: tracking_legacy.hpp:421
cv::legacy::tracking::MultiTracker_Alt::colors
std::vector< Scalar > colors
List of randomly generated colors for bounding boxes display
Definition: tracking_legacy.hpp:461
cv::legacy::tracking::MultiTracker_Alt::targetNum
int targetNum
Current number of targets in tracking-list
Definition: tracking_legacy.hpp:450
cv::legacy::tracking::MultiTracker_Alt::MultiTracker_Alt
MultiTracker_Alt()
Constructor for Multitracker
Definition: tracking_legacy.hpp:425
cv::legacy::tracking::MultiTracker_Alt::addTarget
bool addTarget(InputArray image, const Rect2d &boundingBox, Ptr< legacy::Tracker > tracker_algorithm)
Add a new target to a tracking-list and initialize the tracker with a known bounding box that surroun...
cv::legacy::tracking::MultiTracker_Alt::trackers
std::vector< Ptr< Tracker > > trackers
Trackers list for Multi-Object-Tracker
Definition: tracking_legacy.hpp:454
cv::legacy::tracking::MultiTracker_Alt::boundingBoxes
std::vector< Rect2d > boundingBoxes
Bounding Boxes list for Multi-Object-Tracker
Definition: tracking_legacy.hpp:458
cv::legacy::tracking::MultiTracker_Alt::update
bool update(InputArray image)
Update all trackers from the tracking-list, find a new most likely bounding boxes for the targets
cv::legacy::MultiTracker
This class is used to track multiple objects using the specified tracker algorithm.
Definition: tracking_legacy.hpp:352
cv::legacy::tracking::MultiTracker::~MultiTracker
~MultiTracker() CV_OVERRIDE
Destructor
cv::legacy::MultiTrackerTLD
Multi Object Tracker for TLD.
Definition: tracking_legacy.hpp:480
cv::legacy::tracking::MultiTrackerTLD::update_opt
bool update_opt(InputArray image)
Update all trackers from the tracking-list, find a new most likely bounding boxes for the targets by ...
cv::legacy::TrackerBoosting
the Boosting tracker
Definition: tracking_legacy.hpp:149
cv::legacy::tracking::TrackerBoosting::create
static Ptr< legacy::TrackerBoosting > create(const TrackerBoosting::Params &parameters)
Constructor
cv::legacy::TrackerCSRT
the CSRT tracker
Definition: tracking_legacy.hpp:501
cv::legacy::tracking::TrackerCSRT::create
static Ptr< legacy::TrackerCSRT > create(const TrackerCSRT::Params &parameters)
Constructor
cv::legacy::Tracker
Base abstract class for the long-term tracker:
Definition: tracking_legacy.hpp:73
cv::legacy::tracking::Tracker::read
virtual void read(const FileNode &fn) CV_OVERRIDE=0
Reads algorithm parameters from a file storage
cv::legacy::tracking::Tracker::write
virtual void write(FileStorage &fs) const CV_OVERRIDE=0
Stores algorithm parameters in a file storage
cv::legacy::TrackerKCF
the KCF (Kernelized Correlation Filter) tracker
Definition: tracking_legacy.hpp:261
cv::legacy::tracking::TrackerKCF::MODE
enum cv::tracking::TrackerKCF::MODE MODE
Feature type to be used in the tracking grayscale, colornames, compressed color-names The modes avail...
Definition: tracking_legacy.hpp:269
cv::legacy::tracking::TrackerKCF::create
static Ptr< legacy::TrackerKCF > create(const TrackerKCF::Params &parameters)
Constructor
cv::legacy::TrackerMIL
The MIL algorithm trains a classifier in an online manner to separate the object from the background.
Definition: tracking_legacy.hpp:124
cv::legacy::tracking::TrackerMIL::create
static Ptr< legacy::TrackerMIL > create(const TrackerMIL::Params &parameters)
Constructor
cv::legacy::TrackerMOSSE
the MOSSE (Minimum Output Sum of Squared Error) tracker
Definition: tracking_legacy.hpp:335
cv::legacy::TrackerMedianFlow
the Median Flow tracker
Definition: tracking_legacy.hpp:191
cv::legacy::tracking::TrackerMedianFlow::create
static Ptr< legacy::TrackerMedianFlow > create(const TrackerMedianFlow::Params &parameters)
Constructor
cv::legacy::TrackerTLD
the TLD (Tracking, learning and detection) tracker
Definition: tracking_legacy.hpp:233
cv::legacy::tracking::TrackerTLD::create
static Ptr< legacy::TrackerTLD > create(const TrackerTLD::Params &parameters)
Constructor
cv::tracking::TrackerKCF::MODE
MODE
Feature type to be used in the tracking grayscale, colornames, compressed color-names The modes avail...
Definition: tracking.hpp:111
cv::add
CV_EXPORTS_W void add(InputArray src1, InputArray src2, OutputArray dst, InputArray mask=noArray(), int dtype=-1)
Calculates the per-element sum of two arrays or an array and a scalar.
cv
"black box" representation of the file storage associated with a file on disk.
Definition: aruco.hpp:75
cv::Ptr
Definition: cvstd_wrapper.hpp:74
cv::TrackerGOTURN::Params
Definition: video/tracking.hpp:805
cv::TrackerMIL::Params
Definition: video/tracking.hpp:758
cv::legacy::tracking::TrackerBoosting::Params
Definition: tracking_legacy.hpp:152
cv::legacy::tracking::TrackerBoosting::Params::featureSetNumFeatures
int featureSetNumFeatures
Definition: tracking_legacy.hpp:158
cv::legacy::tracking::TrackerBoosting::Params::write
void write(FileStorage &fs) const
Write parameters to a file
cv::legacy::tracking::TrackerBoosting::Params::iterationInit
int iterationInit
the initial iterations
Definition: tracking_legacy.hpp:157
cv::legacy::tracking::TrackerBoosting::Params::samplerOverlap
float samplerOverlap
search region parameters to use in a OnlineBoosting algorithm
Definition: tracking_legacy.hpp:155
cv::legacy::tracking::TrackerBoosting::Params::samplerSearchFactor
float samplerSearchFactor
search region parameters to use in a OnlineBoosting algorithm
Definition: tracking_legacy.hpp:156
cv::legacy::tracking::TrackerBoosting::Params::numClassifiers
int numClassifiers
the number of classifiers to use in a OnlineBoosting algorithm
Definition: tracking_legacy.hpp:154
cv::legacy::tracking::TrackerBoosting::Params::read
void read(const FileNode &fn)
Read parameters from a file
cv::legacy::tracking::TrackerCSRT::Params
Definition: tracking_legacy.hpp:504
cv::legacy::tracking::TrackerCSRT::Params::write
void write(cv::FileStorage &fs) const
Write parameters to a file
cv::legacy::tracking::TrackerCSRT::Params::read
void read(const FileNode &)
Read parameters from a file
cv::legacy::tracking::TrackerKCF::Params
Definition: tracking_legacy.hpp:272
cv::legacy::tracking::TrackerMIL::Params
Definition: tracking_legacy.hpp:127
cv::legacy::tracking::TrackerMedianFlow::Params
Definition: tracking_legacy.hpp:194
cv::legacy::tracking::TrackerMedianFlow::Params::termCriteria
TermCriteria termCriteria
termination criteria for Lucas-Kanade optical flow
Definition: tracking_legacy.hpp:201
cv::legacy::tracking::TrackerMedianFlow::Params::pointsInGrid
int pointsInGrid
Definition: tracking_legacy.hpp:197
cv::legacy::tracking::TrackerMedianFlow::Params::winSize
cv::Size winSize
window size parameter for Lucas-Kanade optical flow
Definition: tracking_legacy.hpp:199
cv::legacy::tracking::TrackerMedianFlow::Params::maxMedianLengthOfDisplacementDifference
double maxMedianLengthOfDisplacementDifference
criterion for loosing the tracked object
Definition: tracking_legacy.hpp:203
cv::legacy::tracking::TrackerMedianFlow::Params::winSizeNCC
cv::Size winSizeNCC
window size around a point for normalized cross-correlation check
Definition: tracking_legacy.hpp:202
cv::legacy::tracking::TrackerMedianFlow::Params::maxLevel
int maxLevel
maximal pyramid level number for Lucas-Kanade optical flow
Definition: tracking_legacy.hpp:200
cv::legacy::tracking::TrackerTLD::Params
Definition: tracking_legacy.hpp:236
cv::tracking::TrackerCSRT::Params
Definition: tracking.hpp:42
cv::tracking::TrackerKCF::Params
Definition: tracking.hpp:118
構築: doxygen 1.9.2