libs/ardour/ardour/export_format_specification.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_export_format_specification_h__
  22 #define __ardour_export_format_specification_h__
  23
  24 #include <string>
  25
  26 #include "pbd/uuid.h"
  27
  28 #include "ardour/libardour_visibility.h"
  29 #include "ardour/types.h"
  30 #include "ardour/export_format_base.h"
  31
  32 class XMLNode;
  33
  34 namespace ARDOUR
  35 {
  36
  37 class ExportFormat;
  38 class ExportFormatCompatibility;
  39 class Session;
  40
  41 class LIBARDOUR_API ExportFormatSpecification : public ExportFormatBase {
  42
  43   private:
  44
  45         /* Time struct for keeping time formats as close as possible to what was requested */
  46
  47         struct Time : public AnyTime {
  48                 Time (Session & session) : AnyTime (), session (session) {}
  49                 Time & operator= (AnyTime const & other);
  50
  51                 framecnt_t get_frames_at (framepos_t position, framecnt_t target_rate) const;
  52
  53                 /* Serialization */
  54
  55                 XMLNode & get_state ();
  56                 int set_state (const XMLNode & node);
  57
  58           private:
  59                 Session & session;
  60         };
  61
  62   private:
  63         friend class ExportElementFactory;
  64         explicit ExportFormatSpecification (Session & s);
  65         ExportFormatSpecification (Session & s, XMLNode const & state);
  66
  67   public:
  68         ExportFormatSpecification (ExportFormatSpecification const & other, bool modify_name = true);
  69         ~ExportFormatSpecification ();
  70
  71         /* compatibility */
  72
  73         bool is_compatible_with (ExportFormatCompatibility const & compatibility) const;
  74         bool is_complete () const;
  75
  76         /* Modifying functions */
  77
  78         void set_format (boost::shared_ptr<ExportFormat> format);
  79
  80         void set_name (std::string const & name) { _name = name; }
  81
  82         void set_type (Type type) { _type = type; }
  83         void set_format_id (FormatId value) { format_ids.clear(); format_ids.insert (value); }
  84         void set_endianness (Endianness value) { endiannesses.clear(); endiannesses.insert (value); }
  85         void set_sample_format (SampleFormat value) { sample_formats.clear(); sample_formats.insert (value); }
  86         void set_sample_rate (SampleRate value) { sample_rates.clear(); sample_rates.insert (value); }
  87         void set_quality (Quality value) { qualities.clear(); qualities.insert (value); }
  88
  89         void set_dither_type (DitherType value) { _dither_type = value; }
  90         void set_src_quality (SRCQuality value) { _src_quality = value; }
  91         void set_trim_beginning (bool value) { _trim_beginning = value; }
  92         void set_trim_end (bool value) { _trim_end = value; }
  93         void set_normalize (bool value) { _normalize = value; }
  94         void set_normalize_loudness (bool value) { _normalize_loudness = value; }
  95         void set_normalize_dbfs (float value) { _normalize_dbfs = value; }
  96         void set_normalize_lufs (float value) { _normalize_lufs = value; }
  97         void set_normalize_dbtp (float value) { _normalize_dbtp = value; }
  98
  99         void set_tag (bool tag_it) { _tag = tag_it; }
 100         void set_with_cue (bool yn) { _with_cue = yn; }
 101         void set_with_toc (bool yn) { _with_toc = yn; }
 102         void set_with_mp4chaps (bool yn) { _with_mp4chaps = yn; }
 103         void set_soundcloud_upload (bool yn) { _soundcloud_upload = yn; }
 104         void set_command (std::string command) { _command = command; }
 105         void set_analyse (bool yn) { _analyse = yn; }
 106
 107         void set_silence_beginning (AnyTime const & value) { _silence_beginning = value; }
 108         void set_silence_end (AnyTime const & value) { _silence_end = value; }
 109
 110         /* Accessing functions */
 111
 112         PBD::UUID const & id () { return _id; }
 113         std::string const & name () const { return _name; }
 114         std::string description (bool include_name = true);
 115
 116         bool has_broadcast_info () const { return _has_broadcast_info; }
 117         uint32_t channel_limit () const { return _channel_limit; }
 118         std::string format_name () const { return _format_name; }
 119
 120         Type type () const { return _type; }
 121
 122         FormatId format_id () const {
 123                 if (!format_ids.empty() )
 124                         return *format_ids.begin();
 125                 else
 126                         return FormatId(0);
 127         }
 128
 129         Endianness endianness () const {
 130                 if (!endiannesses.empty() )
 131                         return *endiannesses.begin();
 132                 else
 133                         return Endianness(0);
 134         }
 135
 136         SampleFormat sample_format () const {
 137                 if (!sample_formats.empty() )
 138                         return *sample_formats.begin();
 139                 else
 140                         return SampleFormat(0);
 141         }
 142
 143         SampleRate sample_rate () const {
 144                 if (!sample_rates.empty() )
 145                         return *sample_rates.begin();
 146                 else
 147                         return SampleRate(0);
 148
 149         }
 150
 151         Quality quality () const {
 152                 if (!qualities.empty() )
 153                         return *qualities.begin();
 154                 else
 155                         return Quality(0);
 156         }
 157
 158         DitherType dither_type () const { return _dither_type; }
 159         SRCQuality src_quality () const { return _src_quality; }
 160         bool trim_beginning () const { return _trim_beginning; }
 161         bool trim_end () const { return _trim_end; }
 162         bool normalize () const { return _normalize; }
 163         bool normalize_loudness () const { return _normalize_loudness; }
 164         float normalize_dbfs () const { return _normalize_dbfs; }
 165         float normalize_lufs () const { return _normalize_lufs; }
 166         float normalize_dbtp () const { return _normalize_dbtp; }
 167         bool with_toc() const { return _with_toc; }
 168         bool with_cue() const { return _with_cue; }
 169         bool with_mp4chaps() const { return _with_mp4chaps; }
 170
 171         bool soundcloud_upload() const { return _soundcloud_upload; }
 172         std::string command() const { return _command; }
 173         bool analyse() const { return _analyse; }
 174
 175         bool tag () const { return _tag && supports_tagging; }
 176
 177         framecnt_t silence_beginning_at (framepos_t position, framecnt_t samplerate) const
 178                 { return _silence_beginning.get_frames_at (position, samplerate); }
 179         framecnt_t silence_end_at (framepos_t position, framecnt_t samplerate) const
 180                 { return _silence_end.get_frames_at (position, samplerate); }
 181
 182         AnyTime silence_beginning_time () const { return _silence_beginning; }
 183         AnyTime silence_end_time () const { return _silence_end; }
 184
 185         /* Serialization */
 186
 187         XMLNode & get_state ();
 188         int set_state (const XMLNode & root);
 189
 190
 191   private:
 192
 193         Session &        session;
 194
 195         /* The variables below do not have setters (usually set via set_format) */
 196
 197         std::string  _format_name;
 198         bool            has_sample_format;
 199         bool            supports_tagging;
 200         bool           _has_broadcast_info;
 201         uint32_t       _channel_limit;
 202
 203         /* The variables below have getters and setters */
 204
 205         std::string   _name;
 206         PBD::UUID       _id;
 207
 208         Type            _type;
 209         DitherType      _dither_type;
 210         SRCQuality      _src_quality;
 211
 212         bool            _tag;
 213
 214         bool            _trim_beginning;
 215         Time            _silence_beginning;
 216         bool            _trim_end;
 217         Time            _silence_end;
 218
 219         bool            _normalize;
 220         bool            _normalize_loudness;
 221         float           _normalize_dbfs;
 222         float           _normalize_lufs;
 223         float           _normalize_dbtp;
 224         bool            _with_toc;
 225         bool            _with_cue;
 226         bool            _with_mp4chaps;
 227         bool            _soundcloud_upload;
 228
 229         std::string     _command;
 230         bool            _analyse;
 231
 232         /* serialization helpers */
 233
 234         void add_option (XMLNode * node, std::string const & name, std::string const & value);
 235         std::string get_option (XMLNode const * node, std::string const & name);
 236
 237 };
 238
 239 } // namespace ARDOUR
 240
 241 #endif /* __ardour_export_format_specification_h__ */