-
Notifications
You must be signed in to change notification settings - Fork 119
/
ARMarker.h
138 lines (111 loc) · 4.65 KB
/
ARMarker.h
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
/*
* ARMarker.h
* ARToolKit5
*
* This file is part of ARToolKit.
*
* ARToolKit is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* ARToolKit is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with ARToolKit. If not, see <http://www.gnu.org/licenses/>.
*
* As a special exception, the copyright holders of this library give you
* permission to link this library with independent modules to produce an
* executable, regardless of the license terms of these independent modules, and to
* copy and distribute the resulting executable under terms of your choice,
* provided that you also meet, for each linked independent module, the terms and
* conditions of the license of that module. An independent module is a module
* which is neither derived from nor based on this library. If you modify this
* library, you may extend this exception to your version of the library, but you
* are not obligated to do so. If you do not wish to do so, delete this exception
* statement from your version.
*
* Copyright 2015 Daqri, LLC.
* Copyright 2010-2015 ARToolworks, Inc.
*
* Author(s): Julian Looser, Philip Lamb
*
*/
#ifndef ARMARKER_H
#define ARMARKER_H
#include <AR/ar.h>
#include <AR/arFilterTransMat.h>
#include <ARWrapper/ARPattern.h>
#include <vector>
class ARController; // Forward declaration of owner.
/**
* Base class for supported marker types.
*/
class ARMarker {
private:
ARFilterTransMatInfo *m_ftmi;
ARdouble m_filterCutoffFrequency;
ARdouble m_filterSampleRate;
protected:
ARdouble trans[3][4]; ///< Transformation from camera to this marker. If stereo, transform from left camera to this marker.
/**
* Allocates space for patterns within this marker.
* @param count The number of patterns to allocate
*/
void allocatePatterns(int count);
/**
* Frees allocated patterns and resets the pattern count to zero.
*/
void freePatterns();
ARdouble m_positionScaleFactor;
public:
enum MarkerType {
SINGLE, ///< A standard single square marker
MULTI, ///< A composite marker made up of multiple single markers
NFT ///< A rectangular textured marker backed by an NFT data set.
};
int UID; ///< Internal unique ID (note: not the same as ARToolKit pattern ID)
MarkerType type; ///< Type of marker: single, multi, ...
// Factory methods.
static std::vector<ARMarker *> newFromConfigDataFile(const char *markersConfigDataFilePath, ARPattHandle *arPattHandle, int *patternDetectionMode_out);
static ARMarker* newWithConfig(const char* cfg, ARPattHandle *arPattHandle);
// Inputs from subclasses.
bool visiblePrev; ///< Whether or not the marker was visible prior to last update.
bool visible; ///< Whether or not the marker is visible at current time.
// Output.
ARdouble transformationMatrix[16]; ///< Transformation suitable for use in OpenGL
ARdouble transformationMatrixR[16]; ///< Transformation suitable for use in OpenGL
int patternCount; ///< Number of patterns in this marker (1 for single)
ARPattern** patterns; ///< Array of pointers to patterns
/**
* Constructor takes the type of this marker.
*/
ARMarker(MarkerType type);
virtual ~ARMarker();
void setPositionScalefactor(ARdouble scale);
ARdouble positionScalefactor();
/**
* Completes an update begun in the parent class, performing filtering, generating
* OpenGL view matrix and notifying listeners (just a log message at the moment).
* Subclasses should first do their required updates, set visible, visiblePrev,
* and trans[3][4] then call ARMarker::update().
* @return true if successful, false if an error occurred
*/
virtual bool update(const ARdouble transL2R[3][4] = NULL);
/**
* Returns the specified pattern within this marker.
* @param n The pattern to retrieve
*/
ARPattern* getPattern(int n);
// Filter control.
void setFiltered(bool flag);
bool isFiltered();
ARdouble filterSampleRate();
void setFilterSampleRate(ARdouble rate);
ARdouble filterCutoffFrequency();
void setFilterCutoffFrequency(ARdouble freq);
};
#endif // !ARMARKER_H