2 Copyright (C) 2002 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #include "ardour/automation_list.h"
27 #include "ardour/beats_frames_converter.h"
28 #include "ardour/event_type_map.h"
29 #include "ardour/parameter_descriptor.h"
30 #include "ardour/parameter_types.h"
31 #include "ardour/evoral_types_convert.h"
32 #include "ardour/types_convert.h"
33 #include "evoral/Curve.hpp"
34 #include "pbd/memento_command.h"
35 #include "pbd/stacktrace.h"
36 #include "pbd/enumwriter.h"
37 #include "pbd/types_convert.h"
42 using namespace ARDOUR;
45 PBD::Signal1<void,AutomationList *> AutomationList::AutomationListCreated;
48 static void dumpit (const AutomationList& al, string prefix = "")
50 cerr << prefix << &al << endl;
51 for (AutomationList::const_iterator i = al.begin(); i != al.end(); ++i) {
52 cerr << prefix << '\t' << (*i)->when << ',' << (*i)->value << endl;
57 AutomationList::AutomationList (const Evoral::Parameter& id, const Evoral::ParameterDescriptor& desc)
58 : ControlList(id, desc)
62 g_atomic_int_set (&_touching, 0);
63 _interpolation = default_interpolation ();
65 create_curve_if_necessary();
67 assert(_parameter.type() != NullAutomation);
68 AutomationListCreated(this);
71 AutomationList::AutomationList (const Evoral::Parameter& id)
72 : ControlList(id, ARDOUR::ParameterDescriptor(id))
76 g_atomic_int_set (&_touching, 0);
77 _interpolation = default_interpolation ();
79 create_curve_if_necessary();
81 assert(_parameter.type() != NullAutomation);
82 AutomationListCreated(this);
85 AutomationList::AutomationList (const AutomationList& other)
87 , StatefulDestructible()
90 _state = other._state;
91 g_atomic_int_set (&_touching, other.touching());
93 create_curve_if_necessary();
95 assert(_parameter.type() != NullAutomation);
96 AutomationListCreated(this);
99 AutomationList::AutomationList (const AutomationList& other, double start, double end)
100 : ControlList(other, start, end)
103 _state = other._state;
104 g_atomic_int_set (&_touching, other.touching());
106 create_curve_if_necessary();
108 assert(_parameter.type() != NullAutomation);
109 AutomationListCreated(this);
112 /** @param id is used for legacy sessions where the type is not present
113 * in or below the AutomationList node. It is used if @param id is non-null.
115 AutomationList::AutomationList (const XMLNode& node, Evoral::Parameter id)
116 : ControlList(id, ARDOUR::ParameterDescriptor(id))
119 g_atomic_int_set (&_touching, 0);
120 _interpolation = default_interpolation ();
123 set_state (node, Stateful::loading_state_version);
129 create_curve_if_necessary();
131 assert(_parameter.type() != NullAutomation);
132 AutomationListCreated(this);
135 AutomationList::~AutomationList()
140 boost::shared_ptr<Evoral::ControlList>
141 AutomationList::create(const Evoral::Parameter& id,
142 const Evoral::ParameterDescriptor& desc)
144 return boost::shared_ptr<Evoral::ControlList>(new AutomationList(id, desc));
148 AutomationList::create_curve_if_necessary()
150 switch (_parameter.type()) {
153 case PanAzimuthAutomation:
154 case PanElevationAutomation:
155 case PanWidthAutomation:
156 case FadeInAutomation:
157 case FadeOutAutomation:
158 case EnvelopeAutomation:
165 WritePassStarted.connect_same_thread (_writepass_connection, boost::bind (&AutomationList::snapshot_history, this, false));
169 AutomationList::operator= (const AutomationList& other)
171 if (this != &other) {
172 ControlList::freeze ();
173 /* ControlList::operator= calls copy_events() which calls
174 * mark_dirty() and maybe_signal_changed()
176 ControlList::operator= (other);
177 _state = other._state;
178 _touching = other._touching;
179 ControlList::thaw ();
186 AutomationList::maybe_signal_changed ()
188 ControlList::maybe_signal_changed ();
190 if (!ControlList::frozen()) {
191 StateChanged (); /* EMIT SIGNAL */
196 AutomationList::set_automation_state (AutoState s)
202 if (s == Write && _desc.toggled) {
203 snapshot_history (true);
205 automation_state_changed (s); /* EMIT SIGNAL */
208 Evoral::ControlList::InterpolationStyle
209 AutomationList::default_interpolation () const
211 switch (_parameter.type()) {
214 case EnvelopeAutomation:
215 #ifndef XXX_NEW_INTERPOLATON__BREAK_SESSION_FORMAT_XXX
216 /* use old, wrong linear gain interpolation */
217 return ControlList::Linear;
219 return ControlList::Exponential;
222 return ControlList::Logarithmic;
227 /* based on Evoral::ParameterDescriptor log,toggle,.. */
228 return ControlList::default_interpolation ();
232 AutomationList::start_write_pass (double when)
234 snapshot_history (true);
235 ControlList::start_write_pass (when);
239 AutomationList::write_pass_finished (double when, double thinning_factor)
241 ControlList::write_pass_finished (when, thinning_factor);
245 AutomationList::start_touch (double when)
247 if (_state == Touch) {
248 start_write_pass (when);
251 g_atomic_int_set (&_touching, 1);
255 AutomationList::stop_touch (double)
257 if (g_atomic_int_get (&_touching) == 0) {
258 /* this touch has already been stopped (probably by Automatable::transport_stopped),
259 so we've nothing to do.
264 g_atomic_int_set (&_touching, 0);
267 /* _before may be owned by the undo stack,
268 * so we have to be careful about doing this.
270 * ::before () transfers ownership, setting _before to 0
273 AutomationList::clear_history ()
280 AutomationList::snapshot_history (bool need_lock)
282 if (!in_new_write_pass ()) {
286 _before = &state (true, need_lock);
291 AutomationList::thaw ()
295 if (_changed_when_thawed) {
296 _changed_when_thawed = false;
297 StateChanged(); /* EMIT SIGNAL */
302 AutomationList::paste (const ControlList& alist, double pos, DoubleBeatsFramesConverter const& bfc)
304 AutomationType src_type = (AutomationType)alist.parameter().type();
305 AutomationType dst_type = (AutomationType)_parameter.type();
307 if (parameter_is_midi (src_type) == parameter_is_midi (dst_type)) {
308 return ControlList::paste (alist, pos);
310 bool to_frame = parameter_is_midi (src_type);
312 ControlList cl (alist);
314 for (const_iterator i = alist.begin ();i != alist.end (); ++i) {
315 double when = (*i)->when;
317 when = bfc.to ((*i)->when);
319 when = bfc.from ((*i)->when);
321 cl.fast_simple_add (when, (*i)->value);
323 return ControlList::paste (cl, pos);
327 AutomationList::memento_command (XMLNode* before, XMLNode* after)
329 return new MementoCommand<AutomationList> (*this, before, after);
333 AutomationList::get_state ()
335 return state (true, true);
339 AutomationList::state (bool full, bool need_lock)
341 XMLNode* root = new XMLNode (X_("AutomationList"));
343 root->set_property ("automation-id", EventTypeMap::instance().to_symbol(_parameter));
344 root->set_property ("id", id());
346 #ifndef XXX_NEW_INTERPOLATON__BREAK_SESSION_FORMAT_XXX
347 /* force new enums to existing ones in session-file */
348 Evoral::ControlList::InterpolationStyle is = _interpolation;
350 case ControlList::Exponential:
351 case ControlList::Logarithmic:
352 is = ControlList::Linear;
357 root->set_property ("interpolation-style", is);
359 root->set_property ("interpolation-style", _interpolation);
363 /* never serialize state with Write enabled - too dangerous
366 if (_state != Write) {
367 root->set_property ("state", _state);
369 if (_events.empty ()) {
370 root->set_property ("state", Off);
372 root->set_property ("state", Touch);
376 /* never save anything but Off for automation state to a template */
377 root->set_property ("state", Off);
380 if (!_events.empty()) {
381 root->add_child_nocopy (serialize_events (need_lock));
388 AutomationList::serialize_events (bool need_lock)
390 XMLNode* node = new XMLNode (X_("events"));
393 Glib::Threads::RWLock::ReaderLock lm (Evoral::ControlList::_lock, Glib::Threads::NOT_LOCK);
397 for (iterator xx = _events.begin(); xx != _events.end(); ++xx) {
398 str << PBD::to_string ((*xx)->when);
400 str << PBD::to_string ((*xx)->value);
404 /* XML is a bit wierd */
406 XMLNode* content_node = new XMLNode (X_("foo")); /* it gets renamed by libxml when we set content */
407 content_node->set_content (str.str());
409 node->add_child_nocopy (*content_node);
415 AutomationList::deserialize_events (const XMLNode& node)
417 if (node.children().empty()) {
421 XMLNode* content_node = node.children().front();
423 if (content_node->content().empty()) {
427 ControlList::freeze ();
430 stringstream str (content_node->content());
440 if (!str || !PBD::string_to<double> (x_str, x)) {
444 if (!str || !PBD::string_to<double> (y_str, y)) {
448 y = std::min ((double)_desc.upper, std::max ((double)_desc.lower, y));
449 fast_simple_add (x, y);
454 error << _("automation list: cannot load coordinates from XML, all points ignored") << endmsg;
457 maybe_signal_changed ();
466 AutomationList::set_state (const XMLNode& node, int version)
468 XMLNodeList nlist = node.children();
470 XMLNodeIterator niter;
472 if (node.name() == X_("events")) {
473 /* partial state setting*/
474 return deserialize_events (node);
477 if (node.name() == X_("Envelope") || node.name() == X_("FadeOut") || node.name() == X_("FadeIn")) {
479 if ((nsos = node.child (X_("AutomationList")))) {
480 /* new school in old school clothing */
481 return set_state (*nsos, version);
486 const XMLNodeList& elist = node.children();
487 XMLNodeConstIterator i;
489 ControlList::freeze ();
492 for (i = elist.begin(); i != elist.end(); ++i) {
495 if (!(*i)->get_property ("x", x)) {
496 error << _("automation list: no x-coordinate stored for control point (point ignored)") << endmsg;
501 if (!(*i)->get_property ("y", y)) {
502 error << _("automation list: no y-coordinate stored for control point (point ignored)") << endmsg;
506 y = std::min ((double)_desc.upper, std::max ((double)_desc.lower, y));
507 fast_simple_add (x, y);
515 if (node.name() != X_("AutomationList") ) {
516 error << string_compose (_("AutomationList: passed XML node called %1, not \"AutomationList\" - ignored"), node.name()) << endmsg;
521 /* update session AL list */
522 AutomationListCreated(this);
526 if (node.get_property (X_("automation-id"), value)) {
527 _parameter = EventTypeMap::instance().from_symbol(value);
529 warning << "Legacy session: automation list has no automation-id property." << endmsg;
532 if (!node.get_property (X_("interpolation-style"), _interpolation)) {
533 _interpolation = default_interpolation ();
535 #ifndef XXX_NEW_INTERPOLATON__BREAK_SESSION_FORMAT_XXX
536 /* internally force logarithmic and Trim params to use Log-scale */
537 if (_desc.logarithmic || _parameter.type() == TrimAutomation) {
538 _interpolation = ControlList::Logarithmic;
542 if (node.get_property (X_("state"), _state)) {
543 if (_state == Write) {
546 automation_state_changed (_state);
551 bool have_events = false;
553 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
554 if ((*niter)->name() == X_("events")) {
555 deserialize_events (*(*niter));
561 /* there was no Events child node; clear any current events */
565 maybe_signal_changed ();
573 AutomationList::operator!= (AutomationList const & other) const
576 static_cast<ControlList const &> (*this) != static_cast<ControlList const &> (other) ||
577 _state != other._state ||
578 _touching != other._touching
583 AutomationListProperty::clone () const
585 return new AutomationListProperty (
587 boost::shared_ptr<AutomationList> (new AutomationList (*this->_old.get())),
588 boost::shared_ptr<AutomationList> (new AutomationList (*this->_current.get()))