annotate base/RealTime.h @ 247:21b9b25bff48

* More useful status bar text -- show the current play time and the extents of the visible area * Add update-i18n.sh to update the i18n/ts and qm files -- I can't get qmake to do the right thing now that the project file has been split up into several project files * Fix missing Q_OBJECTs, etc, reported by lupdate * Update Russian translation from AlexandrE
author Chris Cannam
date Wed, 07 Mar 2007 17:07:02 +0000
parents 146eb9e35baa
children d7c41483af8f 94fc0591ea43
rev   line source
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@0 24 #include <iostream>
Chris@0 25 #include <string>
Chris@0 26
Chris@26 27 struct timeval;
Chris@26 28
Chris@26 29
Chris@0 30 /**
Chris@0 31 * RealTime represents time values to nanosecond precision
Chris@0 32 * with accurate arithmetic and frame-rate conversion functions.
Chris@0 33 */
Chris@0 34
Chris@0 35 struct RealTime
Chris@0 36 {
Chris@0 37 int sec;
Chris@0 38 int nsec;
Chris@0 39
Chris@0 40 int usec() const { return nsec / 1000; }
Chris@0 41 int msec() const { return nsec / 1000000; }
Chris@0 42
Chris@0 43 RealTime(): sec(0), nsec(0) {}
Chris@0 44 RealTime(int s, int n);
Chris@0 45
Chris@0 46 RealTime(const RealTime &r) :
Chris@0 47 sec(r.sec), nsec(r.nsec) { }
Chris@0 48
Chris@26 49 static RealTime fromSeconds(double sec);
Chris@26 50 static RealTime fromMilliseconds(int msec);
Chris@26 51 static RealTime fromTimeval(const struct timeval &);
Chris@26 52
Chris@0 53 RealTime &operator=(const RealTime &r) {
Chris@0 54 sec = r.sec; nsec = r.nsec; return *this;
Chris@0 55 }
Chris@0 56
Chris@0 57 RealTime operator+(const RealTime &r) const {
Chris@0 58 return RealTime(sec + r.sec, nsec + r.nsec);
Chris@0 59 }
Chris@0 60 RealTime operator-(const RealTime &r) const {
Chris@0 61 return RealTime(sec - r.sec, nsec - r.nsec);
Chris@0 62 }
Chris@0 63 RealTime operator-() const {
Chris@0 64 return RealTime(-sec, -nsec);
Chris@0 65 }
Chris@0 66
Chris@0 67 bool operator <(const RealTime &r) const {
Chris@0 68 if (sec == r.sec) return nsec < r.nsec;
Chris@0 69 else return sec < r.sec;
Chris@0 70 }
Chris@0 71
Chris@0 72 bool operator >(const RealTime &r) const {
Chris@0 73 if (sec == r.sec) return nsec > r.nsec;
Chris@0 74 else return sec > r.sec;
Chris@0 75 }
Chris@0 76
Chris@0 77 bool operator==(const RealTime &r) const {
Chris@0 78 return (sec == r.sec && nsec == r.nsec);
Chris@0 79 }
Chris@0 80
Chris@0 81 bool operator!=(const RealTime &r) const {
Chris@0 82 return !(r == *this);
Chris@0 83 }
Chris@0 84
Chris@0 85 bool operator>=(const RealTime &r) const {
Chris@0 86 if (sec == r.sec) return nsec >= r.nsec;
Chris@0 87 else return sec >= r.sec;
Chris@0 88 }
Chris@0 89
Chris@0 90 bool operator<=(const RealTime &r) const {
Chris@0 91 if (sec == r.sec) return nsec <= r.nsec;
Chris@0 92 else return sec <= r.sec;
Chris@0 93 }
Chris@0 94
Chris@183 95 RealTime operator*(int m) const;
Chris@0 96 RealTime operator/(int d) const;
Chris@0 97
Chris@0 98 // Find the fractional difference between times
Chris@0 99 //
Chris@0 100 double operator/(const RealTime &r) const;
Chris@0 101
Chris@0 102 // Return a human-readable debug-type string to full precision
Chris@121 103 // (probably not a format to show to a user directly). If align
Chris@121 104 // is true, prepend " " to the start of positive values so that
Chris@121 105 // they line up with negative ones (which start with "-").
Chris@0 106 //
Chris@121 107 std::string toString(bool align = false) const;
Chris@0 108
Chris@0 109 // Return a user-readable string to the nearest millisecond
Chris@0 110 // in a form like HH:MM:SS.mmm
Chris@0 111 //
Chris@0 112 std::string toText(bool fixedDp = false) const;
Chris@0 113
Chris@247 114 // Return a user-readable string to the nearest second in a form
Chris@247 115 // like "6s" (for less than a minute) or "2:21" (for more).
Chris@247 116 //
Chris@247 117 std::string toSecText() const;
Chris@247 118
Chris@0 119 // Convenience functions for handling sample frames
Chris@0 120 //
Chris@0 121 static long realTime2Frame(const RealTime &r, unsigned int sampleRate);
Chris@0 122 static RealTime frame2RealTime(long frame, unsigned int sampleRate);
Chris@0 123
Chris@0 124 static const RealTime zeroTime;
Chris@0 125 };
Chris@0 126
Chris@0 127 std::ostream &operator<<(std::ostream &out, const RealTime &rt);
Chris@0 128
Chris@0 129 #endif