cannam@3
|
1 /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
|
cannam@3
|
2
|
cannam@3
|
3 /*
|
cannam@3
|
4 Vamp
|
cannam@3
|
5
|
cannam@3
|
6 An API for audio analysis and feature extraction plugins.
|
cannam@3
|
7
|
cannam@3
|
8 Centre for Digital Music, Queen Mary, University of London.
|
cannam@3
|
9 Copyright 2006 Chris Cannam.
|
cannam@3
|
10
|
cannam@3
|
11 Permission is hereby granted, free of charge, to any person
|
cannam@3
|
12 obtaining a copy of this software and associated documentation
|
cannam@3
|
13 files (the "Software"), to deal in the Software without
|
cannam@3
|
14 restriction, including without limitation the rights to use, copy,
|
cannam@3
|
15 modify, merge, publish, distribute, sublicense, and/or sell copies
|
cannam@3
|
16 of the Software, and to permit persons to whom the Software is
|
cannam@3
|
17 furnished to do so, subject to the following conditions:
|
cannam@3
|
18
|
cannam@3
|
19 The above copyright notice and this permission notice shall be
|
cannam@3
|
20 included in all copies or substantial portions of the Software.
|
cannam@3
|
21
|
cannam@3
|
22 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
cannam@3
|
23 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
cannam@3
|
24 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
cannam@6
|
25 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
|
cannam@3
|
26 ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
|
cannam@3
|
27 CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
cannam@3
|
28 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
cannam@3
|
29
|
cannam@3
|
30 Except as contained in this notice, the names of the Centre for
|
cannam@3
|
31 Digital Music; Queen Mary, University of London; and Chris Cannam
|
cannam@3
|
32 shall not be used in advertising or otherwise to promote the sale,
|
cannam@3
|
33 use or other dealings in this Software without prior written
|
cannam@3
|
34 authorization.
|
cannam@3
|
35 */
|
cannam@3
|
36
|
cannam@3
|
37 /*
|
cannam@3
|
38 This is a modified version of a source file from the
|
cannam@3
|
39 Rosegarden MIDI and audio sequencer and notation editor.
|
cannam@10
|
40 This file copyright 2000-2006 Chris Cannam.
|
cannam@10
|
41 Relicensed by the author as detailed above.
|
cannam@3
|
42 */
|
cannam@3
|
43
|
cannam@5
|
44 #ifndef _VAMP_REAL_TIME_H_
|
cannam@5
|
45 #define _VAMP_REAL_TIME_H_
|
cannam@3
|
46
|
cannam@3
|
47 #include <iostream>
|
cannam@3
|
48 #include <string>
|
cannam@3
|
49
|
cannam@80
|
50 #ifndef _WIN32
|
cannam@3
|
51 struct timeval;
|
cannam@80
|
52 #endif
|
cannam@3
|
53
|
cannam@3
|
54 namespace Vamp {
|
cannam@3
|
55
|
cannam@3
|
56 /**
|
cannam@76
|
57 * \class RealTime RealTime.h <vamp-sdk/RealTime.h>
|
cannam@76
|
58 *
|
cannam@3
|
59 * RealTime represents time values to nanosecond precision
|
cannam@3
|
60 * with accurate arithmetic and frame-rate conversion functions.
|
cannam@3
|
61 */
|
cannam@3
|
62
|
cannam@3
|
63 struct RealTime
|
cannam@3
|
64 {
|
cannam@3
|
65 int sec;
|
cannam@3
|
66 int nsec;
|
cannam@3
|
67
|
cannam@3
|
68 int usec() const { return nsec / 1000; }
|
cannam@3
|
69 int msec() const { return nsec / 1000000; }
|
cannam@3
|
70
|
cannam@3
|
71 RealTime(): sec(0), nsec(0) {}
|
cannam@3
|
72 RealTime(int s, int n);
|
cannam@3
|
73
|
cannam@3
|
74 RealTime(const RealTime &r) :
|
cannam@3
|
75 sec(r.sec), nsec(r.nsec) { }
|
cannam@3
|
76
|
cannam@3
|
77 static RealTime fromSeconds(double sec);
|
cannam@3
|
78 static RealTime fromMilliseconds(int msec);
|
cannam@80
|
79
|
cannam@80
|
80 #ifndef _WIN32
|
cannam@3
|
81 static RealTime fromTimeval(const struct timeval &);
|
cannam@80
|
82 #endif
|
cannam@3
|
83
|
cannam@3
|
84 RealTime &operator=(const RealTime &r) {
|
cannam@3
|
85 sec = r.sec; nsec = r.nsec; return *this;
|
cannam@3
|
86 }
|
cannam@3
|
87
|
cannam@3
|
88 RealTime operator+(const RealTime &r) const {
|
cannam@3
|
89 return RealTime(sec + r.sec, nsec + r.nsec);
|
cannam@3
|
90 }
|
cannam@3
|
91 RealTime operator-(const RealTime &r) const {
|
cannam@3
|
92 return RealTime(sec - r.sec, nsec - r.nsec);
|
cannam@3
|
93 }
|
cannam@3
|
94 RealTime operator-() const {
|
cannam@3
|
95 return RealTime(-sec, -nsec);
|
cannam@3
|
96 }
|
cannam@3
|
97
|
cannam@3
|
98 bool operator <(const RealTime &r) const {
|
cannam@3
|
99 if (sec == r.sec) return nsec < r.nsec;
|
cannam@3
|
100 else return sec < r.sec;
|
cannam@3
|
101 }
|
cannam@3
|
102
|
cannam@3
|
103 bool operator >(const RealTime &r) const {
|
cannam@3
|
104 if (sec == r.sec) return nsec > r.nsec;
|
cannam@3
|
105 else return sec > r.sec;
|
cannam@3
|
106 }
|
cannam@3
|
107
|
cannam@3
|
108 bool operator==(const RealTime &r) const {
|
cannam@3
|
109 return (sec == r.sec && nsec == r.nsec);
|
cannam@3
|
110 }
|
cannam@3
|
111
|
cannam@3
|
112 bool operator!=(const RealTime &r) const {
|
cannam@3
|
113 return !(r == *this);
|
cannam@3
|
114 }
|
cannam@3
|
115
|
cannam@3
|
116 bool operator>=(const RealTime &r) const {
|
cannam@3
|
117 if (sec == r.sec) return nsec >= r.nsec;
|
cannam@3
|
118 else return sec >= r.sec;
|
cannam@3
|
119 }
|
cannam@3
|
120
|
cannam@3
|
121 bool operator<=(const RealTime &r) const {
|
cannam@3
|
122 if (sec == r.sec) return nsec <= r.nsec;
|
cannam@3
|
123 else return sec <= r.sec;
|
cannam@3
|
124 }
|
cannam@3
|
125
|
cannam@3
|
126 RealTime operator/(int d) const;
|
cannam@3
|
127
|
cannam@99
|
128 /**
|
cannam@99
|
129 * Return the ratio of two times.
|
cannam@99
|
130 */
|
cannam@3
|
131 double operator/(const RealTime &r) const;
|
cannam@3
|
132
|
cannam@99
|
133 /**
|
cannam@99
|
134 * Return a human-readable debug-type string to full precision
|
cannam@99
|
135 * (probably not a format to show to a user directly)
|
cannam@99
|
136 */
|
cannam@3
|
137 std::string toString() const;
|
cannam@3
|
138
|
cannam@99
|
139 /**
|
cannam@99
|
140 * Return a user-readable string to the nearest millisecond
|
cannam@99
|
141 * in a form like HH:MM:SS.mmm
|
cannam@99
|
142 */
|
cannam@3
|
143 std::string toText(bool fixedDp = false) const;
|
cannam@3
|
144
|
cannam@99
|
145 /**
|
cannam@99
|
146 * Convert a RealTime into a sample frame at the given sample rate.
|
cannam@99
|
147 */
|
cannam@3
|
148 static long realTime2Frame(const RealTime &r, unsigned int sampleRate);
|
cannam@99
|
149
|
cannam@99
|
150 /**
|
cannam@99
|
151 * Convert a sample frame at the given sample rate into a RealTime.
|
cannam@99
|
152 */
|
cannam@3
|
153 static RealTime frame2RealTime(long frame, unsigned int sampleRate);
|
cannam@3
|
154
|
cannam@3
|
155 static const RealTime zeroTime;
|
cannam@3
|
156 };
|
cannam@3
|
157
|
cannam@3
|
158 std::ostream &operator<<(std::ostream &out, const RealTime &rt);
|
cannam@3
|
159
|
cannam@3
|
160 }
|
cannam@3
|
161
|
cannam@3
|
162 #endif
|