libs/ardour/ardour/broadcast_info.h

   1 /*
   2     Copyright (C) 2008 Paul Davis
   3     Author: Sakari Bergen
   4
   5     This program is free software; you can redistribute it and/or modify
   6     it under the terms of the GNU General Public License as published by
   7     the Free Software Foundation; either version 2 of the License, or
   8     (at your option) any later version.
   9
  10     This program is distributed in the hope that it will be useful,
  11     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13     GNU General Public License for more details.
  14
  15     You should have received a copy of the GNU General Public License
  16     along with this program; if not, write to the Free Software
  17     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  18
  19 */
  20
  21 #ifndef __ardour_broadcast_info_h__
  22 #define __ardour_broadcast_info_h__
  23
  24 #include <string>
  25 #include <ctime>
  26
  27 #include <sndfile.h>
  28
  29 #include "ardour/types.h"
  30
  31 namespace ARDOUR
  32 {
  33
  34 class Session;
  35
  36 class BroadcastInfo
  37 {
  38   public:
  39
  40         /// Construct empty broadcast info
  41         BroadcastInfo ();
  42         ~BroadcastInfo ();
  43
  44         /// Returns last error sring from libsndfile
  45         std::string get_error () const { return error; }
  46
  47         /* Convenience functions */
  48
  49         void set_from_session (Session const & session, int64_t time_ref);
  50
  51         /* Reading */
  52
  53         bool load_from_file (std::string const & filename);
  54         bool load_from_file (SNDFILE* sf);
  55
  56         std::string get_description () const;
  57         int64_t get_time_reference () const;
  58         struct tm get_origination_time () const;
  59         std::string get_originator () const;
  60         std::string get_originator_ref () const;
  61
  62         /* Writing */
  63
  64         bool write_to_file (std::string const & filename);
  65         bool write_to_file (SNDFILE* sf);
  66
  67         void set_description (std::string const & desc);
  68         void set_time_reference (int64_t when);
  69         void set_origination_time (struct tm * now = 0); // if 0, use time generated at construction
  70         void set_originator (std::string const & str = "");
  71         void set_originator_ref (Session const &, std::string const & str = "");
  72
  73         /* State info */
  74
  75         /// Returns true if a info has been succesfully loaded or anything has been manually set
  76         bool has_info () const { return _has_info; }
  77
  78   private:
  79
  80         SF_BROADCAST_INFO * info;
  81         struct tm _time;
  82
  83         void update_error ();
  84         std::string error;
  85
  86         bool _has_info;
  87 };
  88
  89
  90
  91 } // namespace ARDOUR
  92
  93 #endif /* __ardour_broadcast_info_h__ */