X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fdcp_time.h;h=1221fb328a33168f2aa73a22e2201f960e30e441;hb=9e523d8a4062ad52330dff6c2ba50e54184c9bb2;hp=626cdacae1ddb3b4f0ef18249998e6a3436a1643;hpb=119c79e39b1da062334034940bdc0a98960bae0b;p=libdcp.git diff --git a/src/dcp_time.h b/src/dcp_time.h index 626cdaca..1221fb32 100644 --- a/src/dcp_time.h +++ b/src/dcp_time.h @@ -1,5 +1,5 @@ /* - Copyright (C) 2012 Carl Hetherington + Copyright (C) 2012-2015 Carl Hetherington This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -18,44 +18,78 @@ */ /** @file src/dcp_time.h - * @brief A representation of time within a DCP. + * @brief Time class. */ #ifndef LIBDCP_TIME_H #define LIBDCP_TIME_H -namespace libdcp { +#include +#include +#include + +namespace dcp { /** @class Time * @brief A representation of time within a DCP. */ - class Time { public: - Time () : h (0), m (0), s (0), t (0) {} + /** Construct a zero Time */ + Time () : h (0), m (0), s (0), e (0), tcr (1) {} + + /** Construct a Time. + * @param Frame index (starting from 0). + * @param frames_per_second Frames per second. + * @param tcr Timecode rate. + */ + Time (int frame, int frames_per_second, int tcr); - /** Construct a Time from a frame index (starting from 0) - * and a frames per second count. + /** Construct a Time from hours, minutes, seconds, editable units and a timecode rate. + * @param h_ Hours. + * @param m_ Minutes. + * @param s_ Seconds. + * @param e_ Editable units (where 1 editable unit is 1 / tcr_ seconds) + * @param tcr_ Timecode rate; i.e. number of editable units per second. */ - Time (int frame, int frames_per_second); - - Time (int h_, int m_, int s_, int t_) + Time (int h_, int m_, int s_, int e_, int tcr_) : h (h_) , m (m_) , s (s_) - , t (t_) + , e (e_) + , tcr (tcr_) {} - int h; ///< hours - int m; ///< minutes - int s; ///< seconds - int t; ///< `ticks', where 1 tick is 4 milliseconds + Time (double seconds); + + Time (std::string time, int tcr); + + int h; ///< hours + int m; ///< minutes + int s; ///< seconds + int e; ///< editable units (where 1 editable unit is 1 / tcr_ seconds) + int tcr; ///< timecode rate: the number of editable units per second. + + std::string as_string () const; + double as_seconds () const; + int64_t as_editable_units (int tcr_) const; + Time rebase (int tcr_) const; + +private: + void set (double seconds, int tcr); }; extern bool operator== (Time const & a, Time const & b); +extern bool operator!= (Time const & a, Time const & b); extern bool operator<= (Time const & a, Time const & b); +extern bool operator< (Time const & a, Time const & b); +extern bool operator> (Time const & a, Time const & b); +extern bool operator>= (Time const & a, Time const & b); extern std::ostream & operator<< (std::ostream & s, Time const & t); +extern Time operator+ (Time a, Time b); +extern Time operator- (Time a, Time b); +extern float operator/ (Time a, Time const & b); }