Consistent Automation evaluation:
[ardour.git] / libs / ardour / automation_control.cc
index 8f8e40a641db74346d636f0083210be62c9ab3d9..c3ad2481d6ecfe881628c152161a4b8d94565a6a 100644 (file)
@@ -1,6 +1,6 @@
 /*
-    Copyright (C) 2007 Paul Davis 
-       Author: Dave Robillard
+    Copyright (C) 2007 Paul Davis
+    Author: David Robillard
 
     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
 
 */
 
+#include <math.h>
 #include <iostream>
-#include <ardour/automation_control.h>
-#include <ardour/session.h>
-#include <ardour/automatable.h>
+
+#include "pbd/memento_command.h"
+#include "pbd/stacktrace.h"
+
+#include "ardour/audioengine.h"
+#include "ardour/automation_control.h"
+#include "ardour/automation_watch.h"
+#include "ardour/control_group.h"
+#include "ardour/event_type_map.h"
+#include "ardour/session.h"
+#include "ardour/selection.h"
+#include "ardour/value_as_string.h"
+
+#include "pbd/i18n.h"
+
+#ifdef COMPILER_MSVC
+#include <float.h>
+// C99 'isfinite()' is not available in MSVC.
+#define isfinite_local(val) (bool)_finite((double)val)
+#else
+#define isfinite_local isfinite
+#endif
 
 using namespace std;
 using namespace ARDOUR;
 using namespace PBD;
 
+AutomationControl::AutomationControl(ARDOUR::Session&                          session,
+                                     const Evoral::Parameter&                  parameter,
+                                     const ParameterDescriptor&                desc,
+                                     boost::shared_ptr<ARDOUR::AutomationList> list,
+                                     const string&                             name,
+                                     Controllable::Flag                        flags)
 
-AutomationControl::AutomationControl(Session& session, boost::shared_ptr<AutomationList> list, string name)
-       : Controllable((name == "unnamed controllable") ? list->param_id().to_string() : name)
+       : Controllable (name.empty() ? EventTypeMap::instance().to_symbol(parameter) : name, flags)
+       , Evoral::Control(parameter, desc, list)
        , _session(session)
-       , _list(list)
-       , _user_value(list->default_value())
+       , _desc(desc)
+{
+       if (_desc.toggled) {
+               set_flags (Controllable::Toggle);
+       }
+       boost::shared_ptr<AutomationList> al = alist();
+       if (al) {
+               al->StateChanged.connect_same_thread (_state_changed_connection, boost::bind (&Session::set_dirty, &_session));
+       }
+}
+
+AutomationControl::~AutomationControl ()
 {
-       cerr << "Created AutomationControl " << name << "(" << list->param_id().to_string() << ")" << endl;
+       _session.selection().remove_control_by_id (id());
+       DropReferences (); /* EMIT SIGNAL */
 }
 
+bool
+AutomationControl::writable() const
+{
+       boost::shared_ptr<AutomationList> al = alist();
+       if (al) {
+               return al->automation_state() != Play;
+       }
+       return true;
+}
 
-/** Get the currently effective value (ie the one that corresponds to current output)
- */
-float
+/** Get the current effective `user' value based on automation state */
+double
 AutomationControl::get_value() const
 {
-       if (_list->automation_playback())
-               return _list->eval(_session.transport_frame());
-       else
-               return _user_value;
+       bool from_list = _list && boost::dynamic_pointer_cast<AutomationList>(_list)->automation_playback();
+       return Control::get_double (from_list, _session.transport_frame());
 }
 
+double
+AutomationControl::get_save_value() const
+{
+       /* save user-value, not incl masters */
+       return Control::get_double ();
+}
 
 void
