2 Copyright (C) 2001,2007 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.
20 #include <ardour/ardour.h>
25 #include <pbd/error.h>
26 #include <pbd/enumwriter.h>
27 #include <midi++/names.h>
28 #include <ardour/session.h>
29 #include <ardour/automatable.h>
30 #include <ardour/midi_track.h>
35 using namespace ARDOUR;
38 nframes_t Automatable::_automation_interval = 0;
40 Automatable::Automatable(Session& _session, const string& name)
41 : SessionObject(_session, name)
42 , _last_automation_snapshot(0)
46 Automatable::old_set_automation_state (const XMLNode& node)
48 const XMLProperty *prop;
50 if ((prop = node.property ("path")) != 0) {
51 load_automation (prop->value());
53 warning << string_compose(_("%1: Automation node has no path property"), _name) << endmsg;
56 if ((prop = node.property ("visible")) != 0) {
60 _visible_controls.clear ();
62 sstr << prop->value();
68 mark_automation_visible (Parameter(PluginAutomation, what), true);
72 _last_automation_snapshot = 0;
78 Automatable::load_automation (const string& path)
82 if (path[0] == '/') { // legacy
85 fullpath = _session.automation_dir();
88 ifstream in (fullpath.c_str());
91 warning << string_compose(_("%1: cannot open %2 to load automation data (%3)"), _name, fullpath, strerror (errno)) << endmsg;
95 Glib::Mutex::Lock lm (_automation_lock);
96 set<Parameter> tosave;
99 _last_automation_snapshot = 0;
106 in >> port; if (!in) break;
107 in >> when; if (!in) goto bad;
108 in >> value; if (!in) goto bad;
110 /* FIXME: this is legacy and only used for plugin inserts? I think? */
111 boost::shared_ptr<AutomationControl> c = control (Parameter(PluginAutomation, port), true);
112 c->list()->add (when, value);
113 tosave.insert (Parameter(PluginAutomation, port));
119 error << string_compose(_("%1: cannot load automation data from %2"), _name, fullpath) << endmsg;
125 Automatable::add_control(boost::shared_ptr<AutomationControl> ac)
127 Parameter param = ac->parameter();
129 _controls[param] = ac;
131 _can_automate_list.insert(param);
133 // Sync everything (derived classes) up to initial values
134 auto_state_changed(param);
138 Automatable::what_has_automation (set<Parameter>& s) const
140 Glib::Mutex::Lock lm (_automation_lock);
141 Controls::const_iterator li;
143 // FIXME: correct semantics?
144 for (li = _controls.begin(); li != _controls.end(); ++li) {
145 s.insert ((*li).first);
150 Automatable::what_has_visible_automation (set<Parameter>& s) const
152 Glib::Mutex::Lock lm (_automation_lock);
153 set<Parameter>::const_iterator li;
155 for (li = _visible_controls.begin(); li != _visible_controls.end(); ++li) {
160 /** Returns NULL if we don't have an AutomationList for \a parameter.
162 boost::shared_ptr<AutomationControl>
163 Automatable::control (Parameter parameter, bool create_if_missing)
165 Controls::iterator i = _controls.find(parameter);
167 if (i != _controls.end()) {
170 } else if (create_if_missing) {
171 boost::shared_ptr<AutomationList> al (new AutomationList (
172 parameter, FLT_MIN, FLT_MAX, default_parameter_value (parameter)));
173 boost::shared_ptr<AutomationControl> ac(control_factory(al));
178 //warning << "AutomationList " << parameter.to_string() << " not found for " << _name << endmsg;
179 return boost::shared_ptr<AutomationControl>();
183 boost::shared_ptr<const AutomationControl>
184 Automatable::control (Parameter parameter) const
186 Controls::const_iterator i = _controls.find(parameter);
188 if (i != _controls.end()) {
191 //warning << "AutomationList " << parameter.to_string() << " not found for " << _name << endmsg;
192 return boost::shared_ptr<AutomationControl>();
197 Automatable::describe_parameter (Parameter param)
199 /* derived classes like PluginInsert should override this */
201 if (param == Parameter(GainAutomation)) {
203 } else if (param.type() == PanAutomation) {
204 return (string_compose(_("Pan %1"), param.id()));
205 } else if (param.type() == MidiCCAutomation) {
206 return string_compose("CC %1 (%2) [%3]",
207 param.id(), midi_name(param.id()), int(param.channel()) + 1);
208 } else if (param.type() == MidiPgmChangeAutomation) {
209 return string_compose("Program [%1]", int(param.channel()) + 1);
210 } else if (param.type() == MidiPitchBenderAutomation) {
211 return string_compose("Bender [%1]", int(param.channel()) + 1);
212 } else if (param.type() == MidiChannelAftertouchAutomation) {
213 return string_compose("Aftertouch [%1]", int(param.channel()) + 1);
215 return param.to_string();
220 Automatable::can_automate (Parameter what)
222 _can_automate_list.insert (what);
226 Automatable::mark_automation_visible (Parameter what, bool yn)
229 _visible_controls.insert (what);
231 set<Parameter>::iterator i;
233 if ((i = _visible_controls.find (what)) != _visible_controls.end()) {
234 _visible_controls.erase (i);
240 Automatable::find_next_event (nframes_t now, nframes_t end, ControlEvent& next_event) const
242 Controls::const_iterator li;
244 next_event.when = max_frames;
246 for (li = _controls.begin(); li != _controls.end(); ++li) {
248 AutomationList::const_iterator i;
249 boost::shared_ptr<const AutomationList> alist (li->second->list());
250 ControlEvent cp (now, 0.0f);
252 for (i = lower_bound (alist->const_begin(), alist->const_end(), &cp, AutomationList::time_comparator);
253 i != alist->const_end() && (*i)->when < end; ++i) {
254 if ((*i)->when > now) {
259 if (i != alist->const_end() && (*i)->when < end) {
261 if ((*i)->when < next_event.when) {
262 next_event.when = (*i)->when;
267 return next_event.when != max_frames;
270 /** \a legacy_param is used for loading legacy sessions where an object (IO, Panner)
271 * had a single automation parameter, with it's type implicit. Derived objects should
272 * pass that type and it will be used for the untyped AutomationList found.
275 Automatable::set_automation_state (const XMLNode& node, Parameter legacy_param)
277 Glib::Mutex::Lock lm (_automation_lock);
279 /* Don't clear controls, since some may be special derived Controllable classes */
281 _visible_controls.clear ();
283 XMLNodeList nlist = node.children();
284 XMLNodeIterator niter;
286 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
288 /*if (sscanf ((*niter)->name().c_str(), "parameter-%" PRIu32, ¶m) != 1) {
289 error << string_compose (_("%2: badly formatted node name in XML automation state, ignored"), _name) << endmsg;
293 if ((*niter)->name() == "AutomationList") {
295 const XMLProperty* id_prop = (*niter)->property("automation-id");
297 Parameter param = (id_prop ? Parameter(id_prop->value()) : legacy_param);
299 boost::shared_ptr<AutomationList> al (new AutomationList(**niter, param));
302 warning << "AutomationList node without automation-id property, "
303 << "using default: " << legacy_param.to_string() << endmsg;
304 al->set_parameter(legacy_param);
307 boost::shared_ptr<AutomationControl> existing = control(param);
309 existing->set_list(al);
311 add_control(control_factory(al));
314 error << "Expected AutomationList node, got '" << (*niter)->name() << endmsg;
318 _last_automation_snapshot = 0;
324 Automatable::get_automation_state ()
326 Glib::Mutex::Lock lm (_automation_lock);
327 XMLNode* node = new XMLNode (X_("Automation"));
329 if (_controls.empty()) {
333 for (Controls::iterator li = _controls.begin(); li != _controls.end(); ++li) {
334 node->add_child_nocopy (li->second->list()->get_state ());
341 Automatable::clear_automation ()
343 Glib::Mutex::Lock lm (_automation_lock);
345 for (Controls::iterator li = _controls.begin(); li != _controls.end(); ++li)
346 li->second->list()->clear();
350 Automatable::set_parameter_automation_state (Parameter param, AutoState s)
352 Glib::Mutex::Lock lm (_automation_lock);
354 boost::shared_ptr<AutomationControl> c = control (param, true);
356 if (s != c->list()->automation_state()) {
357 c->list()->set_automation_state (s);
358 _session.set_dirty ();
363 Automatable::get_parameter_automation_state (Parameter param, bool lock)
365 AutoState result = Off;
368 _automation_lock.lock();
370 boost::shared_ptr<AutomationControl> c = control(param);
373 result = c->list()->automation_state();
376 _automation_lock.unlock();
382 Automatable::set_parameter_automation_style (Parameter param, AutoStyle s)
384 Glib::Mutex::Lock lm (_automation_lock);
386 boost::shared_ptr<AutomationControl> c = control(param, true);
388 if (s != c->list()->automation_style()) {
389 c->list()->set_automation_style (s);
390 _session.set_dirty ();
395 Automatable::get_parameter_automation_style (Parameter param)
397 Glib::Mutex::Lock lm (_automation_lock);
399 boost::shared_ptr<AutomationControl> c = control(param);
402 return c->list()->automation_style();
404 return Absolute; // whatever
409 Automatable::protect_automation ()
411 set<Parameter> automated_params;
413 what_has_automation (automated_params);
415 for (set<Parameter>::iterator i = automated_params.begin(); i != automated_params.end(); ++i) {
417 boost::shared_ptr<AutomationControl> c = control(*i);
419 switch (c->list()->automation_state()) {
421 c->list()->set_automation_state (Off);
424 c->list()->set_automation_state (Play);
433 Automatable::automation_snapshot (nframes_t now, bool force)
435 if (force || _last_automation_snapshot > now || (now - _last_automation_snapshot) > _automation_interval) {
437 for (Controls::iterator i = _controls.begin(); i != _controls.end(); ++i) {
438 if (i->second->list()->automation_write()) {
439 i->second->list()->rt_add (now, i->second->user_value());
443 _last_automation_snapshot = now;
448 Automatable::transport_stopped (nframes_t now)
450 for (Controls::iterator li = _controls.begin(); li != _controls.end(); ++li) {
452 boost::shared_ptr<AutomationControl> c = li->second;
454 c->list()->reposition_for_rt_add (now);
456 if (c->list()->automation_state() != Off) {
457 c->set_value(c->list()->eval(now));
462 /* FIXME: this probably doesn't belong here */
463 boost::shared_ptr<AutomationControl>
464 Automatable::control_factory(boost::shared_ptr<AutomationList> list)
467 list->parameter().type() == MidiCCAutomation ||
468 list->parameter().type() == MidiPgmChangeAutomation ||
469 list->parameter().type() == MidiChannelAftertouchAutomation
471 // FIXME: this will die horribly if this is not a MidiTrack
472 return boost::shared_ptr<AutomationControl>(new MidiTrack::MidiControl((MidiTrack*)this, list));
474 return boost::shared_ptr<AutomationControl>(new AutomationControl(_session, list));