X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fdcp_time.h;h=1221fb328a33168f2aa73a22e2201f960e30e441;hb=9e523d8a4062ad52330dff6c2ba50e54184c9bb2;hp=1b73e3e8bc96f72655f721f4ce40cf75058b60b3;hpb=c2bac22380bea453665a24c6f39200a977771daf;p=libdcp.git diff --git a/src/dcp_time.h b/src/dcp_time.h index 1b73e3e8..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,53 +18,66 @@ */ /** @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 from a frame index (starting from 0) - * and a frames per second count. + /** 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); + Time (int frame, int frames_per_second, int tcr); - /** Construct a Time from hours, minutes, seconds and ticks. + /** Construct a Time from hours, minutes, seconds, editable units and a timecode rate. * @param h_ Hours. * @param m_ Minutes. * @param s_ Seconds. - * @param t_ Ticks (where 1 tick is 4 milliseconds). + * @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 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_) {} - Time (std::string time); + Time (double seconds); + + Time (std::string time, int tcr); - int h; ///< hours - int m; ///< minutes - int s; ///< seconds - int t; ///< `ticks', where 1 tick is 4 milliseconds + 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 to_string () const; - int64_t to_ticks () const; + 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); + void set (double seconds, int tcr); }; extern bool operator== (Time const & a, Time const & b); @@ -72,9 +85,10 @@ 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 const & b); -extern Time operator- (Time a, Time const & b); +extern Time operator+ (Time a, Time b); +extern Time operator- (Time a, Time b); extern float operator/ (Time a, Time const & b); }