-AutomationControl::set_value(float value)
+AutomationControl::pre_realtime_queue_stuff (double val, PBD::Controllable::GroupControlDisposition gcd)
 {
-       _user_value = value;
-       
-       if (_session.transport_stopped() && _list->automation_write())
-               _list->add(_session.transport_frame(), value);
+       if (_group && _group->use_me (gcd)) {
+               _group->pre_realtime_queue_stuff (val);
+       } else {
+               do_pre_realtime_queue_stuff (val);
+       }
+}
+
+void
+AutomationControl::set_value (double val, PBD::Controllable::GroupControlDisposition gcd)
+{
+       if (!writable()) {
+               return;
+       }
+
+       /* enforce strict double/boolean value mapping */
+
+       if (_desc.toggled) {
+               if (val != 0.0) {
+                       val = 1.0;
+               }
+       }
+
+       if (check_rt (val, gcd)) {
+               /* change has been queued to take place in an RT context */
+               return;
+       }
 
-       Changed(); /* EMIT SIGNAL */
+       if (_group && _group->use_me (gcd)) {
+               _group->set_group_value (shared_from_this(), val);
+       } else {
+               actually_set_value (val, gcd);
+       }
 }
 
+ControlList
+AutomationControl::grouped_controls () const
+{
+       if (_group && _group->use_me (PBD::Controllable::UseGroup)) {
+               return _group->controls ();
+       } else {
+               return ControlList ();
+       }
+}
+
+void
+AutomationControl::automation_run (framepos_t start, pframes_t nframes)
+{
+       if (!automation_playback ()) {
+               return;
+       }
 
-/** Get the latest user-set value, which may not equal get_value() when automation
- * is playing back, etc.
- *
- * Automation write/touch works by periodically sampling this value and adding it
- * to the AutomationList.
+       assert (_list);
+       bool valid = false;
+       double val = _list->rt_safe_eval (start, valid);
+       if (!valid) {
+               return;
+       }
+       if (toggled ()) {
+               const double thresh = .5 * (_desc.upper - _desc.lower);
+               set_value_unchecked (val >= thresh ? _desc.upper : _desc.lower);
+       } else {
+               set_value_unchecked (val);
+       }
+}
+
+/** Set the value and do the right thing based on automation state
+ *  (e.g. record if necessary, etc.)
+ *  @param value `user' value
  */
-float
-AutomationControl::user_value() const
+void
+AutomationControl::actually_set_value (double value, PBD::Controllable::GroupControlDisposition gcd)
 {
-       return _user_value;
+       boost::shared_ptr<AutomationList> al = boost::dynamic_pointer_cast<AutomationList> (_list);
+       const framepos_t pos = _session.transport_frame();
+       bool to_list;
+
+       /* We cannot use ::get_value() here since that is virtual, and intended
+          to return a scalar value that in some way reflects the state of the
+          control (with semantics defined by the control itself, since it's
+          internal state may be more complex than can be fully represented by
+          a single scalar).
+
+          This method's only job is to set the "user_double()" value of the
+          underlying Evoral::Control object, and so we should compare the new
+          value we're being given to the current user_double().
+
+          Unless ... we're doing automation playback, in which case the
+          current effective value of the control (used to determine if
+          anything has changed) is the one derived from the automation event
+          list.
+       */
+       float old_value = Control::user_double();
+
+       if (al && al->automation_write ()) {
+               to_list = true;
+       } else {
+               to_list = false;
+       }
+
+       Control::set_double (value, pos, to_list);
+
+       if (old_value != (float)value) {
+#if 0
+               AutomationType at = (AutomationType) _parameter.type();
+               std::cerr << "++++ Changed (" << enum_2_string (at) << ", " << enum_2_string (gcd) << ") = " << value
+               << " (was " << old_value << ") @ " << this << std::endl;
+#endif
+
+               Changed (true, gcd);
+               if (!al || !al->automation_playback ()) {
+                       _session.set_dirty ();
+               }
+       }
 }
-       
 
 void
-AutomationControl::set_list(boost::shared_ptr<ARDOUR::AutomationList> list)
+AutomationControl::set_list (boost::shared_ptr<Evoral::ControlList> list)
 {
-       _list = list;
-       _user_value = list->default_value();
-       Changed();  /* EMIT SIGNAL */
+       Control::set_list (list);
+       Changed (true, Controllable::NoGroup);
 }
 
+void
+AutomationControl::set_automation_state (AutoState as)
+{
+       if (flags() & NotAutomatable) {
+               return;
+       }
+       if (_list && as != alist()->automation_state()) {
+
+               const double val = get_value ();
+
+               alist()->set_automation_state (as);
+               if (_desc.toggled) {
+                       Changed (false, Controllable::NoGroup); // notify slaves, update boolean masters
+                       return;  // No watch for boolean automation
+               }
+
+               if (as == Write) {
+                       AutomationWatch::instance().add_automation_watch (shared_from_this());
+               } else if (as == Touch) {
+                       if (alist()->empty()) {
+                               Control::set_double (val, _session.current_start_frame (), true);
+                               Control::set_double (val, _session.current_end_frame (), true);
+                               Changed (true, Controllable::NoGroup);
+                       }
+                       if (!touching()) {
+                               AutomationWatch::instance().remove_automation_watch (shared_from_this());
+                       } else {
+                               /* this seems unlikely, but the combination of
+                                * a control surface and the mouse could make
+                                * it possible to put the control into Touch
+                                * mode *while* touching it.
+                                */
+                               AutomationWatch::instance().add_automation_watch (shared_from_this());
+                       }
+               } else {
+                       AutomationWatch::instance().remove_automation_watch (shared_from_this());
+                       Changed (false, Controllable::NoGroup);
+               }
+       }
+}
+
+void
+AutomationControl::start_touch(double when)
+{
+       if (!_list) {
+               return;
+       }
+
+       if (!touching()) {
+               if (alist()->automation_state() == Touch) {
+                       /* subtle. aligns the user value with the playback and
+                        * use take actual value (incl masters).
+                        *
+                        * Touch + hold writes inverse curve of master-automation
+                        * using AutomationWatch::timer ()
+                        */
+                       AutomationControl::actually_set_value (get_value (), Controllable::NoGroup);
+                       alist()->start_touch (when);
+                       if (!_desc.toggled) {
+                               AutomationWatch::instance().add_automation_watch (shared_from_this());
+                       }
+               }
+               set_touching (true);
+       }
+}
+
+void
+AutomationControl::stop_touch(bool mark, double when)
+{
+       if (!_list) return;
+       if (touching()) {
+               set_touching (false);
+
+               if (alist()->automation_state() == Touch) {
+                       alist()->stop_touch (mark, when);
+                       if (!_desc.toggled) {
+                               AutomationWatch::instance().remove_automation_watch (shared_from_this());
+
+                       }
+               }
+       }
+}
+
+void
+AutomationControl::commit_transaction (bool did_write)
+{
+       if (did_write) {
+               if (alist ()->before ()) {
+                       _session.begin_reversible_command (string_compose (_("record %1 automation"), name ()));
+                       _session.commit_reversible_command (new MementoCommand<AutomationList> (*alist ().get (), alist ()->before (), &alist ()->get_state ()));
+               }
+       } else {
+               alist ()->clear_history ();
+       }
+}
+
+/* take control-value and return UI range [0..1] */
+double
+AutomationControl::internal_to_interface (double val) const
+{
+       // XXX maybe optimize. _desc.from_interface() has
+       // a switch-statement depending on AutomationType.
+       return _desc.to_interface (val);
+}
+
+/* map GUI range [0..1] to control-value */
+double
+AutomationControl::interface_to_internal (double val) const
+{
+       if (!isfinite_local (val)) {
+               assert (0);
+               val = 0;
+       }
+       // XXX maybe optimize. see above.
+       return _desc.from_interface (val);
+}
+
+std::string
+AutomationControl::get_user_string () const
+{
+       return ARDOUR::value_as_string (_desc, get_value());
+}
+
+void
+AutomationControl::set_group (boost::shared_ptr<ControlGroup> cg)
+{
+       /* this method can only be called by a ControlGroup. We do not need
+          to ensure consistency by calling ControlGroup::remove_control(),
+          since we are guaranteed that the ControlGroup will take care of that
+          for us.
+       */
+
+       _group = cg;
+}
+
+bool
+AutomationControl::check_rt (double val, Controllable::GroupControlDisposition gcd)
+{
+       if (!_session.loading() && (flags() & Controllable::RealTime) && !AudioEngine::instance()->in_process_thread()) {
+               /* queue change in RT context */
+               _session.set_control (shared_from_this(), val, gcd);
+               return true;
+       }
+
+       return false;
+}