2 Copyright (C) 2008 Paul Davis
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.
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.
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.
21 #include "ardour/export_format_specification.h"
25 #include "ardour/export_format_compatibility.h"
26 #include "ardour/export_formats.h"
27 #include "ardour/session.h"
29 #include "pbd/error.h"
30 #include "pbd/xml++.h"
31 #include "pbd/enumwriter.h"
32 #include "pbd/convert.h"
43 ExportFormatSpecification::Time &
44 ExportFormatSpecification::Time::operator= (AnyTime const & other)
46 static_cast<AnyTime &>(*this) = other;
51 ExportFormatSpecification::Time::get_frames_at (framepos_t position, framecnt_t target_rate) const
53 framecnt_t duration = session.any_duration_to_frames (position, *this);
54 return ((double) target_rate / session.frame_rate()) * duration + 0.5;
58 ExportFormatSpecification::Time::get_state ()
61 XMLNode * node = new XMLNode ("Duration");
63 node->add_property ("format", enum_2_string (type));
67 node->add_property ("hours", to_string (timecode.hours, std::dec));
68 node->add_property ("minutes", to_string (timecode.minutes, std::dec));
69 node->add_property ("seconds", to_string (timecode.seconds, std::dec));
70 node->add_property ("frames", to_string (timecode.frames, std::dec));
73 node->add_property ("bars", to_string (bbt.bars, std::dec));
74 node->add_property ("beats", to_string (bbt.beats, std::dec));
75 node->add_property ("ticks", to_string (bbt.ticks, std::dec));
78 node->add_property ("frames", to_string (frames, std::dec));
81 node->add_property ("seconds", to_string (seconds, std::dec));
89 ExportFormatSpecification::Time::set_state (const XMLNode & node)
91 XMLProperty const * prop;
93 prop = node.property ("format");
95 if (!prop) { return -1; }
97 type = (Type) string_2_enum (prop->value(), Type);
101 if ((prop = node.property ("hours"))) {
102 timecode.hours = atoi (prop->value());
105 if ((prop = node.property ("minutes"))) {
106 timecode.minutes = atoi (prop->value());
109 if ((prop = node.property ("seconds"))) {
110 timecode.seconds = atoi (prop->value());
113 if ((prop = node.property ("frames"))) {
114 timecode.frames = atoi (prop->value());
120 if ((prop = node.property ("bars"))) {
121 bbt.bars = atoi (prop->value());
124 if ((prop = node.property ("beats"))) {
125 bbt.beats = atoi (prop->value());
128 if ((prop = node.property ("ticks"))) {
129 bbt.ticks = atoi (prop->value());
135 if ((prop = node.property ("frames"))) {
136 std::istringstream iss (prop->value());
143 if ((prop = node.property ("seconds"))) {
144 seconds = atof (prop->value());
153 ExportFormatSpecification::ExportFormatSpecification (Session & s)
156 , has_sample_format (false)
157 , supports_tagging (false)
158 , _has_broadcast_info (false)
160 , _dither_type (D_None)
161 , _src_quality (SRC_SincBest)
164 , _trim_beginning (false)
165 , _silence_beginning (s)
170 , _normalize_loudness (false)
171 , _normalize_dbfs (GAIN_COEFF_UNITY)
172 , _normalize_lufs (-23)
173 , _normalize_dbtp (-1)
176 , _with_mp4chaps (false)
177 , _soundcloud_upload (false)
181 format_ids.insert (F_None);
182 endiannesses.insert (E_FileDefault);
183 sample_formats.insert (SF_None);
184 sample_rates.insert (SR_None);
185 qualities.insert (Q_None);
188 ExportFormatSpecification::ExportFormatSpecification (Session & s, XMLNode const & state)
191 , has_sample_format (false)
192 , supports_tagging (false)
193 , _has_broadcast_info (false)
195 , _dither_type (D_None)
196 , _src_quality (SRC_SincBest)
199 , _trim_beginning (false)
200 , _silence_beginning (s)
205 , _normalize_loudness (false)
206 , _normalize_dbfs (GAIN_COEFF_UNITY)
207 , _normalize_lufs (-23)
208 , _normalize_dbtp (-1)
211 , _with_mp4chaps (false)
212 , _soundcloud_upload (false)
216 _silence_beginning.type = Time::Timecode;
217 _silence_end.type = Time::Timecode;
222 ExportFormatSpecification::ExportFormatSpecification (ExportFormatSpecification const & other, bool modify_name)
223 : ExportFormatBase(other)
224 , session (other.session)
225 , _silence_beginning (other.session)
226 , _silence_end (other.session)
227 , _soundcloud_upload (false)
228 , _analyse (other._analyse)
231 set_name (other.name() + " (copy)");
233 set_name (other.name());
236 _format_name = other._format_name;
237 has_sample_format = other.has_sample_format;
239 supports_tagging = other.supports_tagging;
240 _has_broadcast_info = other._has_broadcast_info;
241 _channel_limit = other._channel_limit;
243 set_type (other.type());
244 set_format_id (other.format_id());
245 set_endianness (other.endianness());
246 set_sample_format (other.sample_format());
247 set_sample_rate (other.sample_rate());
248 set_quality (other.quality());
250 set_dither_type (other.dither_type());
251 set_src_quality (other.src_quality());
252 set_trim_beginning (other.trim_beginning());
253 set_trim_end (other.trim_end());
254 set_normalize (other.normalize());
255 set_normalize_loudness (other.normalize_loudness());
256 set_normalize_dbfs (other.normalize_dbfs());
257 set_normalize_lufs (other.normalize_lufs());
258 set_normalize_dbtp (other.normalize_dbtp());
260 set_tag (other.tag());
262 set_silence_beginning (other.silence_beginning_time());
263 set_silence_end (other.silence_end_time());
265 set_extension(other.extension());
268 ExportFormatSpecification::~ExportFormatSpecification ()
273 ExportFormatSpecification::get_state ()
277 XMLNode * root = new XMLNode ("ExportFormatSpecification");
279 root->add_property ("name", _name);
280 root->add_property ("id", _id.to_s());
281 root->add_property ("with-cue", _with_cue ? "true" : "false");
282 root->add_property ("with-toc", _with_toc ? "true" : "false");
283 root->add_property ("with-mp4chaps", _with_mp4chaps ? "true" : "false");
284 root->add_property ("command", _command);
285 root->add_property ("analyse", _analyse ? "true" : "false");
286 root->add_property ("soundcloud-upload", _soundcloud_upload ? "true" : "false");
288 node = root->add_child ("Encoding");
289 node->add_property ("id", enum_2_string (format_id()));
290 node->add_property ("type", enum_2_string (type()));
291 node->add_property ("extension", extension());
292 node->add_property ("name", _format_name);
293 node->add_property ("has-sample-format", has_sample_format ? "true" : "false");
294 node->add_property ("channel-limit", to_string (_channel_limit, std::dec));
296 node = root->add_child ("SampleRate");
297 node->add_property ("rate", to_string (sample_rate(), std::dec));
299 node = root->add_child ("SRCQuality");
300 node->add_property ("quality", enum_2_string (src_quality()));
302 XMLNode * enc_opts = root->add_child ("EncodingOptions");
304 add_option (enc_opts, "sample-format", enum_2_string (sample_format()));
305 add_option (enc_opts, "dithering", enum_2_string (dither_type()));
306 add_option (enc_opts, "tag-metadata", _tag ? "true" : "false");
307 add_option (enc_opts, "tag-support", supports_tagging ? "true" : "false");
308 add_option (enc_opts, "broadcast-info", _has_broadcast_info ? "true" : "false");
310 XMLNode * processing = root->add_child ("Processing");
312 node = processing->add_child ("Normalize");
313 node->add_property ("enabled", normalize() ? "true" : "false");
314 node->add_property ("loudness", normalize_loudness() ? "yes" : "no");
315 node->add_property ("dbfs", to_string (normalize_dbfs(), std::dec));
316 node->add_property ("lufs", to_string (normalize_lufs(), std::dec));
317 node->add_property ("dbtp", to_string (normalize_dbtp(), std::dec));
319 XMLNode * silence = processing->add_child ("Silence");
320 XMLNode * start = silence->add_child ("Start");
321 XMLNode * end = silence->add_child ("End");
323 node = start->add_child ("Trim");
324 node->add_property ("enabled", trim_beginning() ? "true" : "false");
326 node = start->add_child ("Add");
327 node->add_property ("enabled", _silence_beginning.not_zero() ? "true" : "false");
328 node->add_child_nocopy (_silence_beginning.get_state());
330 node = end->add_child ("Trim");
331 node->add_property ("enabled", trim_end() ? "true" : "false");
333 node = end->add_child ("Add");
334 node->add_property ("enabled", _silence_end.not_zero() ? "true" : "false");
335 node->add_child_nocopy (_silence_end.get_state());
341 ExportFormatSpecification::set_state (const XMLNode & root)
343 XMLProperty const * prop;
344 XMLNode const * child;
348 if ((prop = root.property ("name"))) {
349 _name = prop->value();
352 if ((prop = root.property ("id"))) {
356 if ((prop = root.property ("with-cue"))) {
357 _with_cue = string_is_affirmative (prop->value());
362 if ((prop = root.property ("with-toc"))) {
363 _with_toc = string_is_affirmative (prop->value());
368 if ((prop = root.property ("with-mp4chaps"))) {
369 _with_mp4chaps = string_is_affirmative (prop->value());
371 _with_mp4chaps = false;
374 if ((prop = root.property ("command"))) {
375 _command = prop->value();
380 if ((prop = root.property ("analyse"))) {
381 _analyse = string_is_affirmative (prop->value());
386 if ((prop = root.property ("soundcloud-upload"))) {
387 _soundcloud_upload = string_is_affirmative (prop->value());
389 _soundcloud_upload = false;
392 /* Encoding and SRC */
394 if ((child = root.child ("Encoding"))) {
395 if ((prop = child->property ("id"))) {
396 set_format_id ((FormatId) string_2_enum (prop->value(), FormatId));
399 if ((prop = child->property ("type"))) {
400 set_type ((Type) string_2_enum (prop->value(), Type));
403 if ((prop = child->property ("extension"))) {
404 set_extension (prop->value());
407 if ((prop = child->property ("name"))) {
408 _format_name = prop->value();
411 if ((prop = child->property ("has-sample-format"))) {
412 has_sample_format = string_is_affirmative (prop->value());
415 if ((prop = child->property ("has-sample-format"))) {
416 has_sample_format = string_is_affirmative (prop->value());
419 if ((prop = child->property ("channel-limit"))) {
420 _channel_limit = atoi (prop->value());
424 if ((child = root.child ("SampleRate"))) {
425 if ((prop = child->property ("rate"))) {
426 set_sample_rate ( (SampleRate) string_2_enum (prop->value(), SampleRate));
430 if ((child = root.child ("SRCQuality"))) {
431 if ((prop = child->property ("quality"))) {
432 _src_quality = (SRCQuality) string_2_enum (prop->value(), SRCQuality);
436 /* Encoding options */
438 if ((child = root.child ("EncodingOptions"))) {
439 set_sample_format ((SampleFormat) string_2_enum (get_option (child, "sample-format"), SampleFormat));
440 set_dither_type ((DitherType) string_2_enum (get_option (child, "dithering"), DitherType));
441 set_tag (!(get_option (child, "tag-metadata").compare ("true")));
442 supports_tagging = (!(get_option (child, "tag-support").compare ("true")));
443 _has_broadcast_info = (!(get_option (child, "broadcast-info").compare ("true")));
448 XMLNode const * proc = root.child ("Processing");
449 if (!proc) { std::cerr << X_("Could not load processing for export format") << std::endl; return -1; }
451 if ((child = proc->child ("Normalize"))) {
452 if ((prop = child->property ("enabled"))) {
453 _normalize = (!prop->value().compare ("true"));
456 // old formats before ~ 4.7-930ish
457 if ((prop = child->property ("target"))) {
458 _normalize_dbfs = atof (prop->value());
461 if ((prop = child->property ("loudness"))) {
462 _normalize_loudness = string_is_affirmative (prop->value());
465 if ((prop = child->property ("dbfs"))) {
466 _normalize_dbfs = atof (prop->value());
469 if ((prop = child->property ("lufs"))) {
470 _normalize_lufs = atof (prop->value());
473 if ((prop = child->property ("dbtp"))) {
474 _normalize_dbtp = atof (prop->value());
478 XMLNode const * silence = proc->child ("Silence");
479 if (!silence) { std::cerr << X_("Could not load silence for export format") << std::endl; return -1; }
481 XMLNode const * start = silence->child ("Start");
482 XMLNode const * end = silence->child ("End");
483 if (!start || !end) { std::cerr << X_("Could not load end or start silence for export format") << std::endl; return -1; }
487 if ((child = start->child ("Trim"))) {
488 if ((prop = child->property ("enabled"))) {
489 _trim_beginning = (!prop->value().compare ("true"));
493 if ((child = start->child ("Add"))) {
494 if ((prop = child->property ("enabled"))) {
495 if (!prop->value().compare ("true")) {
496 if ((child = child->child ("Duration"))) {
497 _silence_beginning.set_state (*child);
500 _silence_beginning.type = Time::Timecode;
507 if ((child = end->child ("Trim"))) {
508 if ((prop = child->property ("enabled"))) {
509 _trim_end = (!prop->value().compare ("true"));
513 if ((child = end->child ("Add"))) {
514 if ((prop = child->property ("enabled"))) {
515 if (!prop->value().compare ("true")) {
516 if ((child = child->child ("Duration"))) {
517 _silence_end.set_state (*child);
520 _silence_end.type = Time::Timecode;
529 ExportFormatSpecification::is_compatible_with (ExportFormatCompatibility const & compatibility) const
531 boost::shared_ptr<ExportFormatBase> intersection = get_intersection (compatibility);
533 if (intersection->formats_empty() && format_id() != 0) {
537 if (intersection->endiannesses_empty() && endianness() != E_FileDefault) {
541 if (intersection->sample_rates_empty() && sample_rate() != SR_None) {
545 if (intersection->sample_formats_empty() && sample_format() != SF_None) {
549 if (intersection->qualities_empty() && quality() != Q_None) {
557 ExportFormatSpecification::is_complete () const
559 if (type() == T_None) {
567 if (!sample_rate()) {
571 if (has_sample_format) {
572 if (sample_format() == SF_None) {
581 ExportFormatSpecification::set_format (boost::shared_ptr<ExportFormat> format)
584 set_format_id (format->get_format_id ());
585 set_type (format->get_type());
586 set_extension (format->extension());
588 if (format->get_explicit_sample_format()) {
589 set_sample_format (format->get_explicit_sample_format());
592 if (format->has_sample_format()) {
593 has_sample_format = true;
596 if (format->has_broadcast_info()) {
597 _has_broadcast_info = true;
600 supports_tagging = format->supports_tagging ();
601 _channel_limit = format->get_channel_limit();
603 _format_name = format->name();
605 set_format_id (F_None);
608 _has_broadcast_info = false;
609 has_sample_format = false;
610 supports_tagging = false;
617 ExportFormatSpecification::description (bool include_name)
619 list<string> components;
622 if (_normalize_loudness) {
623 components.push_back (_("normalize loudness"));
625 components.push_back (_("normalize peak"));
629 if (_trim_beginning && _trim_end) {
630 components.push_back ( _("trim"));
631 } else if (_trim_beginning) {
632 components.push_back (_("trim start"));
633 } else if (_trim_end) {
634 components.push_back (_("trim end"));
637 if (_format_name != "") {
638 components.push_back (_format_name);
641 if (has_sample_format) {
642 components.push_back (HasSampleFormat::get_sample_format_name (sample_format()));
645 switch (sample_rate()) {
647 components.push_back ("8 kHz");
650 components.push_back ("22,5 kHz");
653 components.push_back ("44,1 kHz");
656 components.push_back ("48 kHz");
659 components.push_back ("88,2 kHz");
662 components.push_back ("96 kHz");
665 components.push_back ("176.4 kHz");
668 components.push_back ("192 kHz");
671 components.push_back (_("Session rate"));
678 components.push_back ("TOC");
682 components.push_back ("CUE");
685 if (_with_mp4chaps) {
686 components.push_back ("MP4ch");
689 if (!_command.empty()) {
690 components.push_back ("+");
698 for (list<string>::const_iterator it = components.begin(); it != components.end(); ++it) {
699 if (it != components.begin()) { desc += ", "; }
706 ExportFormatSpecification::add_option (XMLNode * node, std::string const & name, std::string const & value)
708 node = node->add_child ("Option");
709 node->add_property ("name", name);
710 node->add_property ("value", value);
714 ExportFormatSpecification::get_option (XMLNode const * node, std::string const & name)
716 XMLNodeList list (node->children ("Option"));
718 for (XMLNodeList::iterator it = list.begin(); it != list.end(); ++it) {
719 XMLProperty const * prop = (*it)->property ("name");
720 if (prop && !name.compare (prop->value())) {
721 prop = (*it)->property ("value");
723 return prop->value();
728 std::cerr << "Could not load encoding option \"" << name << "\" for export format" << std::endl;
733 }; // namespace ARDOUR