Chris@49
|
1 /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
|
Chris@0
|
2
|
Chris@0
|
3 /*
|
Chris@52
|
4 Sonic Visualiser
|
Chris@52
|
5 An audio file viewer and annotation editor.
|
Chris@52
|
6 Centre for Digital Music, Queen Mary, University of London.
|
Chris@0
|
7
|
Chris@52
|
8 This program is free software; you can redistribute it and/or
|
Chris@52
|
9 modify it under the terms of the GNU General Public License as
|
Chris@52
|
10 published by the Free Software Foundation; either version 2 of the
|
Chris@52
|
11 License, or (at your option) any later version. See the file
|
Chris@52
|
12 COPYING included with this distribution for more information.
|
Chris@0
|
13 */
|
Chris@0
|
14
|
Chris@0
|
15 /*
|
Chris@0
|
16 This is a modified version of a source file from the
|
Chris@0
|
17 Rosegarden MIDI and audio sequencer and notation editor.
|
Chris@17
|
18 This file copyright 2000-2006 Chris Cannam.
|
Chris@0
|
19 */
|
Chris@0
|
20
|
Chris@0
|
21 #ifndef _REAL_TIME_H_
|
Chris@0
|
22 #define _REAL_TIME_H_
|
Chris@0
|
23
|
Chris@1038
|
24 #include "BaseTypes.h"
|
Chris@1038
|
25
|
Chris@0
|
26 #include <iostream>
|
Chris@0
|
27 #include <string>
|
Chris@0
|
28
|
Chris@26
|
29 struct timeval;
|
Chris@26
|
30
|
Chris@0
|
31 /**
|
Chris@0
|
32 * RealTime represents time values to nanosecond precision
|
Chris@0
|
33 * with accurate arithmetic and frame-rate conversion functions.
|
Chris@0
|
34 */
|
Chris@0
|
35
|
Chris@0
|
36 struct RealTime
|
Chris@0
|
37 {
|
Chris@0
|
38 int sec;
|
Chris@0
|
39 int nsec;
|
Chris@0
|
40
|
Chris@0
|
41 int usec() const { return nsec / 1000; }
|
Chris@0
|
42 int msec() const { return nsec / 1000000; }
|
Chris@0
|
43
|
Chris@0
|
44 RealTime(): sec(0), nsec(0) {}
|
Chris@0
|
45 RealTime(int s, int n);
|
Chris@0
|
46
|
Chris@0
|
47 RealTime(const RealTime &r) :
|
Chris@0
|
48 sec(r.sec), nsec(r.nsec) { }
|
Chris@0
|
49
|
Chris@26
|
50 static RealTime fromSeconds(double sec);
|
Chris@26
|
51 static RealTime fromMilliseconds(int msec);
|
Chris@26
|
52 static RealTime fromTimeval(const struct timeval &);
|
Chris@439
|
53 static RealTime fromXsdDuration(std::string xsdd);
|
Chris@439
|
54
|
Chris@439
|
55 double toDouble() const;
|
Chris@26
|
56
|
Chris@0
|
57 RealTime &operator=(const RealTime &r) {
|
Chris@0
|
58 sec = r.sec; nsec = r.nsec; return *this;
|
Chris@0
|
59 }
|
Chris@0
|
60
|
Chris@0
|
61 RealTime operator+(const RealTime &r) const {
|
Chris@0
|
62 return RealTime(sec + r.sec, nsec + r.nsec);
|
Chris@0
|
63 }
|
Chris@0
|
64 RealTime operator-(const RealTime &r) const {
|
Chris@0
|
65 return RealTime(sec - r.sec, nsec - r.nsec);
|
Chris@0
|
66 }
|
Chris@0
|
67 RealTime operator-() const {
|
Chris@0
|
68 return RealTime(-sec, -nsec);
|
Chris@0
|
69 }
|
Chris@0
|
70
|
Chris@0
|
71 bool operator <(const RealTime &r) const {
|
Chris@0
|
72 if (sec == r.sec) return nsec < r.nsec;
|
Chris@0
|
73 else return sec < r.sec;
|
Chris@0
|
74 }
|
Chris@0
|
75
|
Chris@0
|
76 bool operator >(const RealTime &r) const {
|
Chris@0
|
77 if (sec == r.sec) return nsec > r.nsec;
|
Chris@0
|
78 else return sec > r.sec;
|
Chris@0
|
79 }
|
Chris@0
|
80
|
Chris@0
|
81 bool operator==(const RealTime &r) const {
|
Chris@0
|
82 return (sec == r.sec && nsec == r.nsec);
|
Chris@0
|
83 }
|
Chris@0
|
84
|
Chris@0
|
85 bool operator!=(const RealTime &r) const {
|
Chris@0
|
86 return !(r == *this);
|
Chris@0
|
87 }
|
Chris@0
|
88
|
Chris@0
|
89 bool operator>=(const RealTime &r) const {
|
Chris@0
|
90 if (sec == r.sec) return nsec >= r.nsec;
|
Chris@0
|
91 else return sec >= r.sec;
|
Chris@0
|
92 }
|
Chris@0
|
93
|
Chris@0
|
94 bool operator<=(const RealTime &r) const {
|
Chris@0
|
95 if (sec == r.sec) return nsec <= r.nsec;
|
Chris@0
|
96 else return sec <= r.sec;
|
Chris@0
|
97 }
|
Chris@0
|
98
|
Chris@183
|
99 RealTime operator*(int m) const;
|
Chris@0
|
100 RealTime operator/(int d) const;
|
Chris@0
|
101
|
Chris@378
|
102 RealTime operator*(double m) const;
|
Chris@378
|
103 RealTime operator/(double d) const;
|
Chris@378
|
104
|
Chris@350
|
105 /**
|
Chris@350
|
106 * Return the ratio of two times.
|
Chris@350
|
107 */
|
Chris@0
|
108 double operator/(const RealTime &r) const;
|
Chris@0
|
109
|
Chris@350
|
110 /**
|
Chris@350
|
111 * Return a human-readable debug-type string to full precision
|
Chris@350
|
112 * (probably not a format to show to a user directly). If align
|
Chris@350
|
113 * is true, prepend " " to the start of positive values so that
|
Chris@350
|
114 * they line up with negative ones (which start with "-").
|
Chris@350
|
115 */
|
Chris@121
|
116 std::string toString(bool align = false) const;
|
Chris@0
|
117
|
Chris@350
|
118 /**
|
Chris@350
|
119 * Convert a string as obtained from toString back to a RealTime
|
Chris@350
|
120 * object.
|
Chris@350
|
121 */
|
Chris@350
|
122 static RealTime fromString(std::string);
|
Chris@350
|
123
|
Chris@350
|
124 /**
|
Chris@350
|
125 * Return a user-readable string to the nearest millisecond, in a
|
Chris@350
|
126 * form like HH:MM:SS.mmm
|
Chris@350
|
127 */
|
Chris@0
|
128 std::string toText(bool fixedDp = false) const;
|
Chris@0
|
129
|
Chris@350
|
130 /**
|
Chris@612
|
131 * Return a user-readable string in which seconds are divided into
|
Chris@612
|
132 * frames (presumably at a lower frame rate than audio rate,
|
Chris@612
|
133 * e.g. 24 or 25 video frames), in a form like HH:MM:SS:FF. fps
|
Chris@612
|
134 * gives the number of frames per second, and must be integral
|
Chris@612
|
135 * (29.97 not supported).
|
Chris@612
|
136 */
|
Chris@612
|
137 std::string toFrameText(int fps) const;
|
Chris@612
|
138
|
Chris@612
|
139 /**
|
Chris@350
|
140 * Return a user-readable string to the nearest second, in a form
|
Chris@350
|
141 * like "6s" (for less than a minute) or "2:21" (for more).
|
Chris@350
|
142 */
|
Chris@247
|
143 std::string toSecText() const;
|
Chris@247
|
144
|
Chris@350
|
145 /**
|
Chris@494
|
146 * Return a string in xsd:duration format.
|
Chris@494
|
147 */
|
Chris@494
|
148 std::string toXsdDuration() const;
|
Chris@494
|
149
|
Chris@494
|
150 /**
|
Chris@350
|
151 * Convert a RealTime into a sample frame at the given sample rate.
|
Chris@350
|
152 */
|
Chris@1038
|
153 static sv_frame_t realTime2Frame(const RealTime &r, int sampleRate);
|
Chris@350
|
154
|
Chris@350
|
155 /**
|
Chris@350
|
156 * Convert a sample frame at the given sample rate into a RealTime.
|
Chris@350
|
157 */
|
Chris@1038
|
158 static RealTime frame2RealTime(sv_frame_t frame, int sampleRate);
|
Chris@0
|
159
|
Chris@0
|
160 static const RealTime zeroTime;
|
Chris@0
|
161 };
|
Chris@0
|
162
|
Chris@0
|
163 std::ostream &operator<<(std::ostream &out, const RealTime &rt);
|
Chris@0
|
164
|
Chris@0
|
165 #endif
|