1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
/**
* Copyright (c) 2015 Samsung Electronics Co., Ltd All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __IMAGETRACKINGMODEL_H__
#define __IMAGETRACKINGMODEL_H__
#include "Recognition/ImageObject.h"
#include "Tracking/ObjectTracker.h"
#include "Tracking/ImageContourStabilizator.h"
/**
* @file ImageTrackingModel.h
* @brief This file contains the @ref ImageTrackingModel class.
*/
namespace MediaVision {
namespace Image {
/**
* @class ImageTrackingModel
* @brief This class contains the tracking functionality for image objects.
*
* @since_tizen 3.0
*/
class ImageTrackingModel {
public:
/**
* @brief @ref ImageTrackingModel default constructor
*
* @since_tizen 3.0
*/
ImageTrackingModel();
/**
* @brief @ref ImageTrackingModel copy constructor.
* @details Creates copy of @ref ImageTrackingModel
*
* @since_tizen 3.0
* @param [in] copy @ref ImageTrackingModel which will be copied
*/
ImageTrackingModel(const ImageTrackingModel& copy);
/**
* @brief Sets @ref ImageObject as target which will be tracked.
*
* @since_tizen 3.0
* @param [in] target @ref ImageObject which will be tracked
*/
void setTarget(const ImageObject& target);
/**
* @brief Checks whether the tracking model is valid for tracking.
* @details Image tracking model is valid if its target is set and not empty.
*
* @since_tizen 3.0
* @remarks Invalid tracking model can not be tracked. Set not empty target
* by using corresponding constructor or function @ref setTarget()
* to make tracking model valid. Also you can load valid tracking
* model by using @ref load().
* @return @c true if tracking model is valid, otherwise return @c false
*/
bool isValid() const;
/**
* @brief Tracks the target for the video stream consisting of frames.
*
* @since_tizen 3.0
* @remarks Call this function alternately for each frame
* @param [in] frame Current frame of the video stream
* @param [out] result Result contour
* @return true if target is tracked, otherwise return false
*/
bool track(const cv::Mat& frame, std::vector<cv::Point>& result);
/**
* @brief Refreshes tracking model.
*
* @since_tizen 3.0
* @remarks Call it before starting track on the new video stream.
*/
void refresh(void);
/**
* @brief @ref ImageTrackingModel copy assignment operator.
* @details Fills the information based on the @a copy
*
* @since_tizen 3.0
* @param [in] copy @ref ImageTrackingModel which will be copied
*/
ImageTrackingModel& operator=(const ImageTrackingModel& copy);
/**
* @brief Stores the @ref ImageTrackingModel in a file.
*
* @since_tizen 3.0
* @param [in] filepath File name which will be generated
* @return @a 0 on success, otherwise a negative error value
*/
int save(const char *filepath) const;
/**
* @brief Loads the @ref ImageTrackingModel from the file.
*
* @since_tizen 3.0
* @param [in] filepath File name from which will be loaded a model
* @return @a 0 on success, otherwise a negative error value
*/
int load(const char *filepath);
friend std::ostream& operator << (
std::ostream& os,
const ImageTrackingModel& obj);
friend std::istream& operator >> (
std::istream& is,
ImageTrackingModel& obj);
private:
ImageObject m_target;
cv::Ptr<ObjectTracker> m_tracker;
ImageContourStabilizator m_stabilizator;
std::vector<cv::Point> m_location;
StabilizationParams m_stabilizationParams;
};
} /* Image */
} /* MediaVision */
#endif /* __IMAGETRACKINGMODEL_H__ */
|